App Store und TestFlight-Verteilung

Wichtig

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

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Veröffentlichen Sie iOS-App-Upgrades für die App Store und TestFlight mit Fastlane in App Center.

Voraussetzungen

  • Die erste Version einer iOS-Anwendung muss über das App Store Connect-Portal veröffentlicht werden.
  • Kompilieren Sie die App mithilfe eines App Store Bereitstellungsprofils und eines Produktionszertifikats.
  • Die App sollte für die Übermittlung bereit sein und die richtlinien für die App Store erfüllen.
  • Ein aktives Apple Developer Program-Konto, oder lassen Sie Ihre Apple-ID als Administrator im App Store Connect-Konto Ihres Teams hinzufügen.
  • Das verbundene Konto muss über App-Manager-Berechtigungen verfügen, um eine App zu veröffentlichen.

Weitere Informationen finden Sie im Apple App-Verteilungshandbuch.

Einrichten der Verbindung zwischen App Center und App Store Connect

Hinweis

Sie können eine Verbindung mit App Store Connect herstellen, indem Sie entweder Ihre Apple-Anmeldeinformationen oder einen App Store Connect-API-Schlüssel verwenden. Es wird empfohlen, den Connect-API-Schlüssel zu verwenden, um die Stabilität zu verbessern und Zugriffsebenen für die Schlüssel im Apple Developer Portal festzulegen. Darüber hinaus müssen Sie Ihre Verbindung nicht mehr alle 30 Tage verlängern, wie Sie dies mit Anmeldeinformationen, 2FA und App-spezifischen Kennwörtern machen würden.

  1. Wählen Sie unter Verteilung die Option Stores aus.

  2. Klicken Sie in der Mitte der Seite auf die Schaltfläche Mit Store verbinden .

  3. Wählen Sie im daraufhin geöffneten Bereich den Speichertyp App Store Verbinden aus.

  4. Klicken Sie in der unteren rechten Ecke auf Weiter .

  5. Melden Sie sich mit Ihrem App Store Connect-API-Schlüssel oder mit Ihrem Apple-Entwicklerkonto (eine einmalige Aktivität) an, und klicken Sie auf Verbinden.

  6. Wenn das Apple-Konto Mitglied mehrerer Teams ist, ist bei erfolgreicher Anmeldung eine Option zum Auswählen des Teams verfügbar, das den Builds zugeordnet werden soll. Wenn das Apple-Konto nur Mitglied eines einzelnen Teams ist, ist die Auswahl standardmäßig auf das einzelne verfügbare Konto festgelegt.

  7. Nun steht eine Liste der Apps für das ausgewählte Team zur Auswahl zur Verfügung.

  8. Wählen Sie die App aus, die aktualisiert werden soll.

  9. Store-Verbindungen für die ausgewählte App werden automatisch eingerichtet.

    • Eine App Store Verbindung mit dem Namen Produktion.
    • Eine TestFlight-Verbindung für interne Tester mit dem Namen App Store Connect Users.
    • Externe Tester gruppiert Verbindungen basierend auf den externen Gruppen, die in der App Store Connect-Konsole erstellt wurden.
  10. Das Einrichten dieser Verbindung ist ein einmaliger Prozess für eine App im App Center.

Auswählen des Ziels im Dropdownmenü für Uploadanweisungen

Hinweis

Beim Übermitteln der Übermittlungsdatei an App Store Connect verwendet App Center standardmäßig Folgendes:

 add_id_info_uses_idfa: false
 export_compliance_uses_encryption: false
 export_compliance_encryption_updated: false

Hinzufügen der zweistufigen Authentifizierung

Wenn für Ihr Apple-Konto die zweistufige Authentifizierung aktiviert ist, erfordert App Store Connect ein App-spezifisches Kennwort als Sicherheit. Sie können ein App-spezifisches Kennwort unter Kontoeinstellungen > Entwicklerkonten hinzufügen.

Tipp

Nur App Store und TestFlight erfordern ein app-spezifisches Kennwort. Nur Apple-IDs mit aktivierter zweistufiger Authentifizierung können App-spezifisches Kennwort aktualisieren auswählen.

  1. Zeigen Sie auf ein Element in der Liste Konten .
  2. Klicken Sie rechts in der Liste auf die drei vertikalen Punkte.
  3. Wählen Sie App-spezifisches Kennwort aktualisieren aus.
  4. Generieren Sie ein App-spezifisches Kennwort über das Apple-ID-Portal.
    • Mit dem Namen können Sie sich merken, welcher Dienst oder welche App das app-spezifische Kennwort verwendet.
  5. Kopieren Sie das generierte App-spezifische Kennwort, und fügen Sie es in den Dialog ein.
  6. Speichern Sie, indem Sie auf Aktualisieren klicken.

Veröffentlichen über die CLI

Warnung

Sie benötigen app Center CLI 2.7 oder höher, um dieses Feature verwenden zu können.

Verwenden Sie die CLI als einfache Möglichkeit, die Store-Verbindung des App Center als Teil Ihres CI/CD-Setups zu integrieren, z. B. Jenkins oder Go CI.

Sie müssen eine Verbindung mit dem App Store herstellen, bevor Sie die CLI verwenden und eine kompatible Binärdatei kompilieren können.

Sie können Ihre Filialen auflisten, indem Sie den Befehl list wie folgt verwenden:

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

Sie erhalten ein Ergebnis wie das folgende:

[["Production","apple","production"],["App Store Connect Users","apple","testflight-internal"]]

Und es ist die Store-Spalte, die wir im letzten Schritt verwenden werden.

Der letzte Schritt besteht darin, Ihre App zu veröffentlichen, indem Sie Folgendes ausführen:

appcenter distribute stores publish \
--file /path/to/file.ipa \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

Sie müssen die Leerzeichen wie den Listenbefehl ausfüllen. Anstelle einer statischen Releasenotiz ist es möglich, stattdessen die --release-notes-file zu verwenden. Eine Versionshinweisedatei ist eine Nur-Text-Datei, die mit UTF-8 codiert ist.

Warum erfordert die Apple-ID die Administratorrolle?

Apple benötigt mindestens eine Administratorrolle, um Apps zu erstellen und Versionen zu übermitteln und Builds hochzuladen. Weitere Informationen finden Sie in dieser Tabelle, in der die Berechtigungen erläutert werden.

Debuggen eines fehlerhaften Release

Wenn die Veröffentlichung eines Release fehlschlägt, können Sie die ausführlichen Fastlane-Protokolle herunterladen. Diese Protokolle finden Sie auf der ausführlichen Releaseseite, indem Sie auf Status > Fastlane-Protokolle herunterladen klicken.

Fehler beim erneuten Authentifizieren

In der seltenen Gelegenheit, bei der die erneute Authentifizierung fehlschlägt, können Sie das Problem beheben, indem Sie die Abschnitte Kontoeinstellungen besuchen und Ihre Apple-ID entfernen. Besuchen Sie dann die Store-Verbindungsseite der App, und wählen Sie Ihre Verbindung aus, um die Verbindung herzustellen.