Skip to content

de 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 bauen

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.

Voraussetzungen

  • 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).
  • minSdk 26, sodass Builds auf Android 8.0 und neuer laufen.

Schnellstart

# build both flavors, release
./gradlew assembleRelease

Dies 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 only

Signierung

Release-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 zwei Flavors

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

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.

Wo die Dinge liegen

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.

Clone this wiki locally