Pembangunan iOS

Membangun dan mengirimkan aplikasi iOS ke TestFlight dan App Store menggunakan infrastruktur Mac Capgo yang terintegrasi.

Apa yang akan Anda pelajari

• Anda akan belajar cara mengunggah aplikasi melalui Capgo Native build
• Anda akan belajar cara mengkonfigurasi sertifikat untuk Capgo Native Build

Prerequisites

• Sebuah akun Capgo (cukup dengan uji coba gratis untuk memulai)
• Apkamu sudah terdaftar di Capgo (jalankan bunx @capgo/cli@latest app add jika tidak)
• Tidak perlu Mac: Capgo Build mengompilasi dan menandatangani aplikasi iOS di cloud, sehingga kamu bisa menjalankan ini dari macOS, Windows, atau Linux
• Akun Pengembang Apple yang valid (seharga $99/tahun) (Kamu harus memiliki hak admin atau hak pemilik pada akun Pengembang Apple)
• Aplikasi kamu harus dapat dibangun dengan sukses (di Xcode secara lokal, atau dengan Capgo Build)
• Aplikasi Capacitor
• Sebuah ikon yang sudah dikonfigurasi untuk aplikasi. Aplikasi tanpa ikon tidak bisa diunggah ke App Store.

Pertanda

Aplikasi yang akan saya gunakan dalam tutorial ini: https://github.com/Cap-go/capgo-native-build-tutorial-aplikasi

Sebelum Anda memulai di portal Apple

Sebelum Anda mengatur sertifikat atau memicu unggahan TestFlight pertama, pastikan akun dan tim Apple sudah siap.

• Mengaktifkan autentikasi dua faktor untuk akun Apple yang digunakan untuk pendaftaran
• Pilih jenis keanggotaan yang tepat:
  • Individu / Pemilik Usaha Sendiri: Nama pribadi Anda menjadi nama penjual di App Store
  • Organisasi: Memerlukan entitas hukum, nomor D-U-N-S, situs web perusahaan publik, alamat email kerja di domain perusahaan, dan orang dengan otoritas untuk mengikat organisasi ke perjanjian Apple
• Pilih akun yang dapat mengakses baik Apple Developer dan App Store Connect untuk sertifikat, rekaman aplikasi, API kunci, dan TestFlight
• Simpan ID paket akhir Anda sebelumnya. Mengubahnya nanti biasanya berarti melakukan setup App Store ulang
• Persiapkan item App Store Connect ini sebelum Ulasan Aplikasi: URL dukungan, URL kebijakan privasi, klasifikasi usia, tangkapan layar, kinerja ekspor, dan detail kontak Ulasan Aplikasi

Catatan

Referensi resmi berguna:

• Bergabunglah dengan Program Pengembang Apple
• Kirimkan aplikasi dan game Anda
• Informasi versi platform di App Store Connect

Peringatan

Apple updates its minimum SDK requirement regularly. As of 28 April 2026Aplikasi iPhone dan iPad yang diunggah ke App Store Connect harus dibangun dengan iOS dan iPadOS 26 SDK atau lebih baru.

Dianjurkan: pengaturan otomatis

You don’t have to do any of this by hand. Capgo’s onboarding creates and configures your iOS signing credentials (distribution certificate + provisioning profile) for you — this is the recommended path:

bunx @capgo/cli@latest build init --platform ios

The manual walkthrough below is only for those who prefer to set up credentials themselves, or want to understand exactly what Capgo does under the hood.

Jendela terminal

Sebelum kita bisa memulai berpikir tentang membangun aplikasi dengan Capgo, kita harus terlebih dahulu mengatur aplikasi tersebut, dan melakukan pembangunan TestFlight pertama secara manual. Ada beberapa kelebihan melakukan pembangunan manual terlebih dahulu:

