Repository navigation
pl 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 | 中文
Dziękujemy za pomoc! COPG-VD ma być łatwy do współtworzenia. Ten przewodnik mówi, gdzie wszystko się znajduje i jakich kilku konwencji przestrzegamy.
COPG-VD to spoofer urządzenia Zygisk: mała natywna biblioteka wstrzykiwana do procesów aplikacji w celu przepisania odcisku urządzenia i buildu, plus WebUI w czystym JS do sterowania nim. To fork COPG (autorstwa AlirezaParsi), utrzymywany przez VD171 na licencji Apache-2.0. Zobacz ARCHITECTURE.md i FILE-STRUCTURE.md.
Domyślnie ogranicza spoof do stosu Google Play poprzez Zygisk, więc jest lżejszą, bardziej odporną alternatywą dla PlayIntegrityFix.
Asystenci i agenci AI są tu pełnoprawnymi współtwórcami, a nie dodatkiem.
- Projekt jest zbudowany tak, aby był czytelny: konfiguracja to jeden plik JSON
(
/data/adb/COPG-VD/COPG-VD.json, udokumentowany w CONFIGURATION.md), silniki są małe i samodzielne, a układ znajduje się w FILE-STRUCTURE.md. - Łatki wspierane przez AI są recenzowane i akceptowane na tych samych warunkach co każde inne: według poprawności, przejrzystości i poniższych konwencji, a nie według tego, kto (lub co) je napisał.
- Ta sama poprzeczka dla wszystkich: prawdziwa funkcja nigdy nie jest osłabiana, spoof pozostaje spójny, a nic tajnego ani specyficznego dla urządzenia nie trafia do repozytorium (zobacz .gitignore).
- Potrzebujesz zrootowanego urządzenia lub emulatora z Zygisk (KernelSU, APatch lub Magisk) do testów.
- Zbuduj natywną bibliotekę per ABI za pomocą NDK (r29) i CMake: zobacz krok
Build zygisk librariesw.github/workflows/COPG-VD.ymlpo dokładne polecenie. CI buduje wszystkie trzy ABI za Ciebie. - Zbuduj zip do flashowania: skopiuj zbudowany
libspoof.sodomodule/zygisk/<abi>.so, następniecd module && zip -r9 ../COPG-VD-dev.zip .i zainstaluj go (flash). - WebUI to
module/webroot/(otwórz je z menedżera roota). Logika spoofowania tozygisk/spoof_module.cpp; pobieranie profilu tomodule/fingerprint-update.sh.
-
Każdy plik źródłowy modułu (
.cpp,.sh,.js,.css,.html) zaczyna się od nagłówka bannera projektu (skopiuj go z dowolnego istniejącego pliku). Narzędzia w.github/używają zamiast tego krótkiego komentarza. - Kod i komentarze po angielsku. Utrzymuj komentarze minimalne i tylko tam, gdzie potrzebne.
-
Bez em-dash ani en-dash; zawsze używaj zwykłego myślnika
-. - WebUI to czysty JS (jeden
scripts.js); bez frameworków. - Nigdy nie osłabiaj prawdziwej funkcji: utrzymuj spoof spójnym i nie doprowadzaj do tego, aby haki zawieszały aplikację, do której są dołączone (mają celowe sprawdzanie null).
- Ciągi interfejsu znajdują się w
module/webroot/lang/. Angielski jest kanonicznym fallbackiem (en.js+en.json); pozostałe 20 języków to<code>.json. - Aby dodać lub zmienić ciąg: edytuj
en.jsorazen.json, następnie zaktualizuj każdy<code>.json. Dotknięcie widocznej etykiety oznacza aktualizację wszystkich plików językowych oraz wszystkichREADME.<code>.md. - Tłumaczenia to zwykły JSON: świetny pierwszy wkład.
- Utrzymuj PR-y skupione. Opisz co i dlaczego.
- Podpisuj swoje commity (DCO):
git commit -s(dodajeSigned-off-by:). - CI musi pozostać zielone. Bądź życzliwy w recenzjach: zobacz CODE_OF_CONDUCT.md.
Szukaj etykiet good first issue i help wanted. Tłumaczenia, dokumentacja i nowe
profile Pixela to świetne punkty startowe.
Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.