Skip to content

ar BUILDING

github-actions[bot] edited this page Nov 18, 2026 · 2 revisions

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

VD Infos مشروع Android Gradle قياسي: Kotlin وJetpack Compose، مع عدسة أصلية صغيرة بلغة C++ مبنية عبر الـ NDK. يمكن للـ CI بناؤه، ويمكنك إعادة إنتاجه محليًا.

المتطلبات

  • JDK (من 17 إلى 21) وAndroid SDK.
  • Android NDK وCMake، للعدسة الأصلية (يجلب مكوّن Gradle Android الإضافي CMake مطابقًا إذا كان لديك مكوّن cmake من الـ SDK).
  • minSdk 26، بحيث تعمل البنى على Android 8.0 وأحدث.

بداية سريعة

# build both flavors, release
./gradlew assembleRelease

هذا يُنتج ملفَّي APK، واحدًا لكل flavor:

  • modern (SDK_35) - الـ sandbox الحديث الصارم، البنية التي تُستخدم.
  • compat (SDK_27) - هدف API أقدم، للمقارنة جنبًا إلى جنب فقط.

تهبط المخرجات في:

app/build/outputs/apk/modern/release/VDInfos-v<ver>-SDK_35-release.apk
app/build/outputs/apk/compat/release/VDInfos-v<ver>-SDK_27-release.apk

لبناء flavor واحد فقط أثناء التكرار:

./gradlew assembleModernRelease   # SDK_35 only
./gradlew assembleCompatRelease   # SDK_27 only

التوقيع

تُوقَّع بنى الـ release بمفتاح محلي وغير مُودَع (الـ keystore وخصائصه متجاهَلة من قبل git). بدونه تُبنى مهمة الـ release مع ذلك لكن الـ APK يخرج غير موقَّع. وفّر الـ keystore الخاص بك لتوقيع بناءاتك الخاصة.

الـ flavoran

يشحن التطبيق flavorين عن قصد. يستهدفان مستويات API مختلفة ويُبنيان من المصدر نفسه؛ ولا يختلف إلا الهدف وبضع مسارات كود محروسة. التغيير الذي يمسّ كودًا أصليًا أو مسارًا خاصًا بـ flavor ينبغي أن يُبنى ويُفحَص في كلا الـ flavorين، لا في الذي تكرّر عليه فقط.

العدسة الأصلية

العدسة الأصلية هي وحدة ترجمة C++ واحدة خالية من التبعيات يبنيها الـ NDK كملف .so صغير واحد، مربوط بالاسم عبر RegisterNatives. تُترجَم كجزء من بناء Gradle العادي؛ لا توجد خطوة منفصلة. وتُبقى صغيرة وبسيطة عن قصد.

أين تعيش الأشياء

app/src/main/java/ru/vd171/vdinfos/   Kotlin: model, probes, engine, data, ui
app/src/main/cpp/                     the native lens
app/src/main/assets/data/             the plain-text detection lists (see Contributing)

انظر البنية لمعرفة كيف تتلاءم الأجزاء معًا، والمساهمة لمعرفة كيفية إضافة هدف اكتشاف دون لمس الكود.


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

Clone this wiki locally