Repository navigation
ru CONTRIBUTING
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 является подменщиком устройства на Zygisk: небольшая нативная библиотека, которая внедряется в процессы приложений, чтобы переписать отпечаток и build устройства, плюс WebUI на чистом JS для управления им. Это форк COPG (автор AlirezaParsi), поддерживаемый VD171 под лицензией Apache-2.0. Смотрите ARCHITECTURE.md и FILE-STRUCTURE.md.
По умолчанию он ограничивает подмену стеком Google Play через Zygisk, так что это более лёгкая и надёжная альтернатива PlayIntegrityFix.
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).
- Строки UI находятся в
module/webroot/lang/. Английский: канонический запасной вариант (en.js+en.json); остальные 20 языков:<code>.json. - Чтобы добавить или изменить строку: отредактируйте
en.jsиen.json, затем обновите каждый<code>.json. Правка видимой надписи означает обновление всех языковых файлов и всехREADME.<code>.md. - Переводы: обычный JSON, отличный первый вклад.
- Держите PR сфокусированными. Описывайте, что и зачем.
- Подписывайте свои коммиты (DCO):
git commit -s(добавляетSigned-off-by:). - CI должен оставаться зелёным. Будьте добры в рецензиях. Смотрите CODE_OF_CONDUCT.md.
Ищите метки good first issue и help wanted. Переводы, документация и новые
профили Pixel: все это отличные точки старта.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.