Development

Development

Android

Use JDK 17 and Android SDK 36. From the android-app directory:

./gradlew assembleDebug lintDebug testDebugUnitTest

On Windows use gradlew.bat. The debug APK is at android-app/app/build/outputs/apk/debug/app-debug.apk. Installing it as an update preserves existing app data only when the signing keys match.

Workstation photogrammetry

The separate pipeline requires Python 3.12 or newer, FFmpeg, FFprobe and a compatible COLMAP installation. From the repository root:

python -m processing.benchmark prepare "path/to/input.mp4" --output "path/to/new-run" --fps 5
python -m processing.benchmark reconstruct "path/to/new-run" --colmap "path/to/colmap" --dense
python -m unittest discover -s tests -v

The output directory must be new. Omit --dense for sparse-only processing. See subcommand --help for more options. Dense processing needs a compatible COLMAP configuration.

CI runs Android build, lint and JVM tests and Python tests. These checks do not validate live capture, hardware compatibility, coverage or measurement accuracy. See CONTRIBUTING.md before submitting changes.