TodoApp Android: An Android Sample App
This Android Studio project wraps the Desktop Sample App to run on an Android phone.
How to build & run
-
Install Android Studio + NDK.
-
Go to "Files -> New -> Project from Version Control" and enter this URL: https://github.com/elixir-desktop/android-example-app/
-
Connect your Phone to Android Studio
-
Start the App
Known todos
Initial Startup could be faster
Running the app for the first time will extract the full Elixir & App runtime at start. On my Phone this takes around 10 seconds. After that a cold app startup takes ~3-4 seconds.
Menus and other integration not yet available
This sample only launch the elixir app and shows it in an Android WebView. There is no integration yet with the Android Clipboard, sharing or other OS capabilities. They can though easily be added to the Bridge.kt
file when needed.
Other notes
-
The current sample is using Android API 23 and above
-
The Erlang runtime is for ease of use embedded in this example git repository. The native runtimes for Android ARM, ARM64 and X86_64 and the exqlite nif are are generated using the Desktop Runtime repository.
-
Android specific settings, icons and metadata are all contained in this Android Studio wrapper project.
-
Bridge.kt
and the native library are doing most of the wrapping of the Elixir runtime.
Screenshots
Architecture
The Android App is initializing the Erlang VM and starting it up with a new environment variable BRIDGE_PORT
. This environment variable is used by the Bridge
project to connect to a local TCP server inside the android app. Through this new TCP communication channel all calls that usually would go to wxWidgets
are now redirected. The Android side of things implements handling in Bridge.kt
.