Repository navigation
ja 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 | 中文
手伝ってくれてありがとう! COPG-VD は貢献しやすいことを目指しています。このガイドは、 物事がどこにあるか、そして私たちが従う少数の慣習を伝えます。
COPG-VD は Zygisk デバイススプーファー です: デバイスの fingerprint と build を書き換えるために アプリプロセスに注入される小さなネイティブライブラリと、それを操作するバニラ JS の WebUI です。 COPG(AlirezaParsi による)のフォークで、VD171 が Apache-2.0 ライセンスのもとで保守しています。 ARCHITECTURE.md と FILE-STRUCTURE.md を参照してください。
デフォルトでは Zygisk を通じてスプーフを Google Play スタックに限定するため、PlayIntegrityFix より 軽量でより堅牢な代替手段です。
AI アシスタントとエージェントは、ここでは後付けではなく、一流の貢献者です。
- プロジェクトは読みやすいように作られています: 設定は単一の JSON ファイル
(
/data/adb/COPG-VD/COPG-VD.json、CONFIGURATION.md に文書化)、 エンジンは小さく自己完結的で、レイアウトは FILE-STRUCTURE.md にあります。 - AI 支援によるパッチは、他のものと同じ条件でレビューされ受け入れられます: 誰が(または何が) 書いたかではなく、正確さ、明瞭さ、そして下記の慣習によって。
- 全員に同じ基準: 本物の機能は決して弱められず、スプーフは一貫性を保ち、秘密のものや デバイス固有のものは何もリポジトリに入りません(.gitignore を参照)。
- テストには Zygisk(KernelSU、APatch または Magisk)を備えた root 化されたデバイスまたはエミュレーターが必要です。
- NDK(r29)と CMake で ABI ごとにネイティブライブラリをビルドします: 正確なコマンドについては
.github/workflows/COPG-VD.ymlのBuild zygisk librariesステップを参照してください。CI はあなたのために 3 つの ABI すべてをビルドします。 - フラッシュ可能な zip をビルドします: ビルドされた
libspoof.soをmodule/zygisk/<abi>.soにコピーし、 次にcd module && zip -r9 ../COPG-VD-dev.zip .してフラッシュします。 - WebUI は
module/webroot/です(root マネージャーから開きます)。スプーフィングロジックはzygisk/spoof_module.cppです; プロファイル取得はmodule/fingerprint-update.shです。
-
すべてのモジュールソースファイル(
.cpp、.sh、.js、.css、.html)はプロジェクトの バナーヘッダーで始まります(既存のファイルからコピーしてください)。.github/以下のツーリングは 代わりに短いコメントを使用します。 - コードとコメントは英語で。 コメントは最小限に、必要な場所だけにしてください。
-
em-dash や en-dash は使わない; 常に単純なハイフン
-を使用してください。 - WebUI は バニラ JS(1 つの
scripts.js)です; フレームワークはありません。 - 本物の機能を 決して弱めない: スプーフを一貫させ、フックが取り付けられているアプリを クラッシュさせないでください(意図的に null チェックされています)。
- UI 文字列は
module/webroot/lang/にあります。英語が正規のフォールバック (en.js+en.json)です; 他の 20 言語は<code>.jsonです。 - 文字列を追加または変更するには:
en.jsとen.jsonを編集し、次にすべての<code>.jsonを更新します。可視ラベルに触れることは、すべての言語ファイルと すべてのREADME.<code>.mdを更新することを意味します。 - 翻訳はプレーンな JSON です: 素晴らしい最初の貢献です。
- PR を集中させてください。何をなぜかを説明してください。
- コミットにサインオフしてください(DCO):
git commit -s(Signed-off-by:を追加)。 - CI はグリーンのままである必要があります。レビューでは親切に: CODE_OF_CONDUCT.md を参照してください。
good first issue と help wanted ラベルを探してください。翻訳、ドキュメント、新しい
Pixel プロファイルはすべて素晴らしい出発点です。
このドキュメントは Claude (Anthropic) で生成され、VD171 によって保守されています。修正や改善を歓迎します。CONTRIBUTING.md を参照してください。