test-orgn / appboy-android-sdk

Public repo for the Braze Android SDK

Android SDK

Successful marketing automation is essential to the future of your mobile app. Braze helps you engage your users beyond the download. Visit the following links for details and we'll have you up and running in no time!

• Braze User Guide
• Braze Developer Guide
• JavaDocs

Version Information

• The Braze Android SDK supports Android 4.1+ / API 16+ (Jelly Bean and up).
• Last Target SDK Version: 30
• Last Compiled Firebase Cloud Messaging Version: 20.2.4
• Braze uses Font Awesome 4.3.0 for in-app message icons. Check out the cheat sheet to browse available icons.
• Braze requires a custom IAppboyImageLoader to display animated gif images.

Components

• android-sdk-base - the Braze SDK base analytics library.
• android-sdk-ui - the Braze SDK user interface library for in-app messages, push, and the news feed.
• droidboy - a sample app demonstrating how to use Braze in-depth.
• hello-appboy - a sample app demonstrating a basic Braze integration.
• android-sdk-unity - a library that enables Braze SDK integrations on Unity.
• samples - a folder containing several sample apps for various integration options.

Remote repository for gradle

The version should match the git version tag, or the most recent version noted in the changelog. An example dependency declaration is:

repositories {
   maven { url "https://appboy.github.io/appboy-android-sdk/sdk" }
   ...
}

dependencies {
   implementation 'com.appboy:android-sdk-ui:12.0.+'
   ...
}

Installing android-sdk-ui to Your Local Maven Repository

To install the UI library as an AAR file to your local maven repository, run the install task with ./gradlew install. You can reference it with groupId com.appboy and artifactId android-sdk-ui. The version should match the git version tag, or the most recent version noted in the changelog. An example dependency declaration is:

repositories {
   mavenLocal()
   ...
}

dependencies {
  implementation 'com.appboy:android-sdk-ui:12.0.+'
}

Building and Running the Sample Applications

1. Make sure the ANDROID_HOME environment variable is set to the location of your installed SDK or you have a local.properties file which defines the sdk.dir property. You can check this by running echo $ANDROID_HOME, or echo %ANDROID_HOME% in Windows.
2. To assemble the UI library and the Droidboy APK, run ./gradlew assemble (use gradlew.bat on Windows). You can find assembled files in the build/ subdirectories of the android-sdk-ui and droidboy projects. You can also use the installDebug task if you have a device or emulator connected to adb and want to run Droidboy or Hello-Appboy. You can see other available tasks by running ./gradlew tasks.

Questions?

If you have questions, please contact [email protected].