Erstellen von React Native-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.

App Center kann React Native-Apps mit React Native Version 0.34 oder höher erstellen.

Um mit dem Erstellen Ihrer ersten React Native Android-App zu beginnen, müssen Sie:

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 Projekt package.json 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.

1. Verknüpfen Ihres Repositorys

Wenn Sie zuvor noch keine Verbindung mit Ihrem Repositorydienstkonto hergestellt haben, müssen Sie dies zuerst tun. Nachdem Ihr Konto verbunden ist, wählen Sie das Repository aus, in dem sich Ihr React Native-Projekt befindet. Sie müssen über Administrator- und Pullberechtigungen verfügen, um einen Build für ein Repository einzurichten.

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 listet App Center alle aktiven Verzweigungen auf.

3. Einrichten Ihres ersten Builds

Vor dem ersten Build müssen Sie das React Native-Projekt konfigurieren.

3.1. Projekt

Wählen Sie die Projektdetails package.jsonaus. App Center extrahiert automatisch Informationen aus der zugeordneten Datei "build.gradle " (App-Ebene), einschließlich Abhängigkeiten, Buildtools, Buildtools, Buildtypen und Produktaromen.

Hinweis

Um eine optimale Leistung zu erzielen, ist die Analyse derzeit auf vier Verzeichnisebenen beschränkt, einschließlich des Stamms Ihres Repositorys.

3.2. Buildvariante

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

Hinweis

App Center Build unterstützt das Suchen von Buildvarianten als Kombination aus einem Buildtyp (Debug, Release oder benutzerdefinierter Definition) und einem optionalen Produktgeschmack. Das Erkennen von Kombinationen mehrerer Produktaromen wird derzeit nicht unterstützt.

3.3. Node.js-Version

Wählen Sie die Node.js Version aus, die für den Build verwendet werden soll. Weitere Informationen zum Auswählen Node.js Version

3.4. 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.5. Erstellen eines Android-App-Bundles (AAB)

Das Android App Bundle ist ein Verteilungsformat, das in den Play Store hochgeladen werden kann. Es wird verwendet, um optimierte APKs für bestimmte Geräte zu generieren. Weitere Informationen zum Android-App-Bündel finden Sie in der offiziellen Android-Dokumentation, die Ihnen auch hilft, zu verstehen, ob Sie ein Bündel zusammen mit Ihrer regulären Version erstellen möchten. .apk.

Aktivieren Sie die Option für Android App Bundle, um zusätzlich .aab zu den .apk. Wenn die build.gradle Datei auf App-Ebene den android.bundle Block enthält, wird diese Option automatisch aktiviert.

3.6. 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.7. Starten Sie Ihren erfolgreichen Build auf einem echten Gerät

Verwenden Sie die neu erstellte APK-Datei, um zu testen, ob Ihre App auf einem echten Gerät gestartet wird. Starttests fügen etwa 10 weitere Minuten zur Gesamtbuildzeit hinzu. Weitere Informationen zum Konfigurieren von Starttests.

3.8. 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 stellen Sie die relevanten Werte im Konfigurationsbereich bereit. Weitere Informationen zur Android-Codesignaturdokumentation von App Center finden Sie in der Dokumentation zur Codesignatur von Android. Dies .aab wird mit denselben Anmeldeinformationen wie die ..apk

3.9. 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, befindet sich der Build in einem der folgenden Zustände:

• in die Warteschlange eingereiht – der Build befindet sich in einer Warteschlange, die darauf wartet, dass Ressourcen freigegeben werden.
• erstellen – der Build führt die vordefinierten Aufgaben aus.
• erfolgreich – der Build ist abgeschlossen und erfolgreich.
• fehlgeschlagen – der Build wurde abgeschlossen, ist aber fehlgeschlagen. Sie können probleme beheben, indem Sie das Buildprotokoll herunterladen und prüfen.
• abgebrochen – der Build wurde von einer Benutzeraktion abgebrochen, oder es ist timeout.

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. Die App (.apk)

Die .apk Datei ist eine gepackte Android-Anwendung, die die Android-App speichert. Wenn der Build ordnungsgemäß signiert wurde, kann die App auf einem echten Gerät installiert und im Play Store bereitgestellt werden. Wenn der Build nicht signiert wurde, kann die App auf einem Emulator ausgeführt oder zu anderen Zwecken verwendet werden.

5. Unterstützte Versionen und Anforderungen

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

6. Tipps zum Erstellen

6.1. Yarn

Der Yarn-Paket-Manager ist ein schnellerer, deterministischerer Ersatz für npm. Wenn eine yarn.lock Datei im Repository neben package.jsondem Repository vorhanden ist, verwendet App Center Yarn zu yarn install Beginn des Builds. Andernfalls geschieht npm installdies.

6.2. Benutzerdefinierte Buildskripts

Es gibt mehrere Optionen zum Ausführen von Skripts, bevor die Standardmäßigen Buildbefehle von App Center ausgeführt werden.

• Erstellen Sie ein Postinstallskript in der Datei Ihres Projekts package.json . Dieses Skript wird automatisch ausgeführt, nachdem Ihre Abhängigkeiten installiert wurden.

    "scripts": {
      ...
      "postinstall" : "npx jetify" // other examples: "node ./postinstall.js" or "./postinstall.sh"
    },
  

• Schreiben Sie ein Shellskript mithilfe der Benutzerdefinierten Buildskripts-Funktionalität von App Center.

  #!/usr/bin/env bash
  
  # Example: Authenticate with private NPM registry
  echo "//registry.npmjs.org/:_authToken=$NPM_AUTH_TOKEN" > ~/.npmrc
  
  # Example: Add your signing key file (from base64 encoded environment variable)
  base64 -d <<< "$ANDROID_JSON_KEY_FILE" > android/keystores/json_key_file.json
  

6.3. Erstellen mehrerer APKs

Für React Native unter Android ist die universelle APK-Generation standardmäßig deaktiviert. Wenn Ihre App-Konfiguration zum Erstellen mehrerer APKs eingerichtet ist, z. B. unterschiedliche apKs pro CPU-Architektur oder Bildschirmkonfiguration, müssen Sie sicherstellen, dass auch eine universelle APK erstellt wird. Das Buildsystem von App Center funktioniert mit einer HAUPT-APK-Datei und ignoriert alle APKs, die für eine bestimmte CPU/ABI oder Bildschirmdichte spezifisch sind.

Weitere Informationen zu APK-Splits und zum Erstellen einer universellen APK finden Sie im entsprechenden Android-Entwicklerhandbuch. Stellen Sie daher sicher, dass sie universalApk für Ihre React Native-Buildkonfiguration festgelegt true ist.