Freigeben über

Exportieren der App Center-Buildkonfiguration in Azure-Pipelines

  • Artikel

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.

Übersicht

Mit App Center können Sie alle App Center-Buildkonfigurationen mithilfe des Features "Buildexport" in Azure-Pipelines exportieren. Sie können JSON- oder YAML-Datei herunterladen und in Azure-Pipelines importieren.

Während die direkte Migration von App Center-Buildkonfigurationen zu Azure Pipelines die einfachste Option ist, ist sie möglicherweise nicht gut für Ihre jeweilige Anwendung optimiert. Erwägen Sie, Azure-Pipelines von Grund auf für eine optimierte Oberfläche zu erstellen (Android, Xcode, Xamarin)

Voraussetzungen

Sie benötigen ein Azure DevOps-Projekt, in dem Sie eine Buildkonfiguration importieren. Sie können ein neues Projekt erstellen oder ein vorhandenes Projekt verwenden.

(Optional) Hinzufügen der Dienstverbindung für App Center-Aufgaben

Wenn Sie App Center Test oder App Center Verteilen in Ihre Buildkonfiguration integriert haben, müssen Sie eine Dienstverbindung erstellen.

  1. Navigieren Sie zu den Azure DevOps-Projekteinstellungen –> Pipelines –> Dienstverbindungen
  2. Wählen Sie "Neue Dienstverbindung" aus.
  3. Suchen nach 'Visual Studio App Center' –> Weiter
  4. Erstellen eines API-Tokens, Geben Sie der Verbindung einen Namen, und speichern Sie es.

Exportieren mithilfe der JSON-Datei

Exportieren Sie die JSON-Datei von der Seite "App Center Build".

  1. Navigieren zum App Center-Portal
  2. Wählen Sie Ihre Anwendung aus
  3. Wechseln Sie zum Abschnitt "Erstellen", wählen Sie Ihre Verzweigung aus, und wählen Sie "Exportieren" aus. Klicken Sie auf
  4. Wählen Sie "Herunterladen" und dann "JSON herunterladen" aus.

Ändern der Projekt-ID in der JSON-Datei

Abrufen der ID Ihres Azure DevOps-Projekts

  1. Navigieren Sie zur nachstehenden URL, und kopieren Sie die ID Ihres Projekts.
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

Projektkennung 2. Fügen Sie Ihre Projekt-ID in den project Parameter in der JSON-Datei ein.

JSON bearbeiten

Erstellen einer Azure-Pipeline

  1. Navigieren Sie zu Azure DevOps –> Pipelines –> Importieren einer Pipeline, und wählen Sie heruntergeladene JSON-Datei aus. Pipeline importieren
  2. Pipeline Wählen Sie Hosted (Azure Pipelines) im Abschnitt unter dem Agent Pool Parameter
  3. Wählen Sie den neuesten von Microsoft gehosteten MacOS-Agent unter dem Parameter ausAgent Specification.
  4. Get Sources Fügen Sie im Abschnitt eine Verbindung zum Repository Ihrer Anwendung hinzu.

(Optional) Hochladen von Signaturdateien und Aktualisieren von Kennwörtern

Wenn Sie die Codesignatur in Ihren App Center-Buildkonfigurationen verwenden, müssen Sie die entsprechenden Dateien mithilfe der Funktion "Sichere Datei " in die Azure-Pipelines hochladen. Darüber hinaus müssen Sie Kennwortvariablen aktualisieren, die in Pipelines gespeichert sind.

Android

  1. Hochladen einer Keystoredatei in Ihr Azure DevOps-Projekt
  2. Aktualisieren keystorePassword, , keyAlias, keyPasswordund keystoreFilename Variablen

iOS/macOS

  1. Hochladen von Bereitstellungsprofilen und Zertifikaten in Ihr Azure DevOps-Projekt
  2. Aktualisieren P12Password, P12FilenameUnd MobileProvisionFilename Variablen

Windows (UWP)

  1. Hochladen eines Zertifikats in Ihr Azure DevOps-Projekt
  2. Aktualisieren packageCertificatePassword, , packageCertificateFileNameund packageCertificateBase64String

Wenn App Center Distribute oder App Center Test integriert ist, müssen Sie die jeweiligen Aufgaben ändern.

  1. Navigieren zu Azure DevOps –> Pipelines
  2. Wählen Sie Ihre importierten Pipelines aus, und wählen Sie "Bearbeiten" aus.
  3. Suchen von App Center-Aufgaben und Auswählen einer zuvor erstellten Dienstverbindung im Parameter "App Center-Dienstverbindung" Dienstverbindung

Exportieren mithilfe der YAML-Datei

Exportieren Sie die YAML-Datei von der App Center-Buildseite.

  1. Navigieren zum App Center-Portal
  2. Wählen Sie Ihre Anwendung aus
  3. Wechseln Sie zum Abschnitt "Erstellen", wählen Sie Ihre Verzweigung aus, und wählen Sie "Exportieren" aus. Klicken Sie auf
  4. Wählen Sie "Herunterladen" und dann "YAML herunterladen" aus.

Konfigurieren Ihres Repositorys für die Arbeit mit Azure-Pipelines

  1. Commit für heruntergeladene azure-pipelines.yml Datei in das Repository Ihrer Anwendung
  2. Navigieren Sie zu Azure DevOps –> Pipelines –> Pipeline erstellen
  3. Wählen Sie aus, wo sich Ihr Code befindet.
  4. Überprüfen Sie Ihre Pipeline, und wählen Sie Run

Weitere Informationen zum YAML-Pipelineerstellungsprozess finden Sie hier.

(Optional) Hochladen von Signaturdateien und Aktualisieren von Kennwörtern

Wenn Sie die Codesignatur in Ihren App Center-Buildkonfigurationen verwenden, müssen Sie die entsprechenden Dateien mithilfe der Funktion "Sichere Datei " in die Azure-Pipelines hochladen. Darüber hinaus müssen Sie Kennwortvariablen aktualisieren, die in Pipelines gespeichert sind.

Android

  1. Hochladen einer Keystoredatei in Ihr Azure DevOps-Projekt
  2. Erstellen keystorePassword, , keyAlias, keyPasswordund keystoreFilename geheimen Variablen in Azure Pipelines
  3. Aktualisieren der YAML-Datei mit den erstellten geheimen Variablen
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. Hochladen von Bereitstellungsprofilen und Zertifikaten in Ihr Azure DevOps-Projekt
  2. Erstellen P12Passwordvon Variablen P12Filenameund MobileProvisionFilename geheimen Schlüsseln in Azure-Pipelines
  3. Aktualisieren der YAML-Datei mit den erstellten geheimen Variablen
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Hochladen eines Zertifikats in Ihr Azure DevOps-Projekt
  2. Erstellen packageCertificatePasswordvon Variablen packageCertificateFileNameund packageCertificateBase64String geheimen Schlüsseln in Azure-Pipelines
  3. Aktualisieren der YAML-Datei mit den erstellten geheimen Variablen
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Optional) Autorisieren einer neu erstellten Pipeline zur Verwendung der App Center-Dienstverbindung

Wenn Sie App Center verteilen oder testen integriert haben, müssen Sie Pipelines für die Verwendung der Dienstverbindung autorisieren.

  1. Öffnen Des aktuell ausgeführten Auftrags wird eine Meldung zu Berechtigungen angezeigt.
  2. Wählen Sie den ausgeführten Auftrag aus, und Permit greifen Sie auf die Dienstverbindung zu. -Genehmigung