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 | 中文
شكرًا لاهتمامك بـ 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>/. حافظ على اتساق المصطلحات ضمن اللغة، وطابق النبرة
القائمة، ولا تترجم أبدًا آليًا مصطلحًا تقنيًا لست متأكدًا منه.
افتح مشكلة مع موديل جهازك، وإصدار Android، وإذا كانت عن قراءة، مع تصدير مُشارَك (قيمه الحاملة للهوية مُقنَّعة). التصدير مبني لهذا بالضبط.
- ابنِ release، لا debug أبدًا. اختبر على جهاز حقيقي. انظر البناء.
- أبقِ التعليقات خارج الكود؛ الأسماء تشرح المقصد. الترويسة الوحيدة هي بانر الترخيص في أعلى كل ملف مصدري.
- طابق النمط القائم وأبقِ التغييرات مركّزة.
بالمساهمة توافق على أن مساهمتك مرخّصة بموجب GNU AGPL-3.0-or-later الخاصة بالمشروع.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.