Esportare la configurazione di compilazione di App Center in Azure Pipelines

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Panoramica

Con App Center è possibile esportare tutte le configurazioni di compilazione di App Center in Azure Pipelines usando la funzionalità Di esportazione di compilazione. È possibile scaricare il file JSON o YAML e importarlo in Azure Pipelines.

Anche se la migrazione diretta delle configurazioni di compilazione di App Center ad Azure Pipelines è l'opzione più semplice, potrebbe non essere ottimizzata per una determinata applicazione. Prendere in considerazione la creazione di Azure Pipelines da zero per un'esperienza più ottimizzata (Android, Xcode, Xamarin)

Prerequisiti

È necessario un progetto Azure DevOps in cui si importerà una configurazione di compilazione. È possibile creare un nuovo progetto o usarne uno esistente.

• Creare un account Azure DevOps
• Creare un'organizzazione di Azure DevOps
• Creare un progetto Azure DevOps

(Facoltativo) Aggiungere una connessione al servizio per le attività di App Center

Se nella configurazione della compilazione è integrato App Center Test o App Center Distribute, è necessario creare una connessione al servizio

1. Passare a Impostazioni progetto DevOps di Azure -> Pipeline -> Connessioni al servizio
2. Selezionare "Nuova connessione al servizio"
3. Cercare "Visual Studio App Center" -> Avanti
4. Creare un token API, assegnare un nome alla connessione e salvarlo

Esportare usando il file JSON

Esportare il file JSON dalla pagina Di compilazione di App Center.

1. Passare al portale di App Center
2. Scegliere l'applicazione
3. Passare alla sezione Compilazione, scegliere il ramo e selezionare
4. Selezionare "Scarica" e scegliere "Scarica JSON"

Modificare l'ID progetto nel file JSON

Ottenere l'ID del progetto Azure DevOps

1. Passare all'URL seguente e copiare l'ID del progetto

https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

2. Incollare l'ID project progetto nel parametro nel file JSON

Creare una pipeline di Azure

1. Passare ad Azure DevOps -> Pipeline -> Importare una pipeline e scegliere la file JSON scaricata
2. Nella Pipeline sezione scegliere Hosted (Azure Pipelines) sotto il Agent Pool parametro
3. Scegliere l'agente ospitato da Microsoft macOS più recente nel Agent Specification parametro
4. Nella Get Sources sezione aggiungere una connessione al repository dell'applicazione

(Facoltativo) Caricare i file di firma e aggiornare le password

Se si usa la firma del codice nelle configurazioni di compilazione di App Center, sarà necessario caricare i rispettivi file in Azure Pipelines usando la funzionalità Secure file (Secure file ). Inoltre, è necessario aggiornare le variabili password archiviate nelle pipeline

Android

1. Caricare un file dell'archivio chiavi nel progetto Azure DevOps
2. Aggiornare keystorePasswordle variabili , keyAliaskeyPassword, e keystoreFilename

iOS/macOS

1. Caricare profili e certificati di provisioning nel progetto Azure DevOps
2. Aggiornare P12Passwordle variabili , P12Filenamee MobileProvisionFilename

Windows (UWP)

1. Caricare un certificato nel progetto Azure DevOps
2. Aggiornare packageCertificatePassword, packageCertificateFileNamee packageCertificateBase64String

(Facoltativo) Aggiungere una connessione al servizio alle attività correlate ad App Center

Se è integrato App Center Distribute o App Center Test, è necessario modificare le rispettive attività

1. Passare ad Azure DevOps -> Pipeline
2. Selezionare le pipeline importate e selezionare Modifica
3. Trovare le attività di App Center e scegliere la connessione al servizio creata in precedenza nel parametro " al servizio App Center"

Esportare usando il file YAML

Esportare il file YAML dalla pagina Di compilazione di App Center.

1. Passare al portale di App Center
2. Scegliere l'applicazione
3. Passare alla sezione Compilazione, scegliere il ramo e selezionare
4. Selezionare "Scarica" e scegliere "Scarica YAML"

Configurare il repository per l'uso con Azure Pipelines

1. Eseguire il commit del file scaricato azure-pipelines.yml nel repository dell'applicazione
2. Passare ad Azure DevOps -> Pipeline -> Crea pipeline
3. Scegliere dove si trova il codice
4. Esaminare la pipeline e selezionare Run

Altre informazioni sul processo di creazione della pipeline YAML sono disponibili qui.

(Facoltativo) Caricare i file di firma e aggiornare le password

Se si usa la firma del codice nelle configurazioni di compilazione di App Center, sarà necessario caricare i rispettivi file in Azure Pipelines usando la funzionalità Secure file (Secure file ). Inoltre, è necessario aggiornare le variabili password archiviate nelle pipeline

Android

1. Caricare un file dell'archivio chiavi nel progetto Azure DevOps
2. Creare keystorePasswordvariabili segrete , keyAlias, keyPassworde keystoreFilename in Azure Pipelines
3. Aggiornare il file YAML con le variabili segrete create

...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

1. Caricare profili e certificati di provisioning nel progetto Azure DevOps
2. Creare P12Passwordvariabili segrete , P12Filenamee MobileProvisionFilename in Azure Pipelines
3. Aggiornare il file YAML con le variabili segrete create

...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

1. Caricare un certificato nel progetto Azure DevOps
2. Creare packageCertificatePasswordvariabili segrete , packageCertificateFileNamee packageCertificateBase64String in Azure Pipelines
3. Aggiornare il file YAML con le variabili segrete create

...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Facoltativo) Autorizzare la pipeline appena creata per l'uso della connessione al servizio App Center

Se è integrato App Center Distribute o Test, è necessario autorizzare le pipeline a usare la connessione al servizio.

1. Aprire il processo attualmente in esecuzione. Verrà visualizzato un messaggio relativo alle autorizzazioni
2. Selezionare il processo in esecuzione e Permit l'accesso alla connessione al servizio