Share via

Mengekspor konfigurasi App Center Build ke Azure Pipelines

  • Artikel

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Gambaran Umum

Dengan App Center, Anda dapat mengekspor semua konfigurasi App Center Build ke Azure Pipelines menggunakan fitur Ekspor build. Anda dapat mengunduh file JSON atau YAML dan mengimpornya ke Azure Pipelines.

Meskipun migrasi langsung konfigurasi App Center Build ke Azure Pipelines adalah opsi termampu, migrasi tersebut mungkin tidak dioptimalkan dengan baik untuk aplikasi tertentu Anda. Pertimbangkan untuk membangun Azure Pipelines dari awal untuk pengalaman yang lebih optimal (Android, Xcode, Xamarin)

Prasyarat

Anda memerlukan proyek Azure DevOps tempat Anda akan mengimpor konfigurasi Build. Anda dapat membuat proyek baru atau menggunakan proyek yang sudah ada.

(Opsional) Menambahkan Koneksi Layanan untuk Tugas Pusat Aplikasi

Jika Anda memiliki App Center Test atau App Center Distribute yang terintegrasi ke dalam konfigurasi Build, Anda harus membuat Koneksi Layanan

  1. Navigasi ke Pengaturan Proyek Azure DevOps -> Alur -> Koneksi layanan
  2. Pilih 'Koneksi layanan baru'
  3. Cari 'Visual Studio App Center' -> Berikutnya
  4. Buat token API, beri nama koneksi dan Simpan

Ekspor menggunakan file JSON

Ekspor file JSON dari halaman Build App Center.

  1. Menavigasi ke portal App Center
  2. Pilih aplikasi Anda
  3. Buka bagian Build, pilih cabang Anda, dan pilih ekspor Klik Ekspor
  4. Pilih 'Unduh' dan pilih 'Unduh JSON'

Mengubah ID Proyek dalam file JSON

Mendapatkan ID proyek Azure DevOps Anda

  1. Buka URL di bawah ini dan salin ID proyek Anda
https://dev.azure.com/{organization}/_apis/projects?api-version=6.0

ID Proyek 2. Tempelkan ID proyek Anda ke project dalam parameter dalam file JSON

Edit JSON

Membuat Azure Pipeline

  1. Navigasi ke Azure DevOps -> Alur -> Impor Alur dan pilih Alur Impor file JSON yang diunduh
  2. Di Pipeline bagian , pilih Hosted (Azure Pipelines) di Agent Pool bawah parameter
  3. Pilih agen macOS terbaru yang dihosting Microsoft di bawah Agent Specification parameter
  4. Di Get Sources bagian , tambahkan koneksi ke repositori aplikasi Anda

(Opsional) Mengunggah file penandatanganan dan memperbarui kata sandi

Jika Anda menggunakan penandatanganan kode di konfigurasi App Center Build, Anda harus mengunggah file masing-masing ke Azure Pipelines menggunakan fitur File aman . Selain itu, Anda perlu memperbarui variabel kata sandi yang disimpan dalam alur

Android

  1. Mengunggah file keystore ke proyek Azure DevOps Anda
  2. Memperbarui keystorePasswordvariabel , keyAlias, keyPassword, dan keystoreFilename

iOS/macOS

  1. Mengunggah profil dan sertifikat provisi ke proyek Azure DevOps Anda
  2. Memperbarui P12Passwordvariabel , P12Filename, dan MobileProvisionFilename

Windows (UWP)

  1. Mengunggah sertifikat ke proyek Azure DevOps Anda
  2. Perbarui packageCertificatePassword, packageCertificateFileName, dan packageCertificateBase64String

Jika Anda memiliki App Center Distribute atau App Center Test terintegrasi, Anda harus memodifikasi tugas masing-masing

  1. Menavigasi ke Azure DevOps -> Alur
  2. Pilih alur yang Anda impor dan pilih Edit
  3. Temukan tugas App Center dan pilih koneksi layanan yang dibuat sebelumnya di parameter 'Koneksi Layanan layanan App Center'

Ekspor menggunakan file YAML

Ekspor file YAML dari halaman Build App Center.

  1. Menavigasi ke portal App Center
  2. Pilih aplikasi Anda
  3. Buka bagian Build, pilih cabang Anda, dan pilih ekspor Klik Ekspor
  4. Pilih 'Unduh' dan pilih 'Unduh YAML'

Mengonfigurasi repositori Anda agar berfungsi dengan Azure Pipelines

  1. Menerapkan file yang diunduh azure-pipelines.yml ke repositori aplikasi Anda
  2. Menavigasi ke Azure DevOps -> Alur -> Buat Alur
  3. Pilih lokasi kode Anda
  4. Tinjau alur Anda dan pilih Run

Informasi lebih lanjut mengenai proses pembuatan alur YAML dapat ditemukan di sini.

(Opsional) Mengunggah file penandatanganan dan memperbarui kata sandi

Jika Anda menggunakan penandatanganan kode di konfigurasi App Center Build, Anda harus mengunggah file masing-masing ke Azure Pipelines menggunakan fitur File aman . Selain itu, Anda perlu memperbarui variabel kata sandi yang disimpan dalam alur

Android

  1. Mengunggah file keystore ke proyek Azure DevOps Anda
  2. Membuat keystorePasswordvariabel rahasia , keyAlias, keyPassword, dan keystoreFilename di Azure Pipelines
  3. Perbarui file YAML dengan variabel rahasia yang dibuat
...
  keystorePassword: $(keystorePassword)
  keyAlias: $(keyAlias)
  keyPassword: $(keyPassword)
  keystoreFilename: $(keystoreFilename)
...

iOS/macOS

  1. Mengunggah profil dan sertifikat provisi ke proyek Azure DevOps Anda
  2. Membuat P12Passwordvariabel rahasia , P12Filename, dan MobileProvisionFilename di Azure Pipelines
  3. Perbarui file YAML dengan variabel rahasia yang dibuat
...
  P12Password: $(P12Password)
  P12Filename: $(P12Filename)
  MobileProvisionFilename: $(MobileProvisionFilename)
...

Windows (UWP)

  1. Mengunggah sertifikat ke proyek Azure DevOps Anda
  2. Membuat packageCertificatePasswordvariabel rahasia , packageCertificateFileName, dan packageCertificateBase64String di Azure Pipelines
  3. Perbarui file YAML dengan variabel rahasia yang dibuat
...
  packageCertificatePassword: $(packageCertificatePassword)
  packageCertificateBase64String: $(packageCertificateFileName)
  packageCertificateFileName: $(packageCertificateBase64String)
...

(Opsional) Mengotorisasi alur yang baru dibuat untuk menggunakan koneksi layanan App Center

Jika Anda memiliki App Center Distribute atau Test terintegrasi, Anda harus mengotorisasi alur untuk menggunakan koneksi layanan.

  1. Buka pekerjaan yang sedang berjalan, Anda akan melihat pesan mengenai izin
  2. Pilih pada pekerjaan yang sedang berjalan dan Permit akses ke Izin koneksi layanan