Repository navigation
ru 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, так что сборки работают на Android 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.