Lightbuild-App veröffentlichen

Experimentell: Lightbuild ist eine experimentelle Vorschau. Das Design wird noch weiterentwickelt und es werden noch nicht alle Android-Build-Funktionen unterstützt. Für Produktions-Apps, vorhandene Projekte oder ambitionierte neue Apps sollten Sie weiterhin die Kotlin-DSL verwenden. Die Lightbuild-Vorschau eignet sich am besten für kleine Apps, Prototypen und Demos. Weitere Informationen zu den unterstützten Funktionen finden Sie im Vergleich der Kotlin-DSL und in den Versionshinweisen.

Wenn du deine App bei Google Play veröffentlichen möchtest, musst du eine Release-Version der App als Android App Bundle erstellen, sie mit deinem Uploadschlüssel signieren und in die Play Console hochladen. Auf dieser Seite erfahren Sie, wie Sie die Release-Signatur in einem Lightbuild-Projekt konfigurieren und ein signiertes App-Bundle mit der Lightbuild-Befehlszeile erstellen.

Uploadschlüssel erstellen

Google Play verwendet die Play App-Signatur, um die APKs zu signieren, die an Nutzer gesendet werden. Sie signieren die von Ihnen hochgeladenen App-Bundles mit einem Uploadschlüssel. Wenn Sie noch keinen Uploadschlüssel haben, erstellen Sie einen mit keytool, das im JDK enthalten ist:

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

Die Eingabeaufforderung fordert Sie zur Eingabe von Passwörtern für den Schlüsselspeicher und den Schlüssel auf und erstellt anschließend im aktuellen Verzeichnis eine Schlüsselspeicherdatei mit dem Namen upload-keystore.jks. Speichern Sie den Schlüsselspeicher an einem sicheren Ort außerhalb Ihres Projekts und checken Sie ihn nicht in die Versionsverwaltung ein. Weitere Informationen finden Sie unter App signieren.

Release-Signatur konfigurieren

Fügen Sie in der Datei lightbuild.yaml Ihres App-Moduls dem Profil release in packaging einen signing-Block hinzu. Anstatt Ihre Passwörter in die Datei zu schreiben, verweisen Sie mit der Syntax ${NAME} auf Umgebungsvariablen:

android:
  packaging:
    release:
      signing:
        storeFile: "${RELEASE_STORE_FILE}"
        storePassword: "${RELEASE_STORE_PASSWORD}"
        keyAlias: "${RELEASE_KEY_ALIAS}"
        keyPassword: "${RELEASE_KEY_PASSWORD}"

Beim Erstellen liest Lightbuild jeden Wert aus der entsprechenden Umgebungsvariable, sodass Ihre Passwörter nicht in den Dateien Ihres Projekts gespeichert werden. Weitere Informationen zu diesen Einstellungen finden Sie unter Paketierung in der Lightbuild-Konfigurationsreferenz.

Wichtig: Schreiben Sie Passwörter nicht direkt in Ihre lightbuild.yaml-Dateien. Jeder, der die Dateien Ihres Projekts lesen kann, einschließlich des Versionsverwaltungsverlaufs, könnte sie zum Signieren von Apps mit Ihrem Schlüssel verwenden.

Umgebungsvariablen festlegen

Legen Sie vor dem Erstellen die Umgebungsvariablen im Terminal fest, in dem Sie die Lightbuild-Befehlszeile ausführen. Beispiel für macOS oder Linux:

export RELEASE_STORE_FILE="$HOME/keystores/upload-keystore.jks"
export RELEASE_STORE_PASSWORD="KEYSTORE_PASSWORD"
export RELEASE_KEY_ALIAS="upload"
export RELEASE_KEY_PASSWORD="KEY_PASSWORD"

Unter Windows in PowerShell:

$env:RELEASE_STORE_FILE = "$HOME\keystores\upload-keystore.jks"
$env:RELEASE_STORE_PASSWORD = "KEYSTORE_PASSWORD"
$env:RELEASE_KEY_ALIAS = "upload"
$env:RELEASE_KEY_PASSWORD = "KEY_PASSWORD"

Ersetzen Sie KEYSTORE_PASSWORD und KEY_PASSWORD durch Ihre Passwörter. In einem CI-System speichern Sie die Passwörter als Secrets und stellen sie Ihrem Build als Umgebungsvariablen zur Verfügung.

Warnung: Wenn eine dieser Umgebungsvariablen nicht festgelegt ist, schlagen alle Builds Ihres App-Moduls fehl, einschließlich Debug-Builds, und es wird ein Fehler wie Missing required environment variable: RELEASE_STORE_FILE ausgegeben. Legen Sie die Variablen in jeder Umgebung fest, in der Sie Ihre Anwendung erstellen.

Signiertes App-Bundle erstellen

Erhöhen Sie vor jedem Release die Einstellung versionCode in der Datei lightbuild.yaml Ihres App-Moduls und aktualisieren Sie bei Bedarf versionName. Google Play erfordert für jeden Upload einen höheren Versionscode. Weitere Informationen finden Sie unter App versionieren.

Führen Sie den folgenden Befehl aus, um das signierte App-Bundle für die Veröffentlichung zu erstellen:

lightbuild build app:app-release.aab

Lightbuild schreibt das Bundle in app/build/app-release.aab. Führen Sie lightbuild query app/... --output=files aus, um zu sehen, wohin die einzelnen Ziele des App-Moduls ihre Ausgabe schreiben.

App bei Google Play hochladen

Laden Sie das signierte App Bundle in die Play Console hoch. Wenn Sie Ihre App testen möchten, bevor Sie sie für Nutzer veröffentlichen, laden Sie sie zuerst in einen Interner-Test-Track hoch. Weitere Informationen finden Sie unter App in die Play Console hochladen.