Repository navigation
ar 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، بالإضافة إلى WebUI بلغة JavaScript خام (vanilla-JS) للتحكم فيه. وهو fork من COPG (من AlirezaParsi)، تتم صيانته بواسطة VD171 تحت رخصة Apache-2.0. راجع ARCHITECTURE.md وFILE-STRUCTURE.md.
افتراضياً يحصر الانتحال في مكدس Google Play عبر Zygisk، لذا فهو بديل أخف وأكثر متانة لـ PlayIntegrityFix.
مساعدو ووكلاء الذكاء الاصطناعي مساهمون من الدرجة الأولى هنا، لا أمراً ثانوياً.
- بُني المشروع ليكون قابلاً للقراءة: الإعداد ملف JSON واحد
(
/data/adb/COPG-VD/COPG-VD.json، موثَّق في CONFIGURATION.md)، والمحركات صغيرة ومكتفية ذاتياً، والتخطيط موجود في FILE-STRUCTURE.md. - تُراجع الرقع (patches) المساعَدة بالذكاء الاصطناعي وتُقبل بالشروط نفسها كأي رقعة أخرى: حسب الصحة والوضوح والقواعد أدناه، لا حسب من (أو ما) كتبها.
- المعيار نفسه للجميع: لا تُضعَف ميزة حقيقية أبداً، ويبقى الانتحال متسقاً، ولا يصل أي شيء سرّي أو خاص بالجهاز إلى المستودع (راجع .gitignore).
- تحتاج إلى جهاز مُروَّت (rooted) أو محاكٍ مع Zygisk (KernelSU أو APatch أو Magisk) للاختبار.
- ابنِ المكتبة الأصلية لكل ABI باستخدام NDK (r29) وCMake: راجع خطوة
Build zygisk librariesفي.github/workflows/COPG-VD.ymlلمعرفة الأمر الدقيق. يبني الـ CI جميع الـ ABIs الثلاثة نيابةً عنك. - ابنِ ملف 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 بـ vanilla JS (ملف
scripts.jsواحد)؛ بلا أطر عمل. - لا تُضعِف أبداً ميزة حقيقية: أبقِ الانتحال متسقاً، ولا تجعل الخطّافات تعطّل تطبيقاً هي مرتبطة به (هي مُتحقَّق فيها من القيمة null عن قصد).
- توجد سلاسل الواجهة في
module/webroot/lang/. الإنجليزية هي الاحتياطي المرجعي (en.js+en.json)؛ واللغات الـ 20 الأخرى هي<code>.json. - لإضافة سلسلة أو تغييرها: حرّر
en.jsوen.json، ثم حدّث كل<code>.json. لمس تسمية مرئية يعني تحديث جميع ملفات اللغات و جميع ملفاتREADME.<code>.md. - الترجمات هي JSON خام: مساهمة أولى رائعة.
- أبقِ الـ PRs مركّزة. صِف ماذا ولماذا.
- وقّع على commitاتك (DCO):
git commit -s(يضيفSigned-off-by:). - يجب أن يبقى الـ CI أخضر. كن لطيفاً في المراجعات: راجع CODE_OF_CONDUCT.md.
ابحث عن الوسمين good first issue وhelp wanted. الترجمات والوثائق وملفات تعريف Pixel
الجديدة كلها نقاط انطلاق رائعة.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.