• Kamu akan mengatur sertifikat distribusi pada mesin lokal kamu
• Kamu akan membuat catatan App Store jika belum melakukannya sebelumnya
• Anda dapat mengetahui masalah apa pun dengan proses pembangunan yang terkait dengan aplikasi Anda code

Sebelum kita bisa memulai, kamu harus memiliki sertifikat distribusi terinstal pada mesin lokal kamu. Hal ini cukup kompleks, tapi saya akan menjelaskannya di bawah.

Pengaturan Sertifikat Distribusi

1. Buka Xcode

2. Klik pada Xcode -> Settings... Alternatifnya, kamu dapat menggunakan shortcut Cmd + ,

   

3. Pergi ke Accounts

4. Cari Akun Apple yang telah ditambahkan ke Akun Pengembang Apple

5. Cari tim yang akan digunakan untuk menginstal aplikasi

6. Klik pada tombol Manage Certificates... button

7. Pastikan Anda dapat melihat sertifikat distribusi di daftar

8. Jika Anda tidak melakukannya, Anda perlu membuat sertifikat baru

   Catatan

   Apple membatasi jumlah sertifikat distribusi yang dapat Anda miliki hingga 3. Jika Anda memiliki lebih dari 3 sertifikat, Anda perlu menghapus satu untuk dapat membuat sertifikat baru. Saya tidak akan membahas itu dalam tutorial ini.

   1. Klik pada tombol + dan kemudian pada Apple Distribution
   2. Sertifikat akan dibuat secara otomatis. Anda dapat melihatnya di daftar. Periksa langkah sebelumnya untuk memastikan Anda melihatnya.

Sekarang Anda telah menginstal sertifikat distribusi, Anda dapat memulai proses pembangunan.

Pembangunan Manual ke TestFlight

1. Buka aplikasi di Xcode

   Jalankan bunx cap open ios Untuk membuka aplikasi di Xcode.

2. Cari dan klik tombol archive Tombol

   Dalam toolbar Xcode, cari dan klik tombol product -> archive Toolbar Xcode

   

3. Tunggu proses pembangunan selesai

4. Tombol distribusi Xcode Distribute App Tombol

   

5. Select TestFlight Internal Only sebagai metode distribusi dan klik pada Distribute Tombol

   

6. Konfigurasi rekaman aplikasi

   Isi data di bidang berikut:

   1. Nama: Nama aplikasi Anda - terlihat di App Store
   2. SKU - kode SKU aplikasi Anda - kode ini digunakan untuk mengidentifikasi aplikasi Anda di App Store
   3. Bahasa utama - Bahasa utama aplikasi Anda

   Kemudian, klik pada next Tombol

   

7. Jika pembuatan rekaman aplikasi gagal, coba tutup jendela dan coba arsip aplikasi lagi.

8. Tunggu proses unggah selesai

9. Jika semuanya berjalan lancar, Anda seharusnya melihat layar berikut:

10. Klik pada tombol Done Tombol

Anda mungkin secara naluriah berpikir bahwa semuanya baik-baik saja sekarang dan Anda akan dapat melihat aplikasi Anda di TestFlight sekarang, tetapi masih ada beberapa hal yang perlu diselesaikan:

1. Tambahkan diri Anda ke TestFlight
2. Lengkapi kewajiban ekspor untuk membuat build menjadi dapat diuji
3. Isi metadata App Store Connect yang diperlukan seperti URL dukungan, URL kebijakan privasi, dan klasifikasi usia
4. Siapkan screenshot yang sesuai dengan perangkat yang Anda dukung
5. Tambahkan detail kontak App Review dan kredential uji sebelum pengajuan produksi

Marilah kita mulai dengan yang pertama:

Menambahkan diri Anda ke TestFlight

1. Pergi ke halaman App Store Connect halaman

2. Masuk dengan akun Pengembang Apple Anda

3. Pilih tim yang Anda gunakan ketika membuat catatan aplikasi. Jika Anda hanya memiliki satu akun pengembang, Anda dapat melewatkan langkah ini.

