Home

Custom Android Resources

This project uses an Apache Ant build script to create and package an ANE with your custom Android resources.

The main purpose of this is to allow AIR developers to easily add android resources such as notification icons and configuration values using the correct Android resource process.

This is very important for resources such as notifications icons:

To use this script ensure you have Apache Ant installed on your machine along with a recent version of the AIR and Android SDKs and a version of Java.

AIR SDK : http://www.adobe.com/devnet/air/air-sdk-download.html
Android SDK : Easiest way is to install Android Studio: https://developer.android.com/studio/index.html
Apache Ant : You can download the binary distributions from here: http://ant.apache.org/
- macOS (OSX) :
  - Homebrew : brew install ant
  - MacPorts : sudo port install apache-ant
- Windows:
  - Download the binary distribution and extract to a location
  - Add the ANT_HOME environment variable pointing to this location
  - Update your PATH variable, append %ANT_HOME%\bin

Once you have all those setup, download this repository and open the build.config file. You will need to update the paths to the AIR and Android SDKS, however the rest you can leave as is.

# AIR SDK
air.sdk = /PATH/TO/YOUR/AIR/SDK

# ANDROID
android.sdk = /PATH/TO/YOUR/ANDROID/SDK

On Windows it will look something like the following, you must make sure to use two backslashes to correctly escape a backslash:

# AIR SDK
air.sdk = C:\\Users\\username\\sdks\\air\\AIRSDK_22.0.0.153

# ANDROID
android.sdk = C:\\Users\\username\\AppData\\Local\\Android\\sdk

Resources

Next you will need to place your resources to the res folder. You can add any custom resources your application requires.

The next section shows how to create notification icons to use in our extensions.

Notification Icons

The Android Asset Studio is a great resource which will convert your icon into the correct sizes and formats for an Android notification icon.

Your notification icon needs to be white(grey) and transparent and will be converted to meet these requirements if you provide something different.

Notification Icons

To generate these goto the Android Asset Studio Notification Icon Generator and upload your source image. Make sure you change the name of the icon. You will be using this name to reference this icon in notifications.

Asset Studio