Repository navigation
it 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 | 中文
Grazie per l'aiuto! COPG-VD è pensato per essere facile a cui contribuire. Questa guida ti dice dove si trovano le cose e le poche convenzioni che seguiamo.
COPG-VD è uno spoofer di dispositivo Zygisk: una piccola libreria nativa che viene iniettata nei processi delle app per riscrivere il fingerprint e la build del dispositivo, più una WebUI in vanilla-JS per pilotarlo. È un fork di COPG (di AlirezaParsi), mantenuto da VD171 sotto la licenza Apache-2.0. Vedi ARCHITECTURE.md e FILE-STRUCTURE.md.
Di default limita lo spoof allo stack di Google Play tramite Zygisk, quindi è un'alternativa più leggera e più robusta a PlayIntegrityFix.
Gli assistenti e agenti AI qui sono contributori di prima classe, non un ripensamento.
- Il progetto è costruito per essere leggibile: la configurazione è un singolo file JSON
(
/data/adb/COPG-VD/COPG-VD.json, documentato in CONFIGURATION.md), i motori sono piccoli e autocontenuti, e il layout è in FILE-STRUCTURE.md. - Le patch assistite dall'AI vengono revisionate e accettate alle stesse condizioni di qualsiasi altra: per correttezza, chiarezza e le convenzioni qui sotto, non per chi (o cosa) le ha scritte.
- Stesso standard per tutti: una vera funzionalità non viene mai indebolita, lo spoof resta coerente, e nulla di segreto o specifico del dispositivo finisce nel repo (vedi il .gitignore).
- Ti serve un dispositivo o emulatore rootato con Zygisk (KernelSU, APatch o Magisk) per testare.
- Compila la libreria nativa per ABI con l'NDK (r29) e CMake: vedi lo step
Build zygisk librariesin.github/workflows/COPG-VD.ymlper il comando esatto. La CI compila tutte e tre le ABI per te. - Costruisci uno zip flashabile: copia la
libspoof.socompilata inmodule/zygisk/<abi>.so, poicd module && zip -r9 ../COPG-VD-dev.zip .e flashalo. - La WebUI è
module/webroot/(aprila dal root manager). La logica di spoofing èzygisk/spoof_module.cpp; il fetcher del profilo èmodule/fingerprint-update.sh.
-
Ogni file sorgente del modulo (
.cpp,.sh,.js,.css,.html) inizia con l'header del banner del progetto (copialo da qualsiasi file esistente). Il tooling sotto.github/usa invece un commento breve. - Codice e commenti in inglese. Mantieni i commenti minimi e solo dove servono.
-
Nessun em-dash o en-dash; usa sempre un semplice trattino
-. - La WebUI è vanilla JS (un unico
scripts.js); nessun framework. - Non indebolire mai una vera funzionalità: mantieni lo spoof coerente, e non far crashare un'app a cui gli hook sono attaccati (sono null-checked di proposito).
- Le stringhe della UI si trovano in
module/webroot/lang/. L'inglese è il fallback canonico (en.js+en.json); le altre 20 lingue sono<code>.json. - Per aggiungere o cambiare una stringa: modifica
en.jseen.json, poi aggiorna ogni<code>.json. Toccare un'etichetta visibile significa aggiornare tutti i file di lingua e tutti iREADME.<code>.md. - Le traduzioni sono semplice JSON: un ottimo primo contributo.
- Mantieni le PR focalizzate. Descrivi cosa e perché.
- Firma i tuoi commit (DCO):
git commit -s(aggiungeSigned-off-by:). - La CI deve restare verde. Sii gentile nelle revisioni: vedi CODE_OF_CONDUCT.md.
Cerca le label good first issue e help wanted. Traduzioni, documentazione e nuovi
profili Pixel sono tutti ottimi punti di partenza.
Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.