4. Klik pada tombol Apps button

5. Temukan aplikasi yang Anda buat di langkah sebelumnya dan klik pada aplikasi tersebut

6. Klik pada tombol TestFlight tombol

7. Klik pada tombol Internal Testers plus tombol

8. Buat Kelompok Baru

   Saya suka menamai kelompok ini “internal”. Anda dapat menamainya apa saja.

   

9. Klik pada Invite testers tombol

10. Tambahkan diri Anda ke grup

    Cari diri Anda dalam daftar dan pilih kotak centang di samping nama Anda. (Anda mungkin perlu memperbarui halaman untuk melihat diri Anda) Lalu, klik pada Add tombol.

    

11. Pastikan Anda telah ditambahkan ke grup

    Sekarang, Anda seharusnya melihat diri Anda dalam grup.

    

Selamat 🎉 Anda telah menambahkan diri Anda ke TestFlight. Sekarang, ada satu hal lagi yang perlu Anda lakukan sebelum Anda dapat mengonfigurasi Capgo Native Build.

Pengaturan informasi kesesuaian

Anda sekarang perlu berjanji kepada Apple bahwa aplikasi Anda tidak menggunakan enkripsi non-standar (seperti algoritma kustom). Jika aplikasi Anda menggunakan enkripsi non-standar, saya sarankan membaca Dokumentasi Apple on how to handle this. There are two ways to do this:

1. Anda dapat melakukannya secara manual setiap kali Anda membangun aplikasi.
2. Kamu bisa melakukannya secara manual setiap kali kamu membangun aplikasi. false.

Mari kita mulai dengan yang pertama.

1. Ikuti semua langkah dari bagian sebelumnya untuk menemukan bagian TestFlight di App Store Connect

2. Klik di Builds -> iOS

3. Cari build yang informasi komplian tidak lengkap dan klik pada Manage

4. Manajemen build App Store Connect

   Untuk saya, ini none, tapi mungkin berbeda untuk Anda. Setelah itu, klik simpan

   

5. Aplikasi Anda sekarang harus mengatakan ready to test

   

Untuk yang kedua, berikut adalah langkah-langkahnya:

1. Buka file Info.plist file

2. Salin ke clipboard

   <key>ITSAppUsesNonExemptEncryption</key>
   <false/>

3. Simpan file

Catatan

Di sini adalah dokumentasi resmi Apple tentang cara menginformasikan Apple tentang kewajiban Anda untuk mengikuti regulasi enkripsi ekspor.

Menginstal aplikasi TestFlight dan menerima undangan

Sekarang, Anda HAMPIR sudah siap untuk menguji aplikasi Anda di TestFlight. Sebelumnya, Anda perlu melakukan hal-hal berikut:

1. Mengunduh aplikasi TestFlight dari App Store di perangkat iOS/iPadOS Anda
2. Menerima undangan untuk menguji aplikasi Anda

Saya akan melewatkan detail tentang cara menginstal aplikasi TestFlight di perangkat Anda. Jika Anda tidak yakin cara menginstal aplikasi, Google memiliki beberapa panduan yang bagus tentang cara melakukannya.

Untuk menerima undangan, Anda akan menerima email dari Apple dengan tautan untuk menerima undangan.

1. Buka email dari Apple dengan tautan untuk menerima undangan.

2. Klik pada View in TestFlight button

3. Klik pada tombol Install button

4. Instal aplikasi pada perangkat Anda

   Jika Anda telah menginstal aplikasi sebelumnya menggunakan Xcode, Anda mungkin melihat layar berikut. Silakan klik pada install button.

5. Tunggu aplikasi terpasang

6. Klik pada tombol ini Open Tombol ini dan klik

