Repository navigation
uk 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.
Асистенти та агенти на основі ШІ тут повноправні контриб'ютори, а не щось другорядне.
- Проєкт зроблено читабельним: конфігурація це єдиний файл JSON
(
/data/adb/COPG-VD.json, задокументований у CONFIGURATION.md), рушії малі й самодостатні, а розкладку описано в FILE-STRUCTURE.md. - Патчі, створені за допомогою ШІ, переглядаються та приймаються на тих самих умовах, що й будь-які інші, за коректністю, ясністю та домовленостями нижче, а не за тим, хто (чи що) їх написав.
- Однакова планка для всіх: справжня функція ніколи не послаблюється, підміна лишається узгодженою, і нічого таємного чи специфічного для пристрою не потрапляє в репозиторій (див. .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.