Partager via

Exporter la configuration de build App Center vers Azure Pipelines

  • Article

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Vue d’ensemble

Avec App Center, vous pouvez exporter toutes vos configurations de build App Center vers Azure Pipelines à l’aide de la fonctionnalité d’exportation de build. Vous pouvez télécharger un fichier JSON ou YAML et l’importer dans Azure Pipelines.

Bien que la migration directe des configurations de build App Center vers Azure Pipelines soit l’option la plus simple, elle peut ne pas être bien optimisée pour votre application particulière. Envisagez de créer Azure Pipelines à partir de zéro pour une expérience plus optimisée (Android, Xcode, Xamarin)

Prérequis

Vous aurez besoin d’un projet Azure DevOps dans lequel vous allez importer une configuration de build. Vous pouvez créer un projet ou en utiliser un existant.

(Facultatif) Ajouter une connexion de service pour les tâches App Center

Si App Center Test ou App Center Distribute est intégré à votre configuration de build, vous devez créer une connexion de service

  1. Accédez à Paramètres du projet Azure DevOps -> Pipelines -> Connexions de service
  2. Sélectionnez « Nouvelle connexion de service »
  3. Rechercher « Visual Studio App Center » -> Suivant
  4. Créer un jeton d’API, donner un nom à la connexion et l’enregistrer

Exporter à l’aide du fichier JSON

Exportez le fichier JSON à partir de la page Build App Center.

  1. Accédez au portail App Center.
  2. Choisir votre application
  3. Accédez à la section Générer, choisissez votre branche, puis sélectionnez Exporter Cliquez sur Exporter
  4. Sélectionnez « Télécharger », puis choisissez « Télécharger JSON ».

Modifier l’ID de projet dans le fichier JSON

Obtenir l’ID de votre projet Azure DevOps

  1. Accédez à l’URL ci-dessous et copiez l’ID de votre projet
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

ID de projet 2. Collez votre ID de projet dans le project paramètre dans le fichier JSON

Modifier JSON

Créer un pipeline Azure

  1. Accédez à Azure DevOps -> Pipelines -> Importer un pipeline et choisissez Fichier JSON téléchargé Pipeline d’importation
  2. Dans Pipeline la section, choisissez Hosted (Azure Pipelines) sous le Agent Pool paramètre
  3. Choisissez la dernière version de l’agent hébergé par Microsoft macOS sous le Agent Specification paramètre
  4. Dans Get Sources la section , ajoutez une connexion au référentiel de votre application.

(Facultatif) Charger des fichiers de signature et mettre à jour les mots de passe

Si vous utilisez la connexion de code dans vos configurations de build App Center, vous devez charger les fichiers respectifs dans Azure Pipelines à l’aide de la fonctionnalité Fichier sécurisé . En outre, vous devez mettre à jour les variables de mot de passe stockées dans les pipelines

Android

  1. Charger un fichier de magasin de clés dans votre projet Azure DevOps
  2. Mettre à jour keystorePasswordles variables , keyAlias, keyPasswordet keystoreFilename

iOS/macOS

  1. Charger des profils et des certificats d’approvisionnement dans votre projet Azure DevOps
  2. Mettre à jour P12Passwordles variables , P12Filenameet MobileProvisionFilename

Windows (UWP)

  1. Charger un certificat dans votre projet Azure DevOps
  2. Mettez à jour packageCertificatePassword, packageCertificateFileNameet packageCertificateBase64String

Si App Center Distribute ou App Center Test est intégré, vous devez modifier les tâches respectives

  1. Accédez à Azure DevOps -> Pipelines
  2. Sélectionnez vos pipelines importés, puis sélectionnez Modifier.
  3. Rechercher les tâches App Center et choisir la connexion de service créée précédemment dans le paramètre « Connexion de service App Center » Connexion au service

Exporter à l’aide du fichier YAML

Exportez le fichier YAML à partir de la page Build App Center.

  1. Accédez au portail App Center.
  2. Choisir votre application
  3. Accédez à la section Générer, choisissez votre branche, puis sélectionnez Exporter Cliquez sur Exporter
  4. Sélectionnez « Télécharger », puis choisissez « Télécharger YAML ».

Configurer votre dépôt pour qu’il fonctionne avec Azure Pipelines

  1. Valider le fichier téléchargé azure-pipelines.yml dans le référentiel de votre application
  2. Accédez à Azure DevOps -> Pipelines -> Créer un pipeline
  3. Choisir l’emplacement de votre code
  4. Passez en revue votre pipeline et sélectionnez Run

Vous trouverez plus d’informations sur le processus de création de pipeline YAML ici.

(Facultatif) Charger des fichiers de signature et mettre à jour les mots de passe

Si vous utilisez la connexion de code dans vos configurations de build App Center, vous devez charger les fichiers respectifs dans Azure Pipelines à l’aide de la fonctionnalité Fichier sécurisé . En outre, vous devez mettre à jour les variables de mot de passe stockées dans les pipelines

Android

  1. Charger un fichier de magasin de clés dans votre projet Azure DevOps
  2. Créer des keystorePasswordvariables secrètes , keyAlias, keyPasswordet keystoreFilename dans Azure Pipelines
  3. Mettre à jour le fichier YAML avec les variables secrètes créées
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. Charger des profils et des certificats d’approvisionnement dans votre projet Azure DevOps
  2. Créer des P12Passwordvariables secrètes , P12Filenameet MobileProvisionFilename dans Azure Pipelines
  3. Mettre à jour le fichier YAML avec les variables secrètes créées
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Charger un certificat dans votre projet Azure DevOps
  2. Créer des packageCertificatePasswordvariables secrètes , packageCertificateFileNameet packageCertificateBase64String dans Azure Pipelines
  3. Mettre à jour le fichier YAML avec les variables secrètes créées
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Facultatif) Autoriser le pipeline nouvellement créé à utiliser la connexion de service App Center

Si app Center Distribute ou Test est intégré, vous devez autoriser les pipelines à utiliser la connexion de service.

  1. Ouvrez le travail en cours d’exécution. Vous verrez un message concernant les autorisations.
  2. Sélectionnez le travail en cours d’exécution et Permit l’accès à l’autorisation de connexion de service