Selamat! 🎉 Anda telah menerima undangan untuk menguji aplikasi Anda di TestFlight. Sekarang, Anda dapat mengonfigurasi Capgo Build Nativ untuk membangun dan mengirimkan aplikasi ke TestFlight.

Mengonfigurasi Capgo Build Nativ

Ada beberapa hal yang perlu Anda konfigurasi di Capgo Build Nativ agar dapat membangun dan mengirimkan aplikasi ke TestFlight. Berikut adalah daftar hal yang akan Anda lakukan pada Capgo CLI:

Parameter	Deskripsi
--platform	Platform untuk membangun (“ios)
--apple-team-id	ID Tim Pengembang Apple Anda (ditemukan di Portal Pengembang Apple)
--apple-key	Jalur ke API File Kunci App Store Connect Anda (.p8 file)
--apple-key-id	ID Kunci API Key App Store Connect Anda
--apple-issuer-id	ID Penerbit App Store Connect Anda
--certificate	Jalur ke sertifikat distribusi Anda (.p12 file)
--ios-provisioning-profile	Peta profil pengaturan (bundleId=path atau jalur tunggal untuk profil)

Contoh perintah:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile '/path/to/profile.mobileprovision'

ID Tim Anda

Mulai dengan ID tim. Mencari informasi ini cukup mudah.

1. Pergi ke Akun Pengembang Apple dan gulir ke bawah

2. Temukan Team ID

   

ID Tim, ID Kunci Apple, dan ID Pengembang Apple

Sekarang, mari kita lanjutkan ke ID kunci Apple.

macOS: biarkan Capgo membuat kunci ini untuk Anda

Pada macOS, capgo build init Bisa membuat kunci App Store Connect API ini untuk Anda. Pilih Tidak — buatlah satu untuk saya and a guided window opens App Store Connect, walks you through each step, and captures the key, Key ID and Issuer ID automatically — no copy-paste. The manual steps below are the alternative (and the path on Windows or Linux).

1. Pergi ke Halaman Pengguna dan Akses App Store Connect

   Note

   Untuk saya, link kadang-kadang tidak berfungsi. Coba reload halaman jika tidak berfungsi untuk Anda.

2. Klik pada nama Anda di sudut kanan atas

   1. Klik pada tim yang ingin Anda gunakan
   2. Klik tim tim yang ingin digunakan

3. Klik pada tombol Integrations tombol

4. Cari tombol issuer

   Peringatan

   Ini IS HARUS DISIMPAN - Anda akan membutuhkannya nanti

   Klik pada tombol copy Tombol untuk menyalin penerbit

5. Click on the plus button

6. Atur nama kunci dan atur akses ke App manager dan klik tombol Generate Tombol

7. Simpan ID kunci

   Peringatan

   Hal ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

   

8. Download the key

   Peringatan

   Hal ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

   Bahaya

   JANGAN PERNAH MENYEBARKAN KUNCI KE SIAPA PUN - HANYA GUNAKANNYA DI Dalam CAPGO CLI

   

   

Selamat 🎉 Anda telah membuat kunci Apple, ID kunci Apple, dan ID penerbit Apple.

Sertifikat

Sekarang, Anda sudah siap untuk mengekspor sertifikat. Seperti yang Anda ingat, salah satu langkah pertama dari panduan ini adalah mengatur sertifikat distribusi.

Namun, Apple dalam kebijakan mereka yang tidak terbatas, memutuskan bahwa cara Anda mengekspor sertifikat sangat berbeda dari cara Anda membuatnya 🙃 Mari kita mulai dengan mengaturnya:

1. Buka Akses Kunci

   1. Klik Command + Space untuk membuka bar pencarian
   2. Cari Keychain Access
   3. Klik pada Keychain Access aplikasi

2. Pilih login Kategori dan klik pada My Certificates button

3. Sertifikat harus bernama

   Mencari sertifikat Akses Keychain Apple Distribution: [Your Name/Company] (your team ID)

4. Mengexport sertifikat Akses Keychain Export

