Building the app yourself

Building the app

Prerequisites: Android Studio and python3 installed on your device.

1. Place the created icons in the /newicons folder and add the new Component Info codes in the appfilter.xml, you can gather it with icon request (see Updating existing apps).

2. Change the versionCode and versionName in the /app/build.gradle file.

3. Open the repo in Android Studio. It will take a while to sync/load everything for the first time.

4. Choose the build flavor that you want

5. In the top bar on the right side, you will see a dropdown menu next to a green play button.

   
6. It's important to check for possible errors in your icons or appfilter entries, click on the dropdown menu and click on RunChecks. The Build tab at the bottom will show possible entries or icons to fix.

7. In the left sidebar, you will find the build variants button, choose the variant that you want

   

   Build Variants tab in Android studio
8. Click on the dropdown menu and click on Prepare New Release, and then the green play button. Wait for the process to finish.

9. Plug your phone and allow USB debugging in your phone's developer settings.

   1. Settings > About phone > Build number

10. Click on the dropdown menu and click on App, then the green play button to run the app on your phone!

    1. You can also generate an APK file in Android studio:

       • Toolbar > Build > Make project (the hammer icon)

         • For a normal APK: Toolbar > Build > Build bundle(s)/APK(s) > Build APK(s)

         • For a signed APK: Toolbar > Build > Build bundle(s)/APK(s) > Generate signed bundle/APK

Choosing your build flavors

The app is built as a debug version (com.donnnno.arcticons.debug) by default.

To choose another variant: Build Variants(on the left sidebar) > *Active Build Variant* > select from the menu.