The way to build latest Android APK in MacOS Android Studio

[linonetwo]

The Android build always fails, so we should build it by our self.

Open the correct folder

Open the android folder in the Android Studio

install things

Click the elephant icon

set versionCode

First, you can change android/app/build.gradle, so you can make sure you won't encounter "can not downgrade your app" when installing (see https://developer.android.com/studio/publish/versioning for details)

-       versionCode Integer.valueOf(System.env.UPSTREAM_BUILD_NUMBER ?: 1)
+       versionCode Integer.valueOf(System.env.UPSTREAM_BUILD_NUMBER ?: 11281)

The number here should change to the latest on in https://cataclysmdda.org/experimental/ , for now, it is 11281

Set versionName

In android/gradle.properties, set a friendly number for your app's version. So you can see the version number when you install your .apk

override_version=
override_version=11281

Build

This can be very slow, on my high-end MacOS, it still takes 15min, on my friend's small windows laptop, it takes a whole night.

Change signing

It will say Signing is different from existed app upon installing, sadly we can't change our signing to the same as the official one download from https://cataclysmdda.org/experimental/ or http://dev.narc.ro/cataclysm/jenkins-latest/Android/Tiles/

So we can't just overwrite install on an existing CDDA app. We have to

1. backup data in Android/data/com.CleverRaven.Cataclysm-DDA.experimental (Backup android data in macOS will be very slow, so you may want to use https://github.com/syncthing/syncthing to back it up to the computer, you can do this by temporarily enable single direction sync)
2. uninstall the old experimental app
3. install new app build by your self
4. restore data (maybe by single direction sync, or manually copy and paste)

You can also change applicationId in Gradle file before doing your local build, so CleverRaven version and your version could be installed side-by-side and won't interfere whatsoever.

We can sync save between two apps using SyncThing, as it can sync data between several folders. In this way, we can use our won built app if the official one is not released for a long time, and use the official one if it gets released.

[actual-nh]

Always fails?

[linonetwo]

Okay, this is an exaggeration, but look at http://dev.narc.ro/cataclysm/jenkins-latest/Android/Tiles/ it fails 9 out of 10, nearly only release 1 time every 10 days.

An expert said it is because out of disk space #45770 (comment)