Repository navigation
fa BUILDING
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 یک پروژهٔ استاندارد Android Gradle است: Kotlin و Jetpack Compose، با یک عدسی بومی کوچک در C++ که از طریق NDK ساخته میشود. CI میتواند آن را بسازد، و میتوانید آن را بهصورت محلی بازتولید کنید.
- یک JDK (17 تا 21) و Android SDK.
- Android NDK و CMake، برای عدسی بومی (پلاگین Android Gradle یک
CMake همخوان را واکشی میکند اگر مؤلفهٔ
cmakeاز SDK را داشته باشید). -
minSdk26، پس ساختها روی اندروید 8.0 و جدیدتر اجرا میشوند.
# build both flavors, release
./gradlew assembleReleaseاین دو APK تولید میکند، یکی بهازای هر flavor:
-
modern (
SDK_35) - جعبهٔ شنیِ مدرن و سختگیر، ساختی که باید استفاده کنید. -
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 خودتان را فراهم کنید تا ساختهای خودتان را امضا کنید.
برنامه از روی قصد دو 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 مراجعه کنید.