Repository navigation
fa 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 یک spoofer دستگاه مبتنی بر Zygisk است: یک کتابخانه native کوچک که به درون پردازههای اپ تزریق میشود تا fingerprint دستگاه و build را بازنویسی کند، به علاوه یک WebUI با JS خالص برای هدایت آن. این یک fork از COPG (نوشته AlirezaParsi) است، که توسط VD171 تحت مجوز Apache-2.0 نگهداری میشود. ARCHITECTURE.md و FILE-STRUCTURE.md را ببینید.
به صورت پیشفرض spoof را از طریق Zygisk به استک Google Play محدود میکند، پس یک جایگزین سبکتر و مقاومتر برای PlayIntegrityFix است.
دستیارها و عاملهای AI اینجا مشارکتکنندگان درجهیک هستند، نه یک فکر بعدی.
- پروژه طوری ساخته شده که خوانا باشد: پیکربندی یک فایل JSON واحد است
(
/data/adb/COPG-VD/COPG-VD.json، مستندشده در CONFIGURATION.md)، موتورها کوچک و خودبسندهاند، و چیدمان در FILE-STRUCTURE.md است. - وصلههای کمکشده با AI با همان شرایط هر وصله دیگری بازبینی و پذیرفته میشوند: بر اساس درستی، شفافیت و قراردادهای زیر، نه بر اساس اینکه چه کسی (یا چه چیزی) آنها را نوشته.
- معیار یکسان برای همه: یک قابلیت واقعی هرگز تضعیف نمیشود، spoof همخوان میماند، و هیچ چیز محرمانه یا مخصوص دستگاه در مخزن فرود نمیآید (ببینید .gitignore).
- برای تست به یک دستگاه یا امولاتور روتشده با Zygisk (KernelSU، APatch یا Magisk) نیاز دارید.
- کتابخانه native را به ازای هر ABI با NDK (r29) و CMake بسازید: برای فرمان دقیق، گام
Build zygisk librariesدر.github/workflows/COPG-VD.ymlرا ببینید. CI هر سه ABI را برای شما میسازد. - یک zip قابل فلش بسازید:
libspoof.soساختهشده را بهmodule/zygisk/<abi>.soکپی کنید، سپسcd module && zip -r9 ../COPG-VD-dev.zip .و آن را فلش کنید. - WebUI در
module/webroot/است (آن را از مدیر روت باز کنید). منطق spoofing درzygisk/spoof_module.cppاست؛ دریافتکننده پروفایلmodule/fingerprint-update.shاست.
-
هر فایل منبع ماژول (
.cpp،.sh،.js،.css،.html) با سربرگ banner پروژه شروع میشود (آن را از هر فایل موجود کپی کنید). ابزارهای زیر.github/به جای آن از یک کامنت کوتاه استفاده میکنند. - کد و کامنتها به انگلیسی. کامنتها را حداقلی و فقط جایی که لازم است نگه دارید.
-
بدون em-dash یا en-dash؛ همیشه از یک hyphen ساده
-استفاده کنید. - WebUI با JS خالص است (یک
scripts.js)؛ بدون framework. - هرگز یک قابلیت واقعی را تضعیف نکنید: spoof را همخوان نگه دارید، و hook ها را طوری نکنید که اپی را که به آن متصلاند کرش کنند (آنها عمداً null-check شدهاند).
- رشتههای UI در
module/webroot/lang/قرار دارند. انگلیسی fallback متعارف است (en.js+en.json)؛ ۲۰ زبان دیگر<code>.jsonهستند. - برای افزودن یا تغییر یک رشته:
en.jsوen.jsonرا ویرایش کنید، سپس هر<code>.jsonرا بهروز کنید. دست زدن به یک برچسب قابلمشاهده یعنی بهروزرسانی همه فایلهای زبان و همهREADME.<code>.md. - ترجمهها JSON سادهاند: یک مشارکت اول عالی.
- PR ها را متمرکز نگه دارید. توصیف کنید چه چیزی و چرا.
- commit های خود را sign off کنید (DCO):
git commit -s(مقدارSigned-off-by:را اضافه میکند). - CI باید سبز بماند. در بازبینیها مهربان باشید: CODE_OF_CONDUCT.md را ببینید.
به دنبال برچسبهای good first issue و help wanted بگردید. ترجمهها، مستندات، و پروفایلهای
جدید Pixel همگی نقاط شروع عالی هستند.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری میشود. اصلاحات و بهبودها خوشآمد است؛ به CONTRIBUTING.md مراجعه کنید.