Skip to content

fa CONTRIBUTING

VD $ VD171 @ Priv8 edited this page Nov 18, 2026 · 1 revision

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 مراجعه کنید.

Clone this wiki locally