Configuring AntennaPod SP

Mike Chelen edited this page Jul 19, 2014 · 5 revisions
Clone this wiki locally

First of all, please make sure that you have read Building AntennaPod SP and have successfully built the project.

Set the package name

In order to make sure that your app has a unique application ID, edit build.gradle and search the file for the line that reads

applicationId "de.danoeh.antennapodsp.custom"

Change the word custom in this line so that no one else is going to use the same application ID as your app does. Please do NOT change part before the word custom, otherwise all the other single purpose apps won't be able to recognize your app.

Set the app's name

To change the name of your app, edit the file res/values/strings.xml and search for the line that reads

<string name="app_name">...</string>

Change the value inside this XML-element to the name of your app. Since AntennaPodSP is also available in different languages, there is one strings.xml file for every language for which you have to repeat this process. At the moment, you have to edit the strings.xml files in the following folders:

  • values
  • values-de

Modify AppPreferences.java

Next, you will have to enter the list of feeds that your app should subscribe to and adjust the preferences of the app if needed. All of this can be done in a single file called AppPreferences.java, which you can find in src/de/danoeh/antennapodsp/AppPreferences.java.

The configuration file contains a couple of variables, which already have values assigned to them. You have to change at least the variables feedUrls, which contains the list of feeds that the single purpose app should subscribe to, and USER_AGENT, which is the name of the user agent that is used when making HTTP-requests (for example when downloading episodes). All other variables can be changed if needed, but can also be left unchanged.

At the top of the file, you can also find a variable called feedUrlsVersionNumber. This variable holds the current version number of your configuration. Whenever you change any of the values in AppPreferences after you have released your app, you have to make sure to also increase this variable, so that upgraded installations can recognize that the preferences have changed.

Add icons

Now that your single purpose app's code is configured, you have to add icons and other graphics for your app. In order to make sure that all your icons have an appropriate resolution, you can use the Android Asset Studio.

Set up the splash screen graphics

The splash screen is shown as soon as your app launches. It consists of one square image in the middle of the screen and has a specific background color.

For generating a splash screen icon in all required resolutions, go to the Generic icons generator of the Android Asset Studio and set the size of the icon to 200 dip. Change the name of the icon to splash and download the zip-file with the generated icons. Next, move the splash.png files from the zip-file into the corresponding drawable-folders of the AntennaPodSP project. The drawable-folders of AntennaPodSP can be found in the res/-folder and are named like this:

  • drawable-hdpi
  • drawable-mdpi
  • drawable-xhdpi
  • drawable-xxhdpi

After that, edit the file res/values/colors.xml and search for the line that reads

<color name="theme_color">...</color>

and change the color value inside the XML-element to the desired value (for example, the background color of your splash screen image).

Add your app icon

Now you need to add a launcher icon for your app. You can generate one with the Launcher icon generator of the Android Asset Studio. This time, you should also click on the Generate web icon button to generate an additional web icon for Google Play. Again, you will get one icon for each resolution, which you will have to move into the corresponding drawable-folder of AntennaPodSP as it was described in the previous section. Rename web_hi_res_512.png to ic_launcher-web.png and use it to replace the ic_launcher-web.png file in the root-directory of the project.

Modify the app's about-page

Your app will also have an about-page which you will have to modify. It is a simple HTML-file that can be found in assets/about.html. about.html also references a picture called logo.png in the same folder, which you can replace with your own picture, for example the ic_launcher-web.png file from the previous section. The default in /assets/config_example.json is Einschlafen Podcast