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 | 中文
از علاقهتان به VD Infos سپاسگزاریم. مشارکتها خوشآمدند: فهرستهای تشخیص، ترجمهها، گزارشهای باگ، مستندات و کد. بیشتر مشارکتها به هیچ Kotlin نیاز ندارند.
بیشترِ آنچه برنامه بهدنبالش است بهصورت فهرستهای متن ساده زیر
VDInfos/app/src/main/assets/data/ زندگی میکند، نه بهصورت کد. افزودن یا برداشتن یک هدف ویرایش
یک خط و گشودن یک pull request است:
-
*_apps.txt- یک نام بسته در هر خط. -
props.txt- کاتالوگ ویژگیهای سیستم،CATEGORY<tab>key. -
spoof_keys.txt- ماتریس تنظیمات،key:TYPE. -
known_certs.txt- کاتالوگ گواهیهای امضا،SHA-256<tab>owner(هشِ کامل، گرفتهشده از یک APK واقعی باapksigner verify --print-certs). - دیگر فایلهای
.txt- یک ورودی در هر خط (پارههای نام ماژولهای هسته، نامهای فایل، و به همین ترتیب).
یک # یک توضیح را آغاز میکند و خطهای خالی نادیده گرفته میشوند. برخی فایلها چند فیلد جداشده با فاصله یا
تب در هر خط، یا نشانگرهای اختیاری را جا میدهند؛ شکل خطهایی را که از پیش
در فایل هستند حفظ کنید.
- VD Infos حقیقت را میخواند و هرگز چیزی را جعل نمیکند. آنچه را که هر متد برگرداند، دقیقاً، گزارش میدهد. یک خوانش را برای زیباتر جلوهدادن نرم نکنید، و چیزی را که یک مقدار را تغییر دهد بهجای خواندن آن نیفزایید.
- حریم خصوصی مطلق است. همهچیز روی دستگاه اجرا میشود. هرگز یک فراخوانی شبکه، یا هرچیزی را که یک خوانش را از دستگاه بیرون بفرستد نیفزایید.
- خروجیها پوشانده میمانند. مقادیر هویتدار در یک گزارش بهاشتراکگذاشتهشده پوشانده میشوند. همینگونه نگهشان دارید.
ترجمهها مشارکتی ارزشمندند. readme بهازای هر زبان ترجمه میشود
(README.<lang>.md)، رشتههای برنامه بهازای هر زبان، و این مستندات زیر
docs/<lang>/. اصطلاحشناسی را درون یک زبان یکدست نگه دارید، با لحن موجود همخوان باشید،
و هرگز یک اصطلاح فنی را که از آن مطمئن نیستید ماشینی ترجمه نکنید.
یک مسئله با مدل دستگاهتان، نسخهٔ اندروید، و، اگر دربارهٔ یک خوانش است، یک خروجیِ بهاشتراکگذاشتهشده (مقادیر هویتدارش پوشانده شدهاند) بگشایید. خروجی دقیقاً برای همین ساخته شده است.
- release بسازید، هرگز debug. روی یک دستگاه واقعی آزمایش کنید. ساختن را ببینید.
- توضیحها را بیرون از کد نگه دارید؛ نامها نیت را توضیح میدهند. تنها سرنوشته بنرِ مجوز در بالای هر فایل منبع است.
- با سبک موجود همخوان باشید و تغییرها را متمرکز نگه دارید.
با مشارکت میپذیرید که مشارکت شما تحت GNU AGPL-3.0-or-later پروژه مجوز میگیرد.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری میشود. اصلاحات و بهبودها خوشآمد است؛ به CONTRIBUTING.md مراجعه کنید.