This directory contains an implementation of the Ultrablue client for Android.
- Download Android Studio for your platform: https://developer.android.com/studio Ultrablue is developed using Linux, other platforms have not been tested.
- Install Android Studio for your platform: https://developer.android.com/studio/install
- Install the Android NDK for your platform. There are several ways to do this, but the easiest is probably to get it from Android Studio (
Tools > SDK Manager > SDK Tools > NDK). Alternatively, you can download the latest version and unpack it in~/Android/Sdk/ndk-bundle: https://developer.android.com/ndk/downloads - Launch Android Studio and import the
ultrablueproject. - Configure a device to run the app: https://developer.android.com/studio/run/device Under Linux, pay special attention to the part about udev permissions.
- The Android client depends on the go-mobile library. You need to build it first: see instructions in clients/go-mobile.
- You are now ready to build and run the app: https://developer.android.com/studio/run
Ultrablue is tested manually using a Pixel 4a. There is no way to fully test the client in the Android emulator because the emulator does not support bluetooth.
Start the server in enroll mode:
$ sudo server/ultrablue_server --enroll
This should display a QR Code. See server/README.md for more instructions about building and running the server.
Start the client app on your phone (from Android Studio), and follow the instructions displayed by the server to scan the QR Code.
- If your build fails with an error message about gomobile, make sure you have built the go-mobile library.
- Under Linux, if your build fails, make sure the tmp directory has exec permissions.
- If your emulator fails to start under Wayland, check that you have
xcblisted as a fallback in$QT_QPA_PLATFORM. Start the emulator manually in a terminal to get useful error messages:~/Android/Sdk/emulator/emulator @Pixel_4a_API_30.