Step 1: Clone the repository, download dependencies
Execute the following commands to download the AntennaPod repository and the repositories of its library projects:
git clone --recursive https://github.com/AntennaPod/AntennaPod.git
Set up the Android SDK
In order to be able to build the app, you should download the following SDK components:
- Android SDK tools, Android SDK platform-tools and Android SDK Build-tools
- The latest version of the Android SDK platform
- Android support repository
- Android support library
Step 2: Set up build system
There are several different tools available for building AntennaPod. You only have to choose one of them.
Building in Android Studio
- In Android Studio, go to File → Import Project…
- Select the root directory of the AntennaPod repository and click "OK".
- Select "import project from external model"
- Select "gradle" in the list below "import project from external model" and click "Next"
- Select "Use default gradle wrapper". You can also configure Android Studio to use the version of gradle that is installed on your system, but you have to make sure that it is compatible with the project's setup. See
Building on the command-line with gradlefor a detailed description of the wrapper script.
- Click "Finish".
Building in Eclipse
- In Eclipse, go to File → Import... → Android → Existing Android Code Into Workspace
- Select the root directory of the AntennaPod repository as the root directory in the import dialog.
- Deselect all projects except the one located in the root directory of AntennaPod (it should be called "MainActivity"). Click "Finish".
- Next, you have to import two library projects. Open the same import dialog and select the same root directory as before. Deselect all projects except the one located in
submodules/dslv/library(it should be called "library"). Click "Finish" and rename the project, for example to "dslv".
- Repeat the previous step to import the appcompat-v7 library. It should be located in
Android SDK home/extras/android/support/v7/appcompat.
- In eclipse, right-click the AntennaPod project, then go to Properties → Android. Make sure that both library projects are referenced by AntennaPod.
- If you want to run tests, you can also import the test project that is located in the "test" directory. This step is optional.
- Eclipse might refuse to build the app because of different versions of the support library. To solve this issue, right-click the AntennaPod project and go to Android Tools → Add Support Library... . Repeat this step with every one of the two library projects.
- Wait until Eclipse has finished building the workspace. If no errors are displayed, you can start developing. Congratulations!
Building on the command-line with gradle
- You can either use the version of gradle that is installed on your system or the wrapper script
gradlewin the project's repository. It is recommended to use the wrapper script because it will always use a version of gradle that is compatible with the project setup and it will update itself automatically if necessary.
- If you use the version of gradle that is installed on your system, make sure to use the latest version of gradle.
- You may need to set ANDROID_HOME to point to your Android SDK before running Gradle
export ANDROID_HOME=/Users/username/development/android/sdk gradle foo
The wrapper script can be found in the project's root folder. On Windows, you should use
gradlew.bat, on all other operating system you should
gradlew. You can execute the usual gradle commands by replacing the
./gradlew. For example
- Gradle will download the project's dependencies automatically when building the project.
Useful commands for building with gradle
Build debug APK:
Install debug APK on device:
Print a list of all available commands:
More commands can be found in the Gradle Plugin User Guide
Building a release APK with gradle
If you want the release APK to be signed by gradle automatically, you have to create a file called
Add the following lines to the
gradle.propertiesand replace the value to the right of the
=with information about your keystore:
releaseStoreFile=keystore releaseStorePassword=password releaseKeyAlias=alias releaseKeyPassword=password
Tips on generating keystore
Note: the release APK you created CANNOT install over the APK from official distribution. Android's security check forbids so (your APK has a signature generated above, different from the one signed in the official one).
Useful commands for building release versions with gradle
Build release APK:
Install release APK on device:
Running unit tests
Unit test source files can be found in
src/instrumentationTest. In order to run the unit tests, you have to set up gradle first (see
Building on the command-line with gradle for details). Execute the following command to run the unit tests on all connected devices:
Once the unit tests have been run, a HTML report can be found in
If you see the error
Execution failed for task ':submodules:dslv:library:preBuild'. > The SDK Build Tools revision (19.0.3) is too low for project ':submodules:dslv:library'. Minimum required is 19.1.0
then edit the file
submodules/dslv/library/build.gradle and replace
19.1.0. See this issue for further details.
If you get an error
Could not find com.android.support:appcompat-v7:21.0.2 when building with Gradle, try
android update sdk -u -a -t extra-android-m2repository