Repository navigation
de 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 ist ein Standard-Android-Gradle-Projekt: Kotlin und Jetpack Compose, mit einer kleinen nativen Linse in C++, die über das NDK gebaut wird. CI kann es bauen, und Sie können es lokal reproduzieren.
- Ein JDK (17 bis 21) und das Android SDK.
- Das Android NDK und CMake für die native Linse (das Gradle-Android-Plugin holt ein
passendes CMake, wenn Sie die
cmake-Komponente des SDK haben). -
minSdk26, sodass Builds auf Android 8.0 und neuer laufen.
# build both flavors, release
./gradlew assembleReleaseDies erzeugt zwei APKs, eines pro Flavor:
-
modern (
SDK_35) - die strikte moderne Sandbox, der zu verwendende Build. -
compat (
SDK_27) - ein älteres API-Ziel, nur für den direkten Vergleich.
Die Ausgaben landen in:
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
Um beim Iterieren nur einen Flavor zu bauen:
./gradlew assembleModernRelease # SDK_35 only
./gradlew assembleCompatRelease # SDK_27 onlyRelease-Builds werden mit einem Schlüssel signiert, der lokal und nicht eingecheckt ist (der Keystore und seine Eigenschaften werden von git ignoriert). Ohne ihn baut die Release-Aufgabe trotzdem, aber das APK kommt unsigniert heraus. Stellen Sie Ihren eigenen Keystore bereit, um Ihre eigenen Builds zu signieren.
Die App liefert absichtlich zwei Flavors aus. Sie zielen auf unterschiedliche API-Ebenen und bauen aus derselben Quelle; nur das Ziel und einige wenige abgesicherte Codepfade unterscheiden sich. Eine Änderung, die nativen Code oder einen flavor-spezifischen Pfad berührt, sollte in beiden Flavors gebaut und geprüft werden, nicht nur in dem, in dem Sie iterieren.
Die native Linse ist eine einzige, abhängigkeitsfreie C++-Übersetzungseinheit, die vom
NDK als eine kleine .so gebaut wird, per Name über RegisterNatives gebunden. Sie wird
als Teil des normalen Gradle-Builds kompiliert; es gibt keinen separaten Schritt. Sie
wird bewusst winzig und einfach gehalten.
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)
Siehe Architektur dafür, wie die Teile zusammenpassen, und Mitwirken dafür, wie man ein Erkennungsziel hinzufügt, ohne Code zu berühren.
Diese Dokumentation wurde mit Claude (Anthropic) erstellt und wird von VD171 gepflegt. Korrekturen und Verbesserungen sind willkommen; siehe CONTRIBUTING.md.