Build iOS

Build and submit iOS apps to TestFlight and the App Store using Capgo’s dedicated Mac infrastructure.

Judul bagian “Apa yang akan Anda pelajari”

• Anda akan belajar bagaimana mengunggah aplikasi melalui Capgo Build Nativ
• Anda akan belajar bagaimana mengonfigurasi sertifikat untuk Capgo Build Nativ

Persyaratan

• Akun Capgo (cukup dengan uji coba gratis untuk memulai)
• Aplikasi Anda sudah terdaftar di Capgo (jalankan bunx @capgo/cli@latest app add jika belum)
• Komputer Mac dengan Xcode terinstal (mungkin untuk mengatur build di mesin linux/windows, tetapi belum terdokumentasi)
• Akun Pengembang Apple yang valid ($99/tahun) (Anda harus memiliki hak admin atau hak pemilik pada akun Pengembang Apple)
• Aplikasi Anda harus dapat dibangun dengan sukses melalui Xcode
• Aplikasi Capacitor
• Ikon yang telah dikonfigurasi untuk aplikasi. Aplikasi tanpa ikon tidak dapat diunggah ke App Store

Catatan

Saya akan menggunakan aplikasi berikut untuk tutorial: https://github.com/Cap-go/capgo-native-build-tutorial-app

Sebelum Anda memulai di portal Apple

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

• Aktifkan autentikasi dua faktor untuk akun Apple yang digunakan untuk pendaftaran
• Pilih jenis keanggotaan yang tepat:
  • Individu / Pemilik Usaha SendiriNama pribadi Anda secara hukum 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, catatan aplikasi, API kunci, dan TestFlight
• Pastikan ID paket akhir Anda segera. Mengubahnya nanti biasanya berarti melakukan setup App Store ulang
• Rencanakan item App Store Connect ini sebelum App Review: URL dukungan, URL kebijakan privasi, klasifikasi usia, layar tangkapan, kinerja ekspor, dan detail kontak App Review

Catatan

Sumber referensi resmi yang berguna:

• Jadilah anggota dari Program Pengembang Apple
• Kirimkan aplikasi dan game Anda
• Informasi versi platform di App Store Connect

Peringatan

Apple memperbarui persyaratan minimum SDK secara teratur. Sejak 28 April 2026, Aplikasi iPhone dan iPad yang diunggah ke App Store Connect harus dibangun dengan menggunakan iOS & iPadOS 26 SDK atau lebih baru.

Dianjurkan: pengaturan otomatis

Anda tidak perlu melakukan semua ini secara manual. Capgo’s pengaturan otomatis menciptakan dan mengonfigurasi kunci tanda tangan iOS (sertifikat distribusi + profil pengaturan) untuk Anda — jalur yang dianjurkan adalah:

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.

Manual walkthrough di bawah ini hanya untuk mereka yang lebih suka mengatur kredit sendiri, atau ingin memahami secara spesifik apa yang __CAPGO_KEEP_0__ lakukan di balik layar.

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first TestFlight build by hand. There are some advantages to doing a manual build first:

• Sebelum kita bisa memulai berpikir tentang membangun aplikasi dengan __CAPGO_KEEP_0__, kita harus terlebih dahulu mengatur dan melakukan pembangunan TestFlight pertama secara manual. Ada beberapa kelebihan melakukan pembangunan manual pertama:
• Anda akan mengatur sertifikat distribusi pada mesin lokal Anda
• You will be able to figure out any issues with the build process linked to your app code

Anda akan dapat mengetahui masalah-masalah dengan proses pembangunan yang terkait dengan aplikasi __CAPGO_KEEP_0__

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

1. Judul bagian “Mengatur sertifikat distribusi”','Buka Xcode']}

2. Klik pada Xcode -> Settings... Atau, Anda dapat menggunakan shortcut Cmd + ,

   

3. Buka Accounts

4. Temukan Akun Apple yang ditambahkan ke Akun Pengembang Apple

5. Temukan tim yang akan digunakan untuk mengirimkan aplikasi

6. Klik pada tombol Manage Certificates... button

7. Pastikan Anda dapat melihat sertifikat distribusi di daftar

8. Jika Anda tidak melihatnya, 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 menjelaskannya dalam tutorial ini.

   1. Klik pada tombol + dan kemudian pada Apple Distribution
   2. Sertifikat akan dibuat secara otomatis. Anda dapat melihatnya di daftar. Lihat 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 bilah alat Xcode, cari dan klik tombol product -> archive Bilah alat Xcode

   

