Repository navigation
id 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 | 中文
Terima kasih telah membantu! COPG-VD dimaksudkan agar mudah untuk dikontribusikan. Panduan ini memberi tahu Anda di mana segala sesuatu berada dan beberapa konvensi yang kami ikuti.
COPG-VD adalah spoofer perangkat Zygisk: sebuah library native kecil yang disuntikkan ke proses aplikasi untuk menulis ulang fingerprint dan build perangkat, ditambah WebUI vanilla-JS untuk mengendalikannya. Ini adalah fork dari COPG (oleh AlirezaParsi), dikelola oleh VD171 di bawah lisensi Apache-2.0. Lihat ARCHITECTURE.md dan FILE-STRUCTURE.md.
Secara default ia membatasi spoof ke stack Google Play melalui Zygisk, sehingga menjadi alternatif yang lebih ringan dan lebih tangguh daripada PlayIntegrityFix.
Asisten dan agen AI di sini adalah kontributor kelas satu, bukan sekadar pelengkap.
- Proyek ini dibuat agar mudah dibaca: konfigurasinya adalah satu file JSON
(
/data/adb/COPG-VD/COPG-VD.json, didokumentasikan di CONFIGURATION.md), mesin-mesinnya kecil dan mandiri, dan tata letaknya ada di FILE-STRUCTURE.md. - Patch yang dibantu AI ditinjau dan diterima dengan ketentuan yang sama seperti lainnya - berdasarkan kebenaran, kejelasan, dan konvensi di bawah ini, bukan berdasarkan siapa (atau apa) yang menulisnya.
- Standar yang sama untuk semua: fitur yang nyata tidak pernah dilemahkan, spoof tetap koheren, dan tidak ada yang rahasia atau spesifik perangkat yang masuk ke repositori (lihat .gitignore).
- Anda memerlukan perangkat atau emulator yang di-root dengan Zygisk (KernelSU, APatch atau Magisk) untuk menguji.
- Bangun library native per ABI dengan NDK (r29) dan CMake: lihat langkah
Build zygisk librariesdi.github/workflows/COPG-VD.ymluntuk perintah yang tepat. CI membangun ketiga ABI untuk Anda. - Bangun zip yang dapat di-flash: salin
libspoof.soyang sudah dibangun kemodule/zygisk/<abi>.so, lalucd module && zip -r9 ../COPG-VD-dev.zip .dan flash. - WebUI adalah
module/webroot/(buka dari root manager). Logika spoofing ada dizygisk/spoof_module.cpp; pengambil profil adalahmodule/fingerprint-update.sh.
-
Setiap file sumber modul (
.cpp,.sh,.js,.css,.html) dimulai dengan header banner proyek (salin dari file mana pun yang sudah ada). Perkakas di bawah.github/menggunakan komentar pendek sebagai gantinya. - Kode dan komentar dalam bahasa Inggris. Jaga komentar tetap minimal dan hanya di tempat yang diperlukan.
-
Tanpa em-dash atau en-dash; selalu gunakan hyphen biasa
-. - WebUI adalah vanilla JS (satu
scripts.js); tanpa framework. - Jangan pernah melemahkan fitur yang nyata: jaga spoof tetap koheren, dan jangan membuat hook membuat aplikasi yang mereka tempeli crash (mereka null-checked dengan sengaja).
- String UI berada di
module/webroot/lang/. Bahasa Inggris adalah fallback kanonik (en.js+en.json); 20 bahasa lainnya adalah<code>.json. - Untuk menambah atau mengubah string: edit
en.jsdanen.json, lalu perbarui setiap<code>.json. Menyentuh label yang terlihat berarti memperbarui semua file bahasa dan semuaREADME.<code>.md. - Terjemahan adalah JSON biasa: kontribusi pertama yang bagus.
- Jaga PR tetap fokus. Jelaskan apa dan mengapa.
- Sign off commit Anda (DCO):
git commit -s(menambahkanSigned-off-by:). - CI harus tetap hijau. Bersikaplah baik dalam review: lihat CODE_OF_CONDUCT.md.
Cari label good first issue dan help wanted. Terjemahan, dokumentasi, dan profil Pixel
baru semuanya merupakan titik awal yang bagus.
Dokumentasi ini dibuat dengan Claude (Anthropic) dan dikelola oleh VD171. Koreksi dan perbaikan dipersilakan; lihat CONTRIBUTING.md.