Baca dalam bahasa Inggris

Bagikan melalui


Membangun aplikasi Objective-C atau Swift untuk macOS

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.

Untuk mulai membangun app Mac pertama Anda, lakukan langkah-langkah berikut:

  1. Sambungkan ke akun layanan repositori Anda (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Pilih repositori dan cabang tempat aplikasi Anda berada.
  3. Konfigurasikan proyek atau ruang kerja build, dan skema yang ingin Anda bangun.

Catatan

Agar aplikasi didistribusikan, build perlu ditandatangani kode dengan sertifikat. Profil provisi bersifat opsional. Selain itu, build untuk Penginstal Mac saat ini tidak didukung.

1. Menautkan repositori Anda

Anda harus tersambung ke akun layanan repositori Anda. Setelah akun Anda tersambung, pilih repositori tempat proyek Mac Anda berada. Untuk menyiapkan build untuk repositori, Anda memerlukan admin dan menarik izin untuk repositori tersebut.

2. Memilih cabang

Setelah memilih repositori, pilih cabang yang ingin Anda bangun. Secara default, semua cabang aktif akan dicantumkan.

3. Menyiapkan build pertama Anda

Sebelum build pertama Anda, proyek Mac perlu dikonfigurasi.

3.1. Proyek/ruang kerja dan skema

Untuk konfigurasi build, diperlukan proyek Xcode atau ruang kerja Xcode dan skema bersama. App Center secara otomatis mendeteksi proyek, ruang kerja, dan skema bersama di cabang Anda. Pilih proyek atau ruang kerja yang ingin Anda bangun dan skema yang sesuai.

Jika tidak ada skema yang dapat ditemukan, konfirmasikan skema yang ingin Anda buat dibagikan, dan kontainer untuk skema adalah proyek atau ruang kerja yang Anda pilih. Pastikan juga perubahan ini diperiksa ke cabang tempat Anda menyiapkan build.

Menandai skema sebagai berbagi

3.2. Versi Xcode

Pilih versi Xcode untuk menjalankan build.

3.3. Membangun pemicu

Secara default, build baru dipicu setiap kali pengembang mendorong ke cabang yang dikonfigurasi. Ini disebut sebagai "Integrasi Berkelanjutan". Jika Anda lebih suka memicu build baru secara manual, Anda dapat mengubah pengaturan ini dalam konfigurasi build.

3.4. Nomor build kenaikan

Saat diaktifkan, CFBundleVersion di Info.plist aplikasi Anda secara otomatis meningkat untuk setiap build. Perubahan terjadi pra-build dan tidak akan diterapkan pada repositori Anda.

3.5. Pengujian

Jika skema yang dipilih memiliki tindakan pengujian dengan target pengujian yang dipilih, Anda dapat mengonfigurasi pengujian untuk dijalankan sebagai bagian dari setiap build. App Center saat ini dapat menjalankan pengujian unit XCTest. App Center tidak mendukung pengujian peluncuran untuk build Mac.

3.6. Penandatanganan kode

Build yang .app berhasil akan menghasilkan file. Untuk menginstal build pada perangkat, perlu ditandatangani sertifikat. Untuk menandatangani build yang dihasilkan dari cabang, aktifkan penandatanganan kode di panel konfigurasi dan unggah sertifikat yang valid (.p12), bersama dengan kata sandi untuk sertifikat. Pengaturan dalam proyek Xcode Anda harus kompatibel dengan file yang Anda unggah. Profil provisi bersifat opsional untuk penandatanganan kode.

Saat ini, App Center hanya mendukung konfigurasi penandatanganan ini:

  • Penandatanganan manual menggunakan metode ekspor Pengembangan dengan sertifikat pengembangan saja
  • Penandatanganan manual menggunakan metode ekspor ID Pengembang
  • Penandatanganan otomatis menggunakan metode ekspor Pengembangan

Anda dapat membaca selengkapnya tentang penandatanganan kode di panduan penandatanganan kode macOS App Center dan di panduan resmi Apple Developer.

3.7. CocoaPods

App Center memindai cabang yang dipilih dan jika menemukan Podfile, App Center akan secara otomatis melakukan pod install langkah di awal setiap build. Ini memastikan bahwa semua dependensi diinstal.

Jika repositori sudah berisi folder /Pods , App Center mengasumsikan Anda telah memeriksa pod di repositori Anda dan tidak akan lagi berjalan pod install.

3.8. Mendistribusikan ke grup distribusi

Anda dapat mengonfigurasi setiap build yang berhasil ditandatangani dari cabang untuk didistribusikan ke grup distribusi yang dibuat sebelumnya. Anda dapat menambahkan grup distribusi baru dari dalam bagian Distribusikan. Selalu ada grup distribusi default yang disebut "Kolaborator" yang mencakup semua pengguna yang memiliki akses ke aplikasi.

Setelah Anda menyimpan konfigurasi, build baru akan dimulai secara otomatis.

4. Hasil build

Setelah build dipicu, build dapat berada di status berikut:

  • diantrekan - build diantrekan, menunggu sumber daya gratis.
  • building - build menjalankan tugas yang telah ditentukan sebelumnya.
  • berhasil - build berhasil diselesaikan.
  • gagal - build menemukan kegagalan yang mencegahnya selesai. Anda dapat memecahkan masalah build dengan mengunduh dan memeriksa log build.
  • dibatalkan - build dibatalkan oleh tindakan pengguna atau waktunya habis.

4.1. Log build

Untuk build yang telah selesai (berhasil atau gagal), unduh log untuk memahami lebih lanjut tentang cara build berjalan. App Center menyediakan arsip dengan file berikut:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Log khusus langkah build (terletak di build direktori arsip) sangat membantu untuk pemecahan masalah dan pemahaman dalam langkah apa dan mengapa build gagal.

4.2. Aplikasi (.app)

File .app adalah file arsip aplikasi Mac, yang berisi app Mac.

  • Jika build ditandatangani dengan benar, .app file dapat diinstal pada perangkat yang sesuai dengan profil provisi yang digunakan saat menandatangani. Detail selengkapnya tentang penandatanganan dan distribusi kode dengan App Center dapat ditemukan di dokumentasi penandatanganan kode macOS App Center.
  • Jika build belum ditandatangani, .app file dapat ditandatangani oleh pengembang. Misalnya, menggunakan codesign.

4.3. File simbol (.dsym)

File .dsym berisi simbol debug untuk aplikasi.

  • Jika Anda telah menambahkan App Center SDK di aplikasi dengan modul pelaporan crash diaktifkan, layanan pelaporan crash memerlukan file ini .dsym agar build menampilkan laporan crash yang dapat dibaca manusia (simbolis).
  • Jika Anda telah menambahkan SDK lain untuk pelaporan crash di aplikasi Anda, seperti HockeyApp SDK, layanan ini memerlukan .dsym file untuk menampilkan laporan crash yang dapat dibaca manusia.

File .dsym tidak berubah saat kode menandatangani .app. Jika Anda memutuskan untuk menandatangani kode build nanti, build .dsym yang dihasilkan sebelum penandatanganan kode masih valid.

Membangun internal

Untuk membangun proyek Anda, kami menggunakan xcodebuild, alat baris perintah yang memungkinkan Anda membuat, mengkueri, menganalisis, menguji, dan mengarsipkan proyek dan ruang kerja Xcode Anda.

Versi dan persyaratan yang didukung

Detail versi komputer build diperbarui setiap kali versi baru macOS ditambahkan. Kami menyertakan versi terbaru yang dirilis oleh Apple sesegera mungkin pada VM build kami.