3. Cari dan klik tombol

4. Tombol Distribute App Tombol

   

5. Pilih TestFlight Internal Only sebagai metode distribusi dan klik pada Distribute button

   

6. Konfigurasi catatan aplikasi

   Isi bidang berikut:

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

   Lalu, klik pada next button

   

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

8. Tunggu hingga unggahan selesai

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

10. Klik pada tombol Done Anda mungkin berpikir secara insting bahwa semuanya baik-baik saja dan Anda akan dapat melihat aplikasi Anda di TestFlight sekarang, tetapi ada beberapa hal lagi yang perlu diselesaikan:

Tambahkan diri Anda ke TestFlight

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

Mari kita mulai dengan yang pertama:

Menambahkan diri Anda ke TestFlight

1. Pergi ke halaman App Store Connect App Store Connect

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 Apps Tombol

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

6. Klik pada tombol TestFlight Tombol uji coba App Store Connect

7. Tombol tester internal App Store Connect plus Internal Testers plus Buat kelompok baru

8. Buat kelompok baru

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

   

9. Klik pada Invite testers tombol

10. Tambahkan diri Anda ke grup

    Temukan 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 harus 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.

Mengatur informasi kesepakatan

Sekarang Anda 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 untuk mengetahui cara mengatasi hal ini. Ada dua cara untuk melakukannya:

1. Anda dapat melakukannya secara manual setiap kali Anda membangun aplikasi.
2. Anda dapat mengonfigurasi file plist Anda untuk mengatur nilai ini secara otomatis. false.

Mari kita mulai dengan cara pertama:

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

2. Klik pada Builds -> iOS

3. Temukan build dengan informasi kesepakatan yang hilang dan klik pada Manage

4. Pilih opsi yang terbaik untuk mendeskripsikan aplikasi Anda

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

   

5. Aplikasi Anda seharusnya sekarang mengatakan ready to test

   

Untuk yang kedua, berikut adalah langkah-langkahnya:

1. Buka file Info.plist Tambahkan kunci berikut:

2. Salin ke clipboard

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

3. Simpan file ini

Catatan

Di sini adalah dokumentasi resmi Apple tentang cara menginformasikan Apple tentang ketercapaian Anda dengan regulasi ekspor enkripsi.

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. Unduh aplikasi TestFlight dari App Store pada perangkat iOS/iPadOS Anda
2. Terima undangan untuk menguji aplikasi Anda

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

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

1. Buka surel dari Apple dengan tautan untuk menerima undangan

2. Klik pada View in TestFlight tombol

3. Klik pada tombol Install tombol

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 untuk terinstal

6. Klik pada Open button 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 lewatkan ke Capgo CLI:

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

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

Mari kita mulai dengan ID tim. Mencarinya cukup mudah.

1. Buka Akun Pengembang Apple dan gulir ke bawah

2. Cari lokasi Team ID

   

ID kunci Apple, ID kunci Apple dan ID pengembang Apple

Sekarang, mari kita lanjutkan ke kunci Apple.

macOS: biarkan Capgo membuat kunci ini untuk Anda

Pada macOS, capgo build init dapat membuat kunci App Store Connect API untuk Anda. Pilih “Tidak — buatlah untuk saya” dan jendela panduan terbuka App Store Connect, memandu Anda melalui setiap langkah, dan menangkap kunci, ID Kunci, dan ID Penerbit secara otomatis — tidak perlu copy-paste. Langkah-langkah manual di bawah ini adalah alternatif (dan jalur pada Windows atau Linux).

1. Akses ke halaman akses pengguna dan App Store Connect

   Catatan

   Untuk saya, link ini tidak bekerja. Muat ulang halaman jika tidak bekerja untuk Anda.

2. Pilih tim yang benar di dropdown

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

3. Klik pada Integrations button

4. Temukan issuer

   Peringatan

   Hal ini __CAPGO_KEEP_0__ - Anda akan membutuhkannya nanti

   Klik pada tombol copy untuk menyalin issuer

5. Klik pada tombol plus

6. Atur nama kunci dan atur akses ke App manager dan klik pada tombol Generate Tombol Pengguna App Store Connect untuk menambahkan kunci, atur nama kunci, atur akses ke pengelola aplikasi dan buat

7. Peringatan

   Peringatan

   Ini __CAPGO_KEEP_0__ - Anda akan membutuhkannya nanti

   

