Repository navigation
sv 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 | 中文
Tack för att du hjälper till! COPG-VD är tänkt att vara lätt att bidra till. Den här guiden berättar var saker finns och de få konventioner vi följer.
COPG-VD är en Zygisk-enhetsspoofer: ett litet nativt bibliotek som injiceras i app- processer för att skriva om enhetens fingerprint och build, plus ett WebUI i ren JS för att styra det. Det är en fork av COPG (av AlirezaParsi), underhållen av VD171 under Apache-2.0-licensen. Se ARCHITECTURE.md och FILE-STRUCTURE.md.
Som standard begränsar den spoofen till Google Play-stacken via Zygisk, så den är ett lättare, mer robust alternativ till PlayIntegrityFix.
AI-assistenter och agenter är förstklassiga bidragsgivare här, inte en eftertanke.
- Projektet är byggt för att vara läsbart: konfigurationen är en enda JSON-fil
(
/data/adb/COPG-VD/COPG-VD.json, dokumenterad i CONFIGURATION.md), motorerna är små och fristående, och layouten finns i FILE-STRUCTURE.md. - AI-assisterade patchar granskas och accepteras på samma villkor som alla andra: efter korrekthet, tydlighet och konventionerna nedan, inte efter vem (eller vad) som skrev dem.
- Samma ribba för alla: en riktig funktion försvagas aldrig, spoofen förblir koherent, och inget hemligt eller enhetsspecifikt hamnar i repot (se .gitignore).
- Du behöver en rootad enhet eller emulator med Zygisk (KernelSU, APatch eller Magisk) för att testa.
- Bygg det nativa biblioteket per ABI med NDK (r29) och CMake: se steget
Build zygisk librariesi.github/workflows/COPG-VD.ymlför det exakta kommandot. CI bygger alla tre ABI:er åt dig. - Bygg en flashbar zip: kopiera det byggda
libspoof.sotillmodule/zygisk/<abi>.so, sedancd module && zip -r9 ../COPG-VD-dev.zip .och flasha den. - WebUI:t är
module/webroot/(öppna det från root-hanteraren). Spoofing-logiken ärzygisk/spoof_module.cpp; profilhämtaren ärmodule/fingerprint-update.sh.
-
Varje källfil i modulen (
.cpp,.sh,.js,.css,.html) börjar med projektets banner-header (kopiera den från valfri befintlig fil). Verktyg under.github/använder istället en kort kommentar. - Kod och kommentarer på engelska. Håll kommentarerna minimala och endast där de behövs.
-
Ingen em-dash eller en-dash; använd alltid ett vanligt bindestreck
-. - WebUI:t är ren JS (ett enda
scripts.js); inga ramverk. - Försvaga aldrig en riktig funktion: håll spoofen koherent och låt inte hookarna krascha en app de är fästa vid (de är null-kontrollerade med avsikt).
- UI-strängar finns i
module/webroot/lang/. Engelska är den kanoniska reservutvägen (en.js+en.json); de övriga 20 språken är<code>.json. - För att lägga till eller ändra en sträng: redigera
en.jsochen.json, uppdatera sedan varje<code>.json. Att röra en synlig etikett innebär att uppdatera alla språkfiler och allaREADME.<code>.md. - Översättningar är ren JSON: ett utmärkt första bidrag.
- Håll PR:er fokuserade. Beskriv vad och varför.
- Signera dina commits (DCO):
git commit -s(lägger tillSigned-off-by:). - CI måste förbli grön. Var vänlig i granskningar: se CODE_OF_CONDUCT.md.
Leta efter etiketterna good first issue och help wanted. Översättningar, dokumentation och nya
Pixel-profiler är alla utmärkta startpunkter.
Denna dokumentation genererades med Claude (Anthropic) och underhålls av VD171. Rättelser och förbättringar välkomnas; se CONTRIBUTING.md.