5. Simpan sertifikat sebagai .p12 file

   Hatihati

   Ini JANGAN DIHAPUS - Anda akan membutuhkannya nanti

   1. Pastikan Anda memilih nama yang baik untuk file sertifikat
   2. Pastikan format file telah disetel ke Personal Information Exchange (.p12)
   3. Klik pada tombol Save button

   

6. Ketika diminta untuk memasukkan kata sandi, Anda dapat memilih:

   • Melewatkan kata sandi (direkomendasikan untuk sederhana): Klik OK tanpa memasukkan kata sandi
   • Set kata sandi: Jika Anda ingin melindungi sertifikat dengan kata sandi, Anda dapat menyetelnya di sini. Sertifikat yang dilindungi kata sandi .p12 file-file yang sepenuhnya didukung oleh Capgo CLI - cukup berikan kata sandi menggunakan --p12-password option ketika menjalankan perintah konfigurasi.

   

7. Ketika diminta untuk kata sandi 'kunci akses login', berikan kata sandi yang Anda gunakan untuk login ke Mac Anda

   Berikan kata sandi yang Anda gunakan untuk login ke Mac Anda. Kemudian, klik tombol Allow button.

   

Selamat 🎉 Sertifikat telah diekspor.

Profil Pengaturan

Sekarang, Anda sudah siap untuk mengexport profil pengaturan. Saya berjanji, ini adalah hal terakhir yang Anda butuhkan dari Apple.

1. Pergi ke Profil Pengembang Apple

2. Pilih tim yang tepat di dropdown

   1. Klik pada nama Anda di sudut kanan atas
   2. Klik pada tim yang ingin digunakan

3. Pastikan Anda berada di halaman yang benar Halaman harus seperti ini, jika tidak klik pada profiles di sidebar

   

4. Klik pada + tombol

5. Pilih jenis profil Pilih App Store Connect dan klik pada tombol Continue tombol

   

6. Pilih Aplikasi yang Anda Inginkan

   Cari aplikasi Anda di dropdown dan klik pada tombol Continue tombol

   

7. Pilih sertifikat distribusi yang benar

   Pilih sertifikat yang telah Anda export di langkah sebelumnya dan klik Continue tombol

   

   Jika Anda tidak yakin sertifikat mana yang harus dipilih, kembali ke Akses Keychain dan cari sertifikat yang telah diekspor. Kemudian lihat tanggal kadaluarsa.

   

8. Berinama Profil

   Berikan nama profil dan klik pada tombol Generate Tombol

   Tips

   Nama profil akan diambil secara otomatis oleh Capgo CLI — Anda tidak perlu mengingatnya.

   

9. Download the profile

   Klik pada Download tombol untuk mengunduh profil

   Peringatan

   File ini JANGAN DI SIMPAN - Anda akan membutuhkannya nanti

   

Selamat 🎉 Sekarang Anda telah memiliki semua yang Anda butuhkan untuk mengonfigurasi Capgo Build Nativ.

Peringatan

Jangan pernah memasukkan kunci yang Anda buat ke repositori Anda. Tetapkan mereka aman! 🔒

Menggunakan perintah pengaturan

Anda telah berhasil! Sekarang Anda telah mendapatkan semua yang Anda butuhkan untuk mengonfigurasi Capgo Native Build.

Perintah yang perlu Anda jalankan adalah:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id UVTJ336J2D \
  --apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \
  --apple-key-id 66FGQZB566 \
  --apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \
  --certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \
  --ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision

Ganti nilai tempat penempatan

Ganti nilai tempat penempatan di atas dengan kredit asli Anda yang dikumpulkan dalam langkah-langkah sebelumnya:

