Build and Application Entry Points

Build and Application Entry Points

中文

Last updated: 2026-07-29

Current build baseline

Item	Current value	Source of truth
Gradle	9.6.1	gradle/wrapper/gradle-wrapper.properties
Android Gradle Plugin	9.3.1	gradle/libs.versions.toml
Kotlin	2.4.10	gradle/libs.versions.toml
Java/Kotlin target	21	app/build.gradle.kts
Android SDK	compileSdk 37 / targetSdk 37 / minSdk 23	app/build.gradle.kts
Build Tools	37.0.0	app/build.gradle.kts
NDK	30.0.15729638	Build scripts in external/dadb/dadb-android.
CMake	4.1.2	Build scripts in external/dadb/dadb-android.
C++	C++17	external/dadb/dadb-android
scrcpy server	4.1 with pinned SHA-256	app/build.gradle.kts

Version numbers on this page are read from current build files, never inferred from old wiki text.

Project structure

Screen-Remote/settings.gradle.kts defines one :app Android application module and uses includeBuild("../external/dadb") to substitute local included-build projects for dev.mobile:dadb and dev.mobile:dadb-android.

The build also:

• builds external/dadb/dadb-helper, synchronizes dadb-helper.jar into app-generated assets, and verifies the same versioned helper before remote feature use;
• produces ABI outputs for arm64-v8a, armeabi-v7a, x86, and x86_64, plus a universal APK by default;
• supports overriding ABI outputs with -PTARGET_ABI=<comma-separated ABIs>, for example -PTARGET_ABI=arm64-v8a,armeabi-v7a;
• verifies the bundled scrcpy server SHA-256 before preBuild and check; and
• no longer builds app-local JNI code; adb command execution uses dev.mobile:dadb APIs directly.

Common commands

Run from the Screen-Remote/ app subrepository:

./gradlew assembleDebug
./gradlew testDebugUnitTest
./gradlew :app:verifyScrcpyServerVersion
./gradlew assembleDebug -PTARGET_ABI=arm64-v8a,armeabi-v7a

assembleDebug validates a complete debug APK build. testDebugUnitTest runs local JVM tests. For a boundary-specific change, run focused tests first, then broaden to the full unit suite and debug build.

updateScrcpyServer downloads and verifies the server declared in the build file. It is an explicit dependency-update action, not part of routine builds.

SDK and included build

Both the app and external/dadb/dadb-android are Android Gradle projects. If command-line builds succeed but IDE sync reports an SDK location error, inspect:

• Screen-Remote/local.properties
• external/dadb/local.properties

Both should identify the same Android SDK. Local SDK paths are developer-environment values; do not publish personal paths as wiki facts or commit them.

Android entry points

Entry point	Responsibility
app/ScreenRemoteApp.kt	Initializes logging, settings observation, haptics, local decoder cache, dadb runtime root, ADB connection management, and mDNS discovery.
app/MainActivity.kt	Configures edge-to-edge, theme, and language, accepts browsable screen-remote:// Intents in singleTask mode, and hosts MainScreen plus the optional debug-log overlay.
feature/session/ui/MainScreen.kt	Top-level Compose routing for the sessions page, settings pages, management pages, and remote display.
service/ScrcpyForegroundService.kt	Coordinates an active remote session with Android foreground lifetime.

AndroidManifest.xml registers ScreenRemoteApp, MainActivity, ScrcpyForegroundService, and FileProvider and declares the current platform capabilities for networking, foreground services, USB Host, overlays, and related behavior. The debug manifest additionally registers a read-only diagnostics provider protected by android.permission.DUMP; it is not packaged in release builds.

What a successful build proves

A built APK proves the compile, resource, and packaging paths. It does not replace device validation for:

• USB permission, TCP reachability, or Wireless Debugging pairing/connection;
• scrcpy server startup, socket order, metadata, and decoder output; or
• touch, audio, clipboard, Surface switching, and foreground/background lifecycle.

The canonical page for each subsystem owns those acceptance checks.