8. Unduh kunci

   Peringatan

   Ini __CAPGO_KEEP_0__ - Anda akan membutuhkannya nanti

   Bahaya

   TIDAK PERNAH BERBAGI KUNCI DENGAN SIAPA PUN - HANYA GUNAKANNYA DI DALAM CAPGO CLI

   

   

Selamat 🎉 Anda telah menciptakan 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 menciptakannya 🙃 Mari kita mulai dengan mengatur:

1. Buka Akses Kunci

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

2. Pilih kategori dan klik pada login kategori dan klik pada My Certificates tombol

3. Temukan sertifikat Anda di daftar

   Sertifikat harus bernama Apple Distribution: [Your Name/Company] (your team ID)

4. Klik kanan pada sertifikat dan pilih Export

5. Simpan sertifikat sebagai .p12 file

   Peringatan

   Ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

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

   

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

   • Lupai Kata Sandi (direkomendasikan untuk sederhana): Klik OK tanpa memasukkan kata sandi
   • Atur Kata Sandi: Jika Anda lebih suka melindungi sertifikat Anda dengan kata sandi, Anda dapat mengatur satu di sini. File yang dilindungi kata sandi sepenuhnya didukung oleh __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - cukup berikan kata sandi menggunakan .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password Dialog Simpan Kunci Akses Sertifikat Kata Sandi

   

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

   Kunci Akses Simpan Sertifikat Kata Sandi Kunci Akses Login Allow Kunci Akses Simpan Sertifikat Kata Sandi Kunci Akses Login

   

Selamat 🎉 Sertifikat telah diekspor.

Profil Pengaturan

Pergi ke

1. Apple Developer Profiles Pilih tim yang benar di dropdown

2. Klik pada nama Anda di pojok kanan atas

   1. Klik pada tim yang ingin digunakan
   2. Pilih Tim Apple Developer

3. di sidebar profiles Pilih tim yang benar di dropdown

   

4. Klik pada tombol + tombol

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

   

6. Pilih aplikasi yang ingin Anda buat

   Cari aplikasi Anda di dropdown dan klik pada tombol Continue tombol

   

7. Pilih sertifikat distribusi yang benar

   Pilih sertifikat yang Anda ekspor pada langkah sebelumnya dan klik tombol Continue Apple Developer pilih sertifikat distribusi

   

   Apple Developer pilih tanggal kadaluarsa sertifikat distribusi

   

8. Berikan nama profil dan klik tombol

   Tip Generate Tip

   Pilih sertifikat yang benar untuk distribusi

   The profile name is automatically extracted by the Capgo CLI — you don’t need to remember it.

   

9. Unduh profil

   Klik pada Download tombol untuk mengunduh profil

   Peringatan

   File ini PERLU DI SIMPAN - Anda akan membutuhkannya nanti

   

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

Hati-hati

Jangan pernah mengkomitkan kredential yang baru saja dibuat ke repositori Anda. Simpanlah mereka dengan aman! 🔒

Menggunakan perintah konfigurasi

Anda telah berhasil! Anda telah mendapatkan semua yang dibutuhkan 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 kredential sebenarnya yang dikumpulkan dalam langkah-langkah sebelumnya:

• --apple-team-id: ID Tim Apple Anda
• --apple-key: Jalur ke file yang telah diunduh .p8 : ID Kunci Apple Anda
• --apple-key-id: ID Pengeluarnya Kunci Apple Anda
• --apple-issuer-id: Jalur ke file sertifikat yang telah diekspor
• --certificate: Jalur ke file yang telah diunduh (ID Bundle Otomatis Diperkirakan untuk Profil tunggal) .p12 Jika semuanya berjalan dengan baik, Anda akan melihat output berikut:
• --ios-provisioning-profile__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ output penyimpanan kredit .mobileprovision Pengaturan CI/CD (__CAPGO_KEEP_0__ Aksi)

Judul bagian “Pengaturan CI/CD (__CAPGO_KEEP_0__ Aksi)”

CI/CD setup (GitHub Actions)

If Anda sudah menyelesaikan ID Tim, Kunci Apple, ID Kunci Apple, dan ID Penerbit Apple, Sertifikat, dan Profil Pengaturan, Anda 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) Konversi file kredit ke 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

GitHub rahasia harus memiliki nilai satu baris. tr -d '\n' menghilangkan baris-baris dari output base64.

2) Buat rahasia repository

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

Nama rahasia	Nilai
CAPGO_TOKEN	Token Capgo API Anda
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)	Anda .p12 kata sandi jika telah ditetapkan selama ekspor

3) Gunakan variabel lingkungan di workflow GitHub Anda di Actions

github/workflows/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 }}