• --apple-team-id: ID Tim Apple Anda
• --apple-key: Jalur ke file kunci yang Anda download .p8 file kunci
• --apple-key-idID Tim Apple Anda
• --apple-issuer-id: ID Penerbit Apple Anda
• --certificate: Jalur ke file yang telah diekspor Anda .p12 sertifikat
• --ios-provisioning-profile: Jalur ke file yang telah didownload Anda .mobileprovision (ID Bundle Otomatis Ditetapkan untuk Profil tunggal)

: Jika semuanya berjalan dengan baik, Anda akan melihat output berikut:

: Gagal autentikasi Apple? Sinkronkan jam Anda

: Jika kunci API App Store Connect terlihat benar tetapi autentikasi masih gagal, sinkronkan jam komputer Anda dan coba lagi. Capgo menandatangani JWT Apple dengan waktu sistem lokal Anda, dan Apple menolak token yang akan kedaluwarsa lebih dari 20 menit di masa depan. Jam yang hanya beberapa detik tidak sinkron dapat cukup untuk gagal langkah ini.

Lihat : Panduan troubleshooting pembuat untuk sinkronisasi jam langkah-langkah.

Konfigurasi CI/CD (GitHub Aksi)

Jika Anda sudah menyelesaikan ID Tim, Kunci Apple, ID kunci Apple, dan ID penerbit Apple, Sertifikat, dan Profil pengaturanAnda sudah memiliki semua yang dibutuhkan untuk CI/CD. Bagian ini hanya menjelaskan cara mengirimkan nilai-nilai tersebut sebagai rahasia GitHub Actions dan variabel lingkungan.

1) Ubah file kredit menjadi kode base64 tunggal baris

# Distribution certificate (.p12)
base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt

# Provisioning profile (.mobileprovision)
base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt

# App Store Connect API key (.p8)
base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt

Tips

Nilai rahasia GitHub harus berbentuk baris tunggal. tr -d '\n' menghilangkan baris baru dari hasil base64.

2) Buat rahasia repository

Dalam GitHub > Repository > Settings > Secrets and variables > Actions, tambahkan:

Nama rahasia	Nilai
CAPGO_TOKEN	Token Anda Capgo API
APP_STORE_CONNECT_TEAM_ID	ID Tim dari ID Tim
APPLE_KEY_ID	ID Kunci dari Kunci Apple, ID Kunci Apple dan ID Pengeluarnya Apple
APPLE_ISSUER_ID	ID Pengeluarnya dari Kunci Apple, ID Kunci Apple dan ID Pengeluarnya Apple
BUILD_CERTIFICATE_BASE64	Isi dari certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	Dibuat oleh CLI — salin dari .capgo-credentials file
APPLE_KEY_CONTENT	Isi dari apple_key_base64.txt
P12_PASSWORD (opsional)	Your .p12 3) Gunakan variabel lingkungan di tugas Workflow Anda __CAPGO_KEEP_0__

1) Gunakan variabel lingkungan di dalam GitHub aliran Workflow Anda

/github/aliran kerja/ios-build.yml

name: iOS Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  ios-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS build with Capgo
        run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}

Tip

Dengan konfigurasi ini, CI mengirimkan kreditensi melalui variabel lingkungan saja. Anda tidak perlu memasukkan file tanda tangan atau mengunggahnya sebagai artefak alur kerja.

Judul Bagian “Menggunakan build”

Sekarang, Anda sudah siap untuk menjalankan build pertama Anda.

Jalankan perintah berikut untuk membangun aplikasi Anda:

bunx @capgo/cli@latest build request --platform ios

Selamat 🎉 Sekarang, Anda telah berhasil membangun aplikasi dan siap untuk disubmit ke App Store.

Submit ke ulasan App Store

Jalur pembangunan App Store normal mengunggah pembangunan ke App Store Connect/TestFlight. Jika rilis CI Anda juga harus menambahkan pembangunan TestFlight yang diproses ke versi App Store dan mengajukan untuk Ulasan, tambahkan --submit-to-store-review bersama dengan rilis pembangunan:

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --ios-distribution app_store \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

Pentingnya memiliki kunci kunci App Store Connect API (“APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, dan APP_STORE_CONNECT_TEAM_ID). App-specific password uploads and ad_hoc Penyebaran ke App Store tidak dapat mengirimkan build untuk tinjauan. --store-release-name adalah versi App Store; jika tidak disebutkan, Capgo membaca MARKETING_VERSION dari proyek Xcode. --store-release-notes adalah teks informasi apa yang baru di App Store, dan setiap --store-release-notes-locale "locale=notes" masukkan dapat menggantinya untuk lokalisasi toko. Gunakan --ios-automatic-release untuk merilis secara otomatis setelah mendapat persetujuan Apple, atau --no-ios-automatic-release untuk menunggu rilis manual. --ios-testflight-groups masih tersedia untuk distribusi beta eksternal, tetapi tidak diperlukan untuk pengajuan tinjauan App Store.

Mode Distribusi Ad-Hoc

Dengan default, Capgo membangun aplikasi iOS untuk distribusi App Store (TestFlight + App Store). Jika Anda membutuhkan build ad-hoc (untuk pengujian internal atau pengumpulan artefak CI), Anda dapat menggunakan --ios-distribution flag.

Catatan

Distribusi ad-hoc dan Enterprise (In-House) distribusi sama seperti distribusi Enterprise. Distribusi Enterprise memerlukan akun pengembang Apple Enterprise yang terpisah dan menggunakan profil pengaturan yang berbeda. Capgo saat ini mendukung app_store mode saja. ad_hoc Hanya mode.

Judul bagian “Kapan menggunakan mode ad-hoc”

• Anda tidak memiliki atau tidak ingin menggunakan kunci App Store Connect __CAPGO_KEEP_0__
• Anda tidak memiliki atau tidak ingin menggunakan kunci App Store Connect API
• Kamu ingin mengumpulkan artefak pembangunan melalui --output-upload Tidak perlu mengirimkan ke App Store

Persyaratan

Pembangunan ad-hoc memiliki Beberapa persyaratan yang lebih sedikit lebih sedikit daripada pembangunan App Store:

Kredensial	Diperlukan?
Sertifikat distribusi (.p12)	Iya
Profil pengembangan ad-hoc (.mobileprovision)	Ya
ID Tim (--apple-team-id)	Ya
Kunci API App Store Connect (.p8)	Tidak
ID Kunci Apple / Penerbit ID	Tidak

Penting

Dalam ad_hoc modus, --apple-key, --apple-key-id, dan --apple-issuer-id tidak didukung dan diabaikan. Hal ini adalah mengapa dua baris App Store Connect di atas tidak menampilkan flag CLI ad-hoc; pilihan ini hanya berlaku untuk app_store mode saja.

Peringatan

Tidak memiliki kunci App Store Connect API, nomor build otomatis menggunakan fallback berbasis timestamp. Untuk menghilangkan peringatan, lakukan --skip-build-number-bump.

Membuat profil provisioning ad-hoc

Ikuti langkah-langkah yang sama seperti Profil provisioningdi langkah ke-5, pilih Ad Hoc Alih daripada App Store:

1. Pergi ke Profil Pengembang Apple
2. Klik tombol + Tombol
3. Pilih Ad Hoc Pilih dan klik Lanjutkan
4. Pilih aplikasi dan sertifikat distribusi Anda
5. Pilih perangkat yang ingin Anda daftarkan
6. Berikan nama dan download profil

Menghemat kredit ad-hoc

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --ios-distribution ad_hoc \
  --apple-team-id YOUR_TEAM_ID \
  --certificate './certificate.p12' \
  --ios-provisioning-profile './adhoc_profile.mobileprovision'

Tidak --apple-key, --apple-key-id, atau --apple-issuer-id needed.

Mengompilasi Build Ad-hoc

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc

Untuk mengumpulkan IPA sebagai artefak build, tambahkan --output-upload:

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc \
  --output-upload

CI/CD dengan pembangunan ad-hoc

Untuk GitHub Aksi, Anda memerlukan rahasia lebih sedikit daripada pembangunan App Store:

github/workflows/ios-adhoc-build.yml

name: iOS Ad-Hoc Build

on:
  workflow_dispatch:

jobs:
  ios-adhoc:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS ad-hoc build
        run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }}
          CAPGO_IOS_DISTRIBUTION: ad_hoc

Saran

Perhatikan bahwa APPLE_KEY_ID, APPLE_ISSUER_ID, dan APPLE_KEY_CONTENT tidak diperlukan untuk pembangunan ad-hoc.

Aplikasi dengan Ekstensi (Multi-Target Signing)

Jika aplikasi Anda termasuk ekstensi (ekstensi berbagi, widget, ekstensi layanan pemberitahuan, dll.), maka setiap target ekstensi memerlukan profil pengaturan sendiri. Capgo mendukung hal ini melalui flag yang dapat diulang. --ios-provisioning-profile flag.

Bagian berjudul “Contoh: Aplikasi + Ekstensi Berbagi”

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

Each --ios-provisioning-profile flag menetapkan ID paket ke file profil pengaturan. The CLI:

1. Membaca setiap file mobileprovision
2. Mengextract otomatis nama profil dari plist yang diintegrasikan
3. Membaca setiap file mobileprovision
4. Menyimpan segalanya sebagai satu CAPGO_IOS_PROVISIONING_MAP credential

Trik

Anda memerlukan satu sertifikat distribusi untuk semua target — hanya profil pengaturan yang berbeda per target.

Pindah dari Profil Tunggal

Jika Anda sebelumnya menggunakan BUILD_PROVISION_PROFILE_BASE64 (profil tunggal), jalankan:

bunx @capgo/cli@latest build credentials migrate --platform ios

Ini mengonversi kreditan profil tunggal Anda ke sistem baru CAPGO_IOS_PROVISIONING_MAP Format dan menghapus kunci legasi (BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Setelah migrasi, tambahkan profil ekstensi dengan update perintah (penyatuan tambahan):

bunx @capgo/cli@latest build credentials update \
  --platform ios \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

Pilih

(bukan update (not saveGunakan hanya ketika mengatur semua kredit dari awal. update Pilih hanya ketika mengatur semua kredit dari awal. save Pilih hanya ketika mengatur semua kredit dari awal.

Troubleshooting

Profil pengaturan tidak termasuk kemampuan XYZ.

Sekali-kali, Anda mungkin melihat pesan kesalahan berikut:

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

Hal ini terjadi karena Anda telah mengaktifkan kemampuan baru setelah profil pengaturan dibuat. Profil pengaturan lama tidak termasuk kemampuan baru tersebut.

Untuk memperbaiki masalah ini, Anda perlu menghasilkan ulang profil pengaturan.

1. Buka Portal Pengembang Apple
2. Pilih tim yang benar di dropdown
3. Klik pada tombol Profiles tombol
4. Cari profil pengembang yang ingin Anda regenerasi
5. Klik pada tombol Edit tombol
6. Klik pada tombol Save tombol
7. Klik pada tombol Download button
8. Jalankan kembali perintah pengaturan Capgo Native Build bersama dengan profil yang baru saja diunduh.

Ini harus memperbaiki masalah.

Masalah lainnya

Jika Anda mengalami masalah dengan Capgo Native Build, pengaturan kunci, atau pembuatan aplikasi, silakan hubungi kami melalui dukungan.

Lanjutkan dari Pembangunan iOS

Jika Anda menggunakan Pembangunan iOS untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo Otomatisasi CI/CD, Capgo Pembangunan Nativ untuk alur kerja produk di Capgo Pembangunan Nativ, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi