Akka Android Sbt Scala - Example Project

This example project uses Akka 2.3.14, Scala 2.11.8, Android API 22 and Sbt 0.13.11. Enjoy!

Prerequisites

• sbt 0.13.11 or above
• JDK 1.7 or above
• Android build tools 20.0.0 or above
• Android SDK Level 22

• Level 22 is required for building, while this app retains runtime compatibility from API Level 16. Please refer to minSdkVersion property in AndroidManifest.xml

Build

You can build this project using sbt:

$ sbt android:package

This will compile the project and generate an APK.

Run

$ sbt android:run

For more command, refer to android-sdk-plugin for sbt.

Tips for faster development iteration

In sbt, ~ is a prefix that repeatedly runs the command when the source code is modified.

~run

This sbt command schedules to execute compile-package-deploy-run process after you save the edited source code. Compiling and packaging runs incrementally, so this iteration takes about only few seconds.

If you use default AVD, try genymotion or other faster virtual device. Deploying apk to the device becomes much faster!

Using IntelliJ IDEA

We recommend to use IntelliJ, not Eclipse.

Generate the local.properties file

 $ android update project -p src/main --target android-22 # in the root of the project

Plugins

Make sure the Scala & SBT plugins are installed in IntelliJ IDEA

Import the SBT project

File -> Open... -> select project root folder -> OK -> Check "Use auto-import" & for Project SDK, select an Android API platform -> Finish. Choose to configure the android project when IDEA asks.

Edit the generated run configuration. Add 'Android application' configuration. Remove the 'Before launch: Make' then add a new SBT command android:package then tab out or it will not save, then click OK then OK.

You now should be able to run and debug from the run configuration like normal.

Troubleshooting

Troubleshooting IntelliJ

Local path doesn't exist. when Intellij tries to deploy the apk.

File -> Project Structure -> Modules -> android-akka-sbt-scala -> Android -> Packaging -> Then choose the APK Path for the apk. For this project it should be in .../bin/android-akka-sbt-scala-debug.apk

Build error Android SDK build-tools not available

The most likely cause of this error is that your SDK build-tools are old. Update the Android SDK and retry.

License

Copyright (C) 2016 Gorazd Kozmus (http://unicorncoding.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.