Repository navigation
tr 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 | 中文
Yardım ettiğiniz için teşekkürler! COPG-VD'nin katkıda bulunması kolay olacak şekilde tasarlandı. Bu kılavuz size şeylerin nerede olduğunu ve izlediğimiz birkaç kuralı anlatır.
COPG-VD bir Zygisk cihaz sahteleyicisidir (Zygisk device spoofer): cihaz parmak izini ve build bilgisini yeniden yazmak için uygulama süreçlerine enjekte edilen küçük bir native kütüphane, artı onu yönetmek için saf-JS (vanilla-JS) bir WebUI. COPG'nin (AlirezaParsi tarafından) bir fork'udur, Apache-2.0 lisansı altında VD171 tarafından sürdürülür. Bkz. ARCHITECTURE.md ve FILE-STRUCTURE.md.
Varsayılan olarak sahtelemeyi Zygisk aracılığıyla Google Play yığınına kapsar, bu yüzden PlayIntegrityFix'e göre daha hafif, daha sağlam bir alternatiftir.
AI asistanları ve ajanları burada birinci sınıf katkıda bulunanlardır, sonradan akla gelen bir şey değil.
- Proje okunabilir olacak şekilde inşa edilmiştir: yapılandırma tek bir JSON dosyasıdır
(
/data/adb/COPG-VD/COPG-VD.json, CONFIGURATION.md içinde belgelenmiş), motorlar küçük ve kendi kendine yeterlidir ve düzen FILE-STRUCTURE.md içindedir. - AI destekli yamalar, herhangi bir diğeriyle aynı koşullarda incelenir ve kabul edilir - doğruluk, netlik ve aşağıdaki kurallara göre, kim (ya da ne) yazdığına göre değil.
- Herkes için aynı çıta: gerçek bir özellik asla zayıflatılmaz, sahteleme tutarlı kalır ve depoya gizli veya cihaza özgü hiçbir şey girmez (bkz. .gitignore).
- Test etmek için Zygisk'li (KernelSU, APatch veya Magisk) root'lanmış bir cihaza veya emülatöre ihtiyacınız var.
- Native kütüphaneyi ABI başına NDK (r29) ve CMake ile derleyin: tam komut için
.github/workflows/COPG-VD.ymliçindekiBuild zygisk librariesadımına bakın. CI her üç ABI'yi sizin için derler. - Flash edilebilir bir zip derleyin: derlenen
libspoof.sodosyasınımodule/zygisk/<abi>.soiçine kopyalayın, ardındancd module && zip -r9 ../COPG-VD-dev.zip .yapın ve flash edin. - WebUI
module/webroot/içindedir (root yöneticisinden açın). Sahteleme mantığızygisk/spoof_module.cpp'dir; profil getiricimodule/fingerprint-update.sh'dir.
-
Her modül kaynak dosyası (
.cpp,.sh,.js,.css,.html) proje başlık afişi (banner header) ile başlar (herhangi bir mevcut dosyadan kopyalayın)..github/altındaki araçlar bunun yerine kısa bir yorum kullanır. - Kod ve yorumlar İngilizce. Yorumları minimumda ve yalnızca gerektiğinde tutun.
-
em-dash veya en-dash yok; her zaman düz bir tire
-kullanın. - WebUI saf JS'dir (tek bir
scripts.js); framework yok. - Gerçek bir özelliği asla zayıflatmayın: sahtelemeyi tutarlı tutun ve hook'ların bağlı oldukları bir uygulamayı çökertmesine izin vermeyin (bilerek null kontrolünden geçerler).
- UI dizeleri
module/webroot/lang/içinde yaşar. İngilizce, kanonik yedektir (en.js+en.json); diğer 20 dil<code>.json'dur. - Bir dize eklemek veya değiştirmek için:
en.jsveen.jsondosyalarını düzenleyin, ardından her<code>.jsondosyasını güncelleyin. Görünür bir etikete dokunmak, tüm dil dosyalarını ve tümREADME.<code>.mddosyalarını güncellemek anlamına gelir. - Çeviriler düz JSON'dur: harika bir ilk katkı.
- PR'ları odaklı tutun. Neyi ve neden yaptığınızı açıklayın.
- Commit'lerinizi onaylayın (DCO):
git commit -s(Signed-off-by:ekler). - CI yeşil kalmalıdır. İncelemelerde nazik olun: bkz. CODE_OF_CONDUCT.md.
good first issue ve help wanted etiketlerine bakın. Çeviriler, belgeler ve yeni Pixel
profilleri harika başlangıç noktalarıdır.
Bu belgeler Claude (Anthropic) ile oluşturulmuş olup VD171 tarafından yürütülmektedir. Düzeltmeler ve iyileştirmeler memnuniyetle karşılanır; bkz. CONTRIBUTING.md.