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 es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Überblick

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

Obwohl die direkte Migration von App Center Build-Konfigurationen 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 neu zu erstellen, um eine optimierte Umgebung zu erzielen (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 von Dienstverbindung für App Center-Aufgaben

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

  1. Navigieren Sie zu Azure DevOps-Projekteinstellungen –> Pipelines –> Dienstverbindungen.
  2. Wählen Sie "Neue Dienstverbindung" aus.
  3. Suchen Nach "Visual Studio App Center" –> Weiter
  4. Erstellen sie ein API-Token, geben Sie der Verbindung einen Namen, und speichern Sie sie.

Exportieren mithilfe der JSON-Datei

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

  1. Navigieren Sie zum App Center-Portal.
  2. Wählen Sie Ihre Anwendung aus
  3. Wechseln Sie zum Abschnitt Erstellen, wählen Sie Ihren Branch aus, und wählen Sie exportieren Klicken Sie auf Exportieren.
  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 folgenden URL, und kopieren Sie die ID Ihres Projekts.
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

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

JSON bearbeiten

Erstellen von Azure Pipeline

  1. Navigieren Sie zu Azure DevOps –> Pipelines –> Importieren einer Pipeline, und wählen Sie heruntergeladene JSON-Datei Pipeline importieren aus.
  2. Pipeline Wählen Sie Hosted (Azure Pipelines) im Abschnitt unter dem Agent Pool Parameter
  3. Wählen Sie unter dem Parameter den neuesten von Microsoft gehostetenAgent Specification macOS-Agent aus.
  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 Build-Konfigurationen verwenden, müssen Sie die entsprechenden Dateien mithilfe der Funktion "Sichere Datei" in 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 keystorePasswordvon Variablen, keyAlias, keyPasswordund keystoreFilename

iOS/macOS

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

Windows (UWP)

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

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

  1. Navigieren Sie zu Azure DevOps –> Pipelines.
  2. Wählen Sie Ihre importierten Pipelines aus, und wählen Sie Bearbeiten aus.
  3. Suchen Sie nach App Center-Aufgaben, und wählen Sie im Parameter "App Center Service Connection" service connection (App Center Service Connection) eine zuvor erstellte Dienstverbindung aus.

Exportieren mithilfe der YAML-Datei

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

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

Konfigurieren Ihres Repositorys für die Arbeit mit Azure Pipelines

  1. Commit der heruntergeladenen azure-pipelines.yml Datei in das Repository Ihrer Anwendung
  2. Navigieren Sie zu Azure DevOps –> Pipelines –> Erstellen von Pipelines.
  3. Wählen Sie den Speicherort Ihres Codes aus.
  4. Überprüfen Sie Ihre Pipeline, und wählen Sie Run

Weitere Informationen zum Erstellungsprozess der YAML-Pipeline finden Sie hier.

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

Wenn Sie die Codesignatur in Ihren App Center Build-Konfigurationen verwenden, müssen Sie die entsprechenden Dateien mithilfe der Funktion "Sichere Datei" in 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 von keystorePassword, keyAlias, keyPasswordund keystoreFilenamegeheimen Variablen in Azure Pipelines
  3. Aktualisieren der YAML-Datei mit den erstellten Geheimnisvariablen
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

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

Windows (UWP)

  1. Hochladen eines Zertifikats in Ihr Azure DevOps-Projekt
  2. Erstellen von packageCertificatePassword, packageCertificateFileNameund packageCertificateBase64Stringgeheimen Variablen in Azure Pipelines
  3. Aktualisieren der YAML-Datei mit den erstellten Geheimnisvariablen
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Optional) Autorisieren einer neu erstellten Pipeline für die Verwendung der App Center Service-Verbindung

Wenn Sie App Center Distributed oder Test integriert haben, müssen Sie Pipelines autorisieren, um die Dienstverbindung zu verwenden.

  1. Öffnen Sie den aktuell ausgeführten Auftrag, und Es wird eine Meldung zu Den Berechtigungen angezeigt.
  2. Wählen Sie den ausgeführten Auftrag und Permit den Zugriff auf die Dienstverbindung Zulassen aus.