Wie man die VersionCode-Beschränkung von Xamarin.Android umgeht

Wie kann das passieren?

Als wir zum ersten Mal von diesem Problem hörten, haben wir uns gefragt, wie so etwas überhaupt passieren kann. Wir haben uns den Build-Prozess angesehen und auf den ersten Blick nichts Auffälliges gefunden. Der Build zählt die Build-Nummer hoch und setzt diese dann als VersionCode. Genau solche Stolpersteine begegnen uns regelmäßig in der Android App Entwicklung und in Projekten, die auf eine plattformübergreifende App mit gemeinsamer Codebasis setzen.

Trotzdem gibt es Konfigurationen, mit denen man genau in dieses Problem laufen kann. Ein Beispiel ist die Verwendung des vollständigen Build-Datums als VersionCode. Solche Setups haben wir tatsächlich gesehen. Grundsätzlich ist das kein Problem, weil der maximale Wert eines Integers groß genug ist. Google Play akzeptiert laut Dokumentation VersionCodes bis zu 2.100.000.000.

So lässt sich das Problem beheben - Option 1

Auf der Suche nach einer Lösung bin ich auf diese Frage in den Xamarin-Foren gestoßen sowie auf das Bug-Ticket 51620, das inzwischen durch die Umstellung von Bugzilla auf GitHub nicht mehr erreichbar ist. Beide Quellen empfahlen, die Option Generate one package (.apk) per selected ABI in den Android-Build-Einstellungen zu deaktivieren.

Diese vorgeschlagene Lösung funktioniert. Sie kann aber abhängig von den im Reiter Advanced ausgewählten ABIs zu einer unnötig aufgeblähten APK führen. Wenn du weiterhin getrennte ABI-Pakete an Google Play verteilen möchtest, brauchst du einen anderen Weg.

So lässt sich das Problem beheben - Option 2

Wenn du nicht wie dieser Entwickler auf Stack Overflow enden möchtest, folge diesen Schritten, um den VersionCode nach dem Build deiner Xamarin.Android-APK anzupassen.

1. Baue dein Xamarin.Android-Projekt mit einem beliebigen VersionCode zwischen 0 und 65000.
2. Öffne eine Kommandozeile und führe apktool d $APK_PATH -o $OUTPUT_FOLDER aus.
3. Öffne die Datei apktool.yml und passe dort die Einträge für versionCode an.
4. Erstelle die APK mit apktool build $OUTPUT_FOLDER erneut.
5. Signiere die neue APK anschließend erneut mit dem ursprünglichen Keystore.

jarsigner -verbose -keystore $KEYSTORE_PATH -storepass $KEYSTORE_PASSWORD -keypass $KEYSTORE_KEY_PASSWORD $APK_PATH $KEYSTORE_KEY_NAME ~/android-sdk/build-tools/25.0.2/zipalign -v 4 $APK_PATH $APK_OUT_PATH

Eine kurze Erinnerung noch: Wenn du ABI-spezifische APKs erzeugst, solltest du dir auch die Xamarin-Dokumentation dazu ansehen, wie VersionCodes für solche APKs aufgebaut werden sollten.

FAQ