Android project template with different configuration for debug and release builds
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Android Debug Release Template


This is a template Android project, which shows, how to build a single app with a different configurations for debug and release build type. In addition, this template allows to install debug and release version of the same app on one device or emulator, which is not possible with default project configuration.


During software development process developers and QAs may want to have installed release and debug version of the app on a single device, what can be very helpful when they want to develop and use application at the same time. Another advantage is the fact that debug and release version of the app may need different configuration. It this example, we are changing application name and launcher icon, but we can also change different values during compilation in the same way (e.g. address of the webservice). This template also generates versionName of the application, which contains SHA hash of the last commit, build date and time. For debug version it adds -DEBUG suffix to the versionName. Installing two the same applications in different build variants on the same device is possible, because applicationIdSuffix for debug version of the app is added during the compilation, what changes package name for this build variant. As a result, release version of the app has package name "" and debug version of the app has package name "".

Important files with build configurations

Building project with Android Studio

In lower left corner of Android Studio, choose tab Build Variants. In this tab you can switch between debug and release version of the output application. When you have chosen appropriate Build Variant, make project (shortcut: CTRL+F9). After that, you can run your compiled application (shortcut: Shift+F10).


Building project with Gradle (Command Line Interface)

On Windows

Debug version

> gradlew.bat assembleDebug

Release version

> gradlew.bat assembleRelease

On Linux and Mac OS

Debug version

$ chmod +x gradlew
$ ./gradlew assembleDebug

Release version

Assuming we gave rights to execute for gradle wrapper (gradlew file) earlier:

$ ./gradlew assembleRelease

Additional information

Please note that Android Studio, Android SDK, Build Tools and Gradle are evolving very quickly and their future updates may cause compilation errors of this template. This project was created with Android Studio 1.0.1 and Build Tools 1.0.0.


Copyright 2015 Future Processing Sp. z o.o.

Licensed under The MIT License (MIT), see LICENSE.txt for details.