Membangun aplikasi Objective-C atau Swift untuk iOS
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 membuat aplikasi iOS asli pertama, Anda harus mengambil tindakan berikut:
- Menyambungkan ke akun layanan repositori Anda (GitHub, Bitbucket, VSTS, Azure DevOps)
- Pilih repositori dan cabang tempat aplikasi Anda berada
- Konfigurasikan proyek atau ruang kerja build, dan skema yang ingin Anda bangun
Catatan
Untuk menjalankan aplikasi pada perangkat nyata, build harus ditandatangani kode dengan profil provisi yang valid dan sertifikat.
1. Menautkan repositori Anda
Jika sebelumnya Anda belum tersambung ke akun layanan repositori, Anda harus mengotorisasi koneksi. Setelah akun Anda tersambung, pilih repositori tempat proyek iOS Anda berada. App Center mengharuskan akun Anda memiliki izin Admin dan Pull untuk menyiapkan build untuk repositori.
2. Memilih cabang
Setelah memilih repositori, pilih cabang yang ingin Anda bangun. Secara default, semua cabang aktif akan dicantumkan.
3. Menyiapkan build pertama Anda
Konfigurasikan proyek iOS Anda sebelum build pertama Anda.
3.1 Proyek/ruang kerja dan skema
Untuk konfigurasi build, proyek Xcode atau ruang kerja Xcode, dan skema bersama diperlukan. App Center secara otomatis mendeteksi proyek, ruang kerja, dan skema bersama (selama skema berada di folder yang benar) di cabang Anda. Pilih proyek atau ruang kerja yang ingin Anda bangun dan skema yang sesuai.
Jika tidak ada skema yang ditemukan, pastikan skema yang Anda inginkan dibagikan dan kontainernya adalah proyek atau ruang kerja yang Anda pilih. Anda juga harus mengonfirmasi bahwa perubahan tersebut diperiksa ke cabang yang Anda konfigurasi.
Perlu diingat bahwa Anda tidak dapat mengekspor .xcscheme
file dan menempatkannya di mana saja dalam proyek. Ini harus ada di xcshareddata/xcschemes/
folder . Pastikan jalur ini tidak ada dalam file Anda .gitignore
.
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. Proses 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.
Catatan
Untuk membuat nomor build Increment berfungsi, beri nama .plist file
seperti *Info.plist
Production-Info.plist
.
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.
3.6. Penandatanganan kode
Membangun aplikasi iOS untuk perangkat nyata memerlukan penandatanganan dengan kredensial yang valid. Untuk menandatangani build di App Center, aktifkan penandatanganan kode di panel konfigurasi dan unggah profil provisi (.mobileprovision
) dan sertifikat yang valid (.p12
), bersama dengan kata sandi untuk sertifikat.
Pengaturan dalam proyek Xcode Anda harus kompatibel dengan file yang Anda unggah. Anda dapat membaca selengkapnya tentang penandatanganan kode di dokumentasi resmi Apple Developer.
Aplikasi dengan ekstensi aplikasi atau watchOS memerlukan profil provisi tambahan per ekstensi untuk ditandatangani.
3.7. Luncurkan build sukses Anda pada perangkat nyata
Gunakan file yang baru diproduksi .ipa
untuk menguji apakah aplikasi Anda dimulai di perangkat nyata. Peluncuran pada perangkat nyata akan menambahkan sekitar 10 menit lagi ke total waktu build. Baca selengkapnya tentang cara mengonfigurasi pengujian peluncuran.
3.8. CocoaPods
App Center memindai cabang yang dipilih dan jika menemukan Podfile, App Center akan secara otomatis melakukan pod install
langkah di awal setiap build. Langkah ini akan memastikan bahwa semua dependensi diinstal.
Peringatan
Jika repositori sudah berisi folder /Pods , App Center mengasumsikan Anda telah memeriksa pod di repositori Anda dan tidak akan lagi melakukan pod install
. Jika Anda menghapus atau memodifikasi folder /Pod , Anda mungkin harus menyimpan ulang konfigurasi Build secara manual menggunakan Save
atau Save and Build
agar pembaruan diterapkan.
3.9. Mendistribusikan ke grup distribusi
Anda dapat mengonfigurasi setiap build yang berhasil 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:
- antrean - build diantrekan menunggu sumber daya dibebaskan.
- building - build menjalankan tugas yang telah ditentukan sebelumnya.
- berhasil - build selesai dan berhasil.
- gagal - build selesai tetapi gagal. Anda dapat memecahkan masalah apa yang salah dengan 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 (.ipa)
File .ipa
adalah file arsip aplikasi perangkat iOS yang berisi aplikasi iOS.
- Build yang tidak ditandatangani tidak akan menghasilkan
.ipa
file. Artefak build yang tidak ditandatangani adalah.xcarchive
file yang dapat digunakan untuk menghasilkan.ipa
file dengan penyelenggara Arsip Xcode. - Jika build ditandatangani dengan benar,
.ipa
file dapat diinstal pada perangkat nyata 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 iOS App Center. - Jika build belum ditandatangani,
.ipa
file dapat ditandatangani oleh pengembang (misalnya, secara lokal menggunakan codesign) atau digunakan untuk tujuan lain (misalnya, unggah ke layanan Uji untuk pengujian UI pada perangkat nyata atau dijalankan di simulator).
4.3. File simbol (.dsym)
File .dsym
berisi simbol debug untuk aplikasi.
- Jika sebelumnya Anda telah mengintegrasikan App Center SDK di aplikasi Anda dengan modul pelaporan crash diaktifkan, layanan pelaporan crash mengharuskan file ini
.dsym
untuk build menampilkan laporan crash yang dapat dibaca manusia (simbolis). - Jika sebelumnya Anda telah mengintegrasikan SDK lain untuk tujuan pelaporan crash di aplikasi Anda (misalnya, HockeyApp SDK), layanan yang sesuai memerlukan
.dsym
file untuk menampilkan laporan crash yang dapat dibaca manusia.
Perlu diingat bahwa .dsym
file tidak berubah saat kode menandatangani .ipa
. Jika Anda memutuskan untuk menandatangani kode build nanti, yang .dsym
dihasilkan sebelum penandatanganan kode masih valid.
Versi dan persyaratan yang didukung
Detail versi Xcode mesin build diperbarui setiap kali versi baru Xcode ditambahkan. Kami mengawasi versi terbaru yang dirilis oleh Apple dan menyertakannya sesegera mungkin pada VM yang digunakan untuk menjalankan build.