Skip to content

ar 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>/. حافظ على اتساق المصطلحات ضمن اللغة، وطابق النبرة القائمة، ولا تترجم أبدًا آليًا مصطلحًا تقنيًا لست متأكدًا منه.

الإبلاغ عن خطأ

افتح مشكلة مع موديل جهازك، وإصدار Android، وإذا كانت عن قراءة، مع تصدير مُشارَك (قيمه الحاملة للهوية مُقنَّعة). التصدير مبني لهذا بالضبط.

الكود

  • ابنِ release، لا debug أبدًا. اختبر على جهاز حقيقي. انظر البناء.
  • أبقِ التعليقات خارج الكود؛ الأسماء تشرح المقصد. الترويسة الوحيدة هي بانر الترخيص في أعلى كل ملف مصدري.
  • طابق النمط القائم وأبقِ التغييرات مركّزة.

الترخيص

بالمساهمة توافق على أن مساهمتك مرخّصة بموجب GNU AGPL-3.0-or-later الخاصة بالمشروع.


تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.

Clone this wiki locally