Repository navigation
nl 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 | 中文
Bedankt voor je hulp! COPG-VD is bedoeld om er gemakkelijk aan bij te dragen. Deze handleiding vertelt je waar dingen zich bevinden en de paar conventies die we volgen.
COPG-VD is een Zygisk-apparaatspoofer: een kleine native library die in app-processen wordt geïnjecteerd om de fingerprint en build van het apparaat te herschrijven, plus een vanilla-JS WebUI om het aan te sturen. Het is een fork van COPG (door AlirezaParsi), onderhouden door VD171 onder de Apache-2.0- licentie. Zie ARCHITECTURE.md en FILE-STRUCTURE.md.
Standaard beperkt het de spoof tot de Google Play-stack via Zygisk, dus het is een lichter, robuuster alternatief voor PlayIntegrityFix.
AI-assistenten en -agents zijn hier eersteklas bijdragers, geen bijzaak.
- Het project is gebouwd om leesbaar te zijn: de configuratie is een enkel JSON-bestand
(
/data/adb/COPG-VD/COPG-VD.json, gedocumenteerd in CONFIGURATION.md), de engines zijn klein en op zichzelf staand, en de indeling staat in FILE-STRUCTURE.md. - AI-ondersteunde patches worden beoordeeld en geaccepteerd op dezelfde voorwaarden als elke andere: op correctheid, duidelijkheid en de conventies hieronder, niet op wie (of wat) ze heeft geschreven.
- Dezelfde lat voor iedereen: een echte functie wordt nooit verzwakt, de spoof blijft coherent, en niets geheims of apparaatspecifieks belandt in de repo (zie de .gitignore).
- Je hebt een geroot apparaat of emulator met Zygisk (KernelSU, APatch of Magisk) nodig om te testen.
- Bouw de native library per ABI met de NDK (r29) en CMake: zie de stap
Build zygisk librariesin.github/workflows/COPG-VD.ymlvoor het exacte commando. CI bouwt alle drie de ABI's voor je. - Bouw een flashbare zip: kopieer de gebouwde
libspoof.sonaarmodule/zygisk/<abi>.so, dancd module && zip -r9 ../COPG-VD-dev.zip .en flash die. - De WebUI is
module/webroot/(open die vanuit de root-manager). De spoofing-logica iszygisk/spoof_module.cpp; de profiel-fetcher ismodule/fingerprint-update.sh.
-
Elk modulebronbestand (
.cpp,.sh,.js,.css,.html) begint met de projectbanner- header (kopieer die uit een bestaand bestand). Tooling onder.github/gebruikt in plaats daarvan een korte opmerking. - Code en opmerkingen in het Engels. Houd opmerkingen minimaal en alleen waar nodig.
-
Geen em-dash of en-dash; gebruik altijd een gewoon koppelteken
-. - De WebUI is vanilla JS (één
scripts.js); geen frameworks. - Verzwak nooit een echte functie: houd de spoof coherent, en laat de hooks geen app crashen waaraan ze zijn gekoppeld (ze zijn met opzet null-gecheckt).
- UI-strings staan in
module/webroot/lang/. Engels is de canonieke fallback (en.js+en.json); de andere 20 talen zijn<code>.json. - Om een string toe te voegen of te wijzigen: bewerk
en.jsenen.json, update dan elke<code>.json. Een zichtbaar label aanraken betekent alle taalbestanden en alleREADME.<code>.mdupdaten. - Vertalingen zijn gewone JSON: een geweldige eerste bijdrage.
- Houd PR's gericht. Beschrijf wat en waarom.
- Sign off je commits (DCO):
git commit -s(voegtSigned-off-by:toe). - CI moet groen blijven. Wees vriendelijk in reviews: zie CODE_OF_CONDUCT.md.
Zoek naar de labels good first issue en help wanted. Vertalingen, docs en nieuwe
Pixel-profielen zijn allemaal geweldige startpunten.
Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.