Skip to content
github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Участие в COPG-VD

Спасибо за помощь! COPG-VD задуман так, чтобы в него было легко вносить вклад. Это руководство рассказывает, где что находится, и о тех немногих соглашениях, которых мы придерживаемся.

Проект с высоты птичьего полёта

COPG-VD является подменщиком устройства на Zygisk: небольшая нативная библиотека, которая внедряется в процессы приложений, чтобы переписать отпечаток и build устройства, плюс WebUI на чистом JS для управления им. Это форк COPG (автор AlirezaParsi), поддерживаемый VD171 под лицензией Apache-2.0. Смотрите ARCHITECTURE.md и FILE-STRUCTURE.md.

По умолчанию он ограничивает подмену стеком Google Play через Zygisk, так что это более лёгкая и надёжная альтернатива PlayIntegrityFix.

AI-участники приветствуются

AI-ассистенты и агенты здесь полноценные участники, а не что-то второстепенное.

  • Проект построен так, чтобы быть читаемым: конфигурация является единственным JSON-файлом (/data/adb/COPG-VD/COPG-VD.json, документированный в CONFIGURATION.md), движки маленькие и самодостаточные, а раскладка описана в FILE-STRUCTURE.md.
  • Патчи, созданные с помощью AI, рассматриваются и принимаются на тех же условиях, что и любые другие: по корректности, ясности и соглашениям ниже, а не по тому, кто (или что) их написал.
  • Одна планка для всех: настоящая функциональность никогда не ослабляется, подмена остаётся согласованной, и ничто секретное или специфичное для устройства не попадает в репозиторий (смотрите .gitignore).

Настройка для разработки

  • Для тестирования нужно устройство с root или эмулятор с Zygisk (KernelSU, APatch или Magisk).
  • Соберите нативную библиотеку по ABI с помощью NDK (r29) и CMake. Смотрите шаг Build zygisk libraries в .github/workflows/COPG-VD.yml для точной команды. CI собирает все три ABI за вас.
  • Соберите прошиваемый zip: скопируйте собранный libspoof.so в module/zygisk/<abi>.so, затем cd module && zip -r9 ../COPG-VD-dev.zip . и прошейте его.
  • WebUI: module/webroot/ (откройте его из root-менеджера). Логика подмены: zygisk/spoof_module.cpp; загрузчик профиля: module/fingerprint-update.sh.

Соглашения

  • Каждый исходный файл модуля (.cpp, .sh, .js, .css, .html) начинается с шапки-баннера проекта (скопируйте её из любого существующего файла). Инструменты в .github/ используют вместо этого короткий комментарий.
  • Код и комментарии на английском. Держите комментарии минимальными и только там, где нужно.
  • Никаких em-dash или en-dash; всегда используйте простой дефис -.
  • WebUI написан на чистом JS (один scripts.js); без фреймворков.
  • Никогда не ослабляйте настоящую функциональность: держите подмену согласованной и не допускайте, чтобы хуки обрушивали приложение, к которому они присоединены (у них намеренно есть проверка на null).

Интернационализация (i18n)

  • Строки UI находятся в module/webroot/lang/. Английский: канонический запасной вариант (en.js + en.json); остальные 20 языков: <code>.json.
  • Чтобы добавить или изменить строку: отредактируйте en.js и en.json, затем обновите каждый <code>.json. Правка видимой надписи означает обновление всех языковых файлов и всех README.<code>.md.
  • Переводы: обычный JSON, отличный первый вклад.

Коммиты и PR

  • Держите PR сфокусированными. Описывайте, что и зачем.
  • Подписывайте свои коммиты (DCO): git commit -s (добавляет Signed-off-by:).
  • CI должен оставаться зелёным. Будьте добры в рецензиях. Смотрите CODE_OF_CONDUCT.md.

Хорошие первые задачи

Ищите метки good first issue и help wanted. Переводы, документация и новые профили Pixel: все это отличные точки старта.


Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.

Clone this wiki locally