Skip to content
github-actions[bot] edited this page Nov 17, 2026 · 3 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.

Контриб'ютори-ШІ вітаються

Асистенти та агенти на основі ШІ тут повноправні контриб'ютори, а не щось другорядне.

  • Проєкт зроблено читабельним: конфігурація це єдиний файл 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).

Інтернаціоналізація (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