Tips

Dengan konfigurasi ini, CI mengirimkan kredit melalui variabel lingkungan saja. Anda tidak perlu mengkomit file tanda tangan atau mengunggahnya sebagai artefak workflow.

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! 🎉 Saat ini, Anda telah berhasil membangun aplikasi dan siap untuk disubmit ke 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 bukanlah sama dengan distribusi Enterprise (Dalam Rumah). Distribusi Enterprise memerlukan akun pengembang Apple Enterprise yang terpisah dan menggunakan profil pengaturan yang berbeda. __CAPGO_KEEP_0__ saat ini hanya mendukung dan the same as Enterprise (In-House) distribution. Enterprise distribution requires a separate Apple Developer Enterprise account and uses different provisioning profiles. Capgo currently supports app_store mode saja. ad_hoc mode saja.

Kapan menggunakan mode ad-hoc

• Anda ingin mendistribusikan IPAs secara langsung ke perangkat yang terdaftar (tidak melalui TestFlight)
• Anda tidak memiliki atau tidak ingin menggunakan kunci App Store Connect API
• Anda ingin mengumpulkan artefak pembangunan melalui --output-upload tanpa mengirimkan ke App Store

Persyaratan

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

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

Perlu diingat

Dalam mode, , dan tidak didukung dan diabaikan. ad_hoc Alasan mengapa dua baris App Store Connect di atas tidak menampilkan flag __CAPGO_KEEP_0__ ad-hoc; opsi-opsi ini hanya berlaku untuk mode. --apple-key, --apple-key-idPeringatan --apple-issuer-id are not supported and are ignored. This is why the two App Store Connect rows above do not show ad-hoc CLI flags; these options apply to app_store Tidak memiliki kunci __CAPGO_KEEP_0__ App Store Connect, nomor build otomatis akan menggunakan fallback berdasarkan timestamp. Untuk menghilangkan peringatan, tambahkan

Bagian berjudul “Membuat profil provisioning ad-hoc”

Without an App Store Connect API key, build number auto-increment uses a timestamp-based fallback. To suppress the warning, pass --skip-build-number-bump.

Membuat profil provisioning ad-hoc

Membuat profil provisioning ad-hoc Profil pengaturan, tetapi pada langkah 5, pilih Ad Hoc sebaliknya dari App Store:

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

Menyimpan 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 diperlukan.

Menggunakan 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

Pengaturan CI/CD dengan build ad-hoc

Untuk GitHub Actions, Anda memerlukan lebih sedikit rahasia daripada build 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

Tips

Perlu diingat 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 Contoh: Aplikasi + Ekstensi Berbagi

Judul bagian “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"

Aplikasi --ios-provisioning-profile flag menetapkan ID aplikasi ke profil pengaturan file-nya. Profil pengaturan CLI:

1. Membaca setiap file mobileprovision
2. Mengextract profil secara otomatis dari plist yang diintegrasikan
3. Mengenkripsi Base64 file-nya
4. Menyimpan semua sebagai satu CAPGO_IOS_PROVISIONING_MAP kredensial

Tip

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

Migrasi dari Profil tunggal

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

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

Ini mengubah kredit profil tunggal yang ada menjadi format baru dan menghapus kunci warisan ( CAPGO_IOS_PROVISIONING_MAP Setelah migrasi, tambahkan profil ekstensi dengan perintah (pembuatan tambahan):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Jendela terminal update Salin ke clipboard

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

pembuatan tambahan

pembuatan tambahan update (tidak save) untuk menambahkan profil ke kredit yang sudah ada. Perintah ini menggabungkan profil baru dengan yang sudah ada. Gunakan update hanya ketika mengatur semua kredit dari awal. save Pengaturan

Bagian berjudul “Pengaturan”

Bagian berjudul “Profil pengaturan tidak termasuk kemampuan XYZ.”

Salin ke clipboard

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

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

Copy to clipboard

1. Buka Portal Pengembang Apple
2. Pilih tim yang benar di dropdown
3. Klik pada tombol Profiles Tombol Profil Pengembang Apple
4. Cari profil pengaturan Apple Developer
5. Tombol Edit Profil Pengembang Apple Edit __CAPGO_KEEP_0__
6. Klik pada tombol Save tombol
7. Klik pada tombol Download tombol
8. Jalankan kembali perintah pengaturan Native Build Capgo dengan profil yang baru saja diunduh.

Masalah ini seharusnya dapat teratasi.

Masalah lain

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

Teruskan dari Pembangunan iOS

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