Erstellen von Java-Apps für Android

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis sie vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie die Migration in Betracht ziehen können.

Erfahren Sie mehr über die Fristen für den Support sowie über mögliche Alternativen.

Führen Sie die folgenden Schritte aus, um Ihre erste Android-App zu erstellen:

1. Stellen Sie eine Verbindung mit Ihrem Repositorydienstkonto her (GitHub, Bitbucket, VSTS, Azure DevOps).
2. Wählen Sie ein Repository und eine Verzweigung aus, in der sich Ihre App befindet.
3. Wählen Sie das Android-Projekt aus, das Sie erstellen möchten.
4. Richten Sie Ihren ersten Build ein.

Hinweis

Damit die App auf einem echten Gerät ausgeführt werden kann, muss der Build mit einem gültigen Zertifikat signiert sein.

Hinweis

Das App Center verfolgt das Projekt, indem die Gradle-Verzeichnisdateien (und gradlew)-Dateien des Android-Projekts durchsucht werden. Bitte schließen Sie diese Dateien nicht in das Projekt .gitignore ein, da app Center Build sie nicht finden kann.

Warnung

Aufgrund des kürzlichen Herunterfahrens von JCenter können bei bestimmten Apps Gradle-Aufgabenfehler beim Erstellen mit App Center auftreten. Bitte sehen Sie sich den Migrationsleitfaden von Gradle an. Als Problemumgehung können alle Instanzen der jcenter() build.gradle Datei entfernt und durch jcenter { url "http://jcenter.bintray.com/"}. Weitere Informationen zum Herunterfahren von JCenter finden Sie hier.

1. Verknüpfen Ihres Repositorys

Sie müssen eine Verbindung mit Ihrem Repositorydienstkonto herstellen, sofern noch nicht geschehen. Nachdem Ihr Konto verbunden ist, wählen Sie das Repository aus, in dem sich Ihr Android-Projekt befindet. Um einen Build für ein Repository einzurichten, benötigen Sie Administrator- und Pullberechtigungen dafür.

2. Auswählen einer Verzweigung

Nachdem Sie ein Repository ausgewählt haben, wählen Sie die Verzweigung aus, die Sie erstellen möchten. Standardmäßig werden alle aktiven Verzweigungen aufgelistet.

3. Einrichten Ihres ersten Builds

Vor dem ersten Build muss das Android-Projekt konfiguriert werden.

3.1. Trigger erstellen

Standardmäßig wird ein neuer Build jedes Mal ausgelöst, wenn ein Entwickler an eine konfigurierte Verzweigung überträgt. Dies wird als "Kontinuierliche Integration" bezeichnet. Wenn Sie einen neuen Build lieber manuell auslösen möchten, können Sie diese Einstellung im Konfigurationsbereich ändern.

3.2. Buildvariante

Die verfügbaren Buildvarianten werden aus den Buildtypen und Produktaromen aufgefüllt, die in der Datei build.gradle (App-Ebene) angegeben sind. Wählen Sie aus, welche Buildvariante erstellt werden soll.

Hinweis

Der App Center-Build unterstützt die Suche nach Buildvarianten als Kombination aus einem Buildtyp (Debug, Release oder benutzerdefinierter Definition) und einer Ihrer gradle-deklarierten Product Flavors. Die Erkennung von Aromadimensionen (Kombinationen mehrerer Produktaromen) wird derzeit nicht unterstützt.

3.3. Erstellen eines Android-App-Bundles (AAB)

Das Android App Bundle ist ein Verteilungsformat, das in den Play Store hochgeladen wird und verwendet wird, um optimierte APKs für bestimmte Geräte zu generieren. Weitere Informationen zum Android-App-Bundle finden Sie in der offiziellen Android-Dokumentation.

Aktivieren Sie die Option für Android App Bundle, um .aab zusätzlich zum .apk. Wenn die build.gradle Datei (App-Ebene) den android.bundle Block enthält, ist diese Option bereits aktiviert.

3.4. Inkrementierungsversionsnummer

Wenn diese Option aktiviert ist, wird der Versionscode in der AndroidManifest.xml Ihrer App automatisch für jeden Build erhöht. Die Änderung erfolgt während des tatsächlichen Builds und wird nicht für Ihr Repository übernommen.

3.5. Codesignierung

Ein erfolgreicher Build erzeugt eine .apk Datei und eine zusätzliche .aab Datei, wenn diese aktiviert ist. Um den Build im Play Store freizugeben, muss er mit einem gültigen Zertifikat signiert werden, das in einem Keystore gespeichert ist. Um die aus einer Verzweigung erstellten Builds zu signieren, aktivieren Sie die Codesignatur im Konfigurationsbereich, laden Sie Ihren Keystore in Ihr Repository hoch, und geben Sie die relevanten Anmeldeinformationen im Konfigurationsbereich an. Weitere Informationen zum Signieren von Code in der Android-Codesignaturdokumentation von App Center finden Sie hier. Dies .aab wird mit denselben Anmeldeinformationen wie die ..apk

3.6. Starten Sie Ihren erfolgreichen Build auf einem echten Gerät

Verwenden Sie Ihre neu erstellte APK-Datei, um zu testen, ob Ihre App auf einem echten Gerät gestartet wird. Dadurch werden der Gesamtbuildzeit ca. 10 weitere Minuten hinzugefügt. Weitere Informationen zum Konfigurieren von Starttests.

3.7. Konfigurieren aus der Datei "build.gradle" (App-Ebene)

Spezifische Informationen zu Ihrem Build werden aus Ihrer Gradle-Datei gesammelt, einschließlich Abhängigkeiten, Buildtools, Buildtools, Buildtypen und Produktaromen.

3.8. Verteilen des Builds

Sie können jeden erfolgreichen Build aus einer Verzweigung so konfigurieren, dass er an eine zuvor erstellte Verteilergruppe oder ein Speicherziel verteilt wird. Sie können eine neue Verteilergruppe hinzufügen oder eine Speicherverbindung aus dem Verteilungsdienst konfigurieren. Es gibt immer eine Standardverteilergruppe namens "Mitarbeiter", die alle Benutzer enthält, die Zugriff auf die App haben.

Hinweis

Bei der Verteilung an den Google Play Store wird ein Android-App-Bündel (.aab) bevorzugt und bei Aktivierung verteilt. Bei App Center-Verteilergruppen und Intune-Store-Zielen wird auch dann ein regulärer .apk Wert verwendet, wenn auch ein .aab Ziel generiert wird.

4. Erstellen von Ergebnissen

Nachdem ein Build ausgelöst wurde, kann er sich in folgenden Zuständen befinden:

• in die Warteschlange eingereiht – der Build befindet sich in einer Warteschlange, die darauf wartet, dass Ressourcen freigegeben werden.
• erstellen – die App erstellt und führt verwandte Aufgaben aus.
• erfolgreich abgeschlossen.
• failed - the build completed, but it failed. Sie können das Buildprotokoll zur Problembehandlung herunterladen und prüfen.
• abgebrochen – der Build wurde von der Benutzeraktion abgebrochen oder ein Timeout ausgeführt.

4.1. Buildprotokolle

Laden Sie für einen abgeschlossenen Build (erfolgreich oder fehlgeschlagen) die Protokolle herunter, um mehr darüber zu erfahren, wie der Build ausgeführt wurde. App Center stellt ein Archiv mit den folgenden Dateien bereit:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Die buildspezifischen Protokolle (die sich im Build-/Verzeichnis des Archivs befinden) sind hilfreich für die Problembehandlung und das Verständnis, in welchem Schritt und warum der Build fehlgeschlagen ist.

4.2. Das App-Paket (APK)

Das APK ist ein Paket, das die Android-App und -Ressourcen enthält. Wenn der Build ordnungsgemäß signiert ist, kann die APK auf einem echten Gerät installiert und im Play Store bereitgestellt werden. Wenn der Build nicht signiert wurde, kann das APK auf einem Emulator ausgeführt oder für andere Zwecke verwendet werden.

4.3. Erstellen mehrerer APKs

Wenn Ihre App-Konfiguration mehrere APKs erstellt, müssen Sie auch eine universelle APK erstellen. Unser Buildsystem arbeitet mit einer Haupt-APK-Datei und ignoriert alle APKs, die für eine bestimmte CPU-ABI oder Bildschirmdichte spezifisch sind. Wenn Sie mehr über APK-Splits erfahren und ein universelles APK erstellen möchten, lesen Sie den ABI Split Guide.

4.4. Die Deobfuscation-Mapping-Datei (mapping.txt)

Die mapping.txt Datei enthält Informationen zum Zuordnen verschleierter Stapelablaufverfolgungen für die App zurück zu den ursprünglichen Klassen- und Methodennamen.

• Wenn Sie das App Center SDK zuvor in Ihre App mit aktiviertem Absturzberichtsmodul integriert und entweder Proguard oder R8 verwenden, um die App-Binärdatei zu minimieren und zu verschleiern, erfordert der Absturzberichtsdienst diese mapping.txt Datei für einen Build, um lesbare (deobfuscierte) Absturzberichte anzuzeigen.
• Wenn Sie zuvor ein anderes SDK für Absturzberichte in Ihre App integriert haben (z. B. HockeyApp SDK), erfordert der entsprechende Dienst die mapping.txt Datei, um lesbare Absturzberichte anzuzeigen.

5. Unterstützte Versionen und Anforderungen

Die Mindestversion, die zum Erstellen von Android-Apps unterstützt wird, ist 7.0 (API-Ebene 24). Android-Apps können eine niedrigere Mindest-API-Ebene aufweisen, die für die Ausführung erforderlich ist, aber mindestens auf API-Ebene 24 ausgerichtet sein muss.

Apps müssen mit Gradle und dem Android Gradle-Plug-In erstellt werden, um ordnungsgemäß konfiguriert zu werden. Ihr Repository muss einen Gradle-Wrapper enthalten.

Siehe auch: Informationen zu Cloud Build Machine