Pembangunan iOS

Buat dan kirimkan 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

Persyaratan

• Akun Capgo dengan langganan aktif
• Aplikasi Anda sudah terdaftar di Capgo (jalankan bunx @capgo/cli@latest app add jika tidak)
• 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:
  • Pribadi / Pemilik Usaha: 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 wewenang untuk mengikat organisasi ke perjanjian Apple
• Gunakan akun yang dapat mengakses baik Apple Developer dan App Store Connect untuk sertifikat, catatan aplikasi, API kunci, dan TestFlight
• Tetapkan ID bundle akhir Anda sebelumnya. Mengubahnya nanti biasanya berarti melakukan setup App Store ulang
• Siapkan hal-hal berikut di App Store Connect sebelum App Review: URL dukungan, URL kebijakan privasi, klasifikasi usia, screenshot, kinerja ekspor, dan detail kontak App Review

Catatan

Referensi resmi yang berguna:

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

Peringatan

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

Pembangunan manual pertama

Sebelum kita bisa memikirkan 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 pertama:

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

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

Mengatur sertifikat distribusi

1. Buka Xcode

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

   

3. Lanjutkan ke Accounts

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

5. Cari tim yang akan digunakan untuk mengirimkan aplikasi

6. Klik pada tombol Manage Certificates... tombol

7. Pastikan Anda dapat melihat sertifikat distribusi di daftar

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

   Catatan

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

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

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

Buat Manual ke TestFlight

1. Buka aplikasi di Xcode

   Jalankan bunx cap open ios untuk membuka aplikasi di Xcode.

2. Cari dan klik pada tombol archive tombol

   Di toolbar Xcode, cari dan klik pada tombol product -> archive tombol.

   

3. Tunggu proses build untuk selesai

4. Klik pada tombol Distribute App tombol

   

5. Pilih TestFlight Internal Only sebagai metode distribusi dan klik pada tombol Distribute Metode distribusi internal hanya untuk TestFlight Xcode

   

6. Isi bidang berikut:

   Nama: Nama aplikasi Anda - terlihat di App Store

   1. __CAPGO_KEEP_0__
   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 tombol next tombol

   

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

8. Tunggu hingga upload selesai

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

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

Xcode TestFlight configure app record

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 tangkapan layar yang sesuai dengan perangkat yang Anda dukung
5. Tambahkan detail kontak App Review dan kredential uji sebelum pengajuan produksi

Mari kita mulai dengan yang pertama:

Menambahkan diri Anda ke TestFlight

1. Buka halaman App Store Connect halaman login App Store Connect

2. Masuk dengan akun Pengembang Apple Anda

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

4. Klik pada tombol Apps Tombol App Store Connect apps

5. Pemilihan aplikasi App Store Connect

6. Tombol App Store Connect testflight TestFlight Klik pada tombol

7. Klik pada tombol Internal Testers plus Tombol

8. Buat kelompok baru

   Saya suka menamai kelompok “internal”. Kamu bisa menamainya apa saja.

   

9. Klik pada Invite testers Tombol

10. Tambahkan diri kamu ke kelompok

    Cari diri kamu di daftar dan pilih kotak centang di samping nama kamu. (Mungkin kamu perlu memperbarui halaman untuk melihat diri kamu) Lalu, klik pada Add Tombol

    

11. Pastikan Anda telah ditambahkan ke grup

    Sekarang, Anda seharusnya melihat diri Anda sendiri di grup.

    

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

Mengatur informasi kesesuaian

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 mengenai 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.

Anda akan 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 bangun dengan informasi ketidaksesuaian dan klik pada Manage

4. Pilih opsi yang paling sesuai dengan aplikasi Anda

   Untuk saya, ini adalah nonetetapi mungkin berbeda untuk Anda.

   

5. App Store Connect untuk menyimpan informasi ketidaksesuaian ready to test

   

App Store Connect siap untuk diuji

1. Buka Info.plist file

2. Tambahkan kunci berikut:

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

3. Simpan file

Catatan

Di sini __CAPGO_KEEP_0__

Menginstal aplikasi TestFlight dan menerima undangan

Sekarang, Anda sudah hampir 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 button

3. Klik pada tombol Install tombol

4. Pasang aplikasi pada perangkat Anda

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

5. Tunggu aplikasi terpasang

6. Klik pada Open tombol dan klik

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

Mengonfigurasi Capgo Pembangunan Native

Ada beberapa hal yang perlu Anda atur dalam Capgo Pembangunan Nama Asli untuk dapat membangun dan mengirimkan aplikasi ke TestFlight. Berikut adalah daftar hal yang akan Anda lakukan pada Capgo CLI:

Parameter	Deskripsi
--platform	Platform untuk dibangun (ios)
--apple-team-id	ID Tim Pengembang Apple Anda (ditemukan di Portal Pengembang Apple)
--apple-key	Jalur ke API Kunci File App Store Connect Anda (.p8 file)
--apple-key-id	ID Kunci API App Store Connect Anda
--apple-issuer-id	ID Pengemudian App Store Connect Anda
--certificate	Jalur ke sertifikat distribusi Anda (.p12 file)
--ios-provisioning-profile	Peta profil penyediaan (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. Lihat di Akun Pengembang Apple dan gulirkan ke bawah

2. Temukan lokasi ID tim di akun pengembang Team ID

   

Nomor kunci Apple, ID kunci Apple, dan ID penerbit Apple

Sekarang, mari kita lanjutkan ke nomor kunci Apple.

1. Buka halaman Halaman pengguna dan akses App Store Connect

   Perlu diingat

   Untuk saya, link ini tidak selalu berfungsi. Jika tidak berfungsi untuk Anda, reload halaman ini.

2. Pilih tim yang benar di dropdown

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

3. Klik pada Integrations tombol

4. Temukan issuer

   Peringatan

   Hal ini PERLU DI SIMPAN - Anda akan membutuhkannya nanti Klik pada

   tombol copy tombol untuk menyalin penerbit

5. Klik pada tombol plus

6. Tetapkan nama kunci dan tetapkan akses ke App manager dan klik pada tombol Generate tombol

7. Simpan ID kunci

   Peringatan

   Ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

   

8. Unduh kunci

   Peringatan

   Ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

   Bahaya

   TIDAK PERNAH BAGIKAN KUNCI DENGAN SIAPA PUN - HANYA GUNAKAN DALAM CAPGO CLI

   

   

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

Sertifikat

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

Namun, Apple dalam kebijakan mereka yang tak terhingga, memutuskan bahwa cara Anda mengexport sertifikat sangat berbeda dari cara Anda membuatnya 🙃 Mari kita mulai dengan mengatur hal tersebut:

1. Buka Akses Kunci

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

2. Pilih kategori dan klik tombol login tombol My Certificates Kategori Akses Keychain untuk login

3. Sertifikat harus bernama

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

4. Ekspor sertifikat di Akses Keychain Export

5. __CAPGO_KEEP_0__ .p12 file

   Peringatan

   Ini __CAPGO_KEEP_0__ HARUS DISIMPAN - Anda akan membutuhkannya nanti

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

   

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

   • Lepaskan kata sandi (direkomendasikan untuk sederhana): Klik OK tanpa memasukkan kata sandi
   • Atur kata sandi: Jika Anda lebih suka melindungi sertifikat dengan kata sandi, Anda dapat menyetelnya di sini. Sertifikat yang dilindungi kata sandi .p12 dapat 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 masuk ke Mac Anda

   Berikan kata sandi yang Anda gunakan untuk masuk ke Mac Anda. Kemudian, klik tombol Allow Kunci akses kunci akses login Keychain

   

Profil pengaturan

Profil pengaturan

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

1. Pergi ke Apple Developer Profil

2. Pilih tim yang benar di dropdown

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

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 ingin Anda buat

   Cari aplikasi Anda di dropdown dan klik pada tombol Continue Tombol

   

7. Pilih sertifikat yang Anda ekspor pada langkah sebelumnya dan klik pada tombol

   __CAPGO_KEEP_0__ Continue button

   

   Jika Anda tidak yakin mana sertifikat yang harus dipilih, kembali ke Akses Kunci Rincian dan cari sertifikat yang Anda ekspor. Kemudian lihat tanggal kadaluarsa.

   

8. Berikan nama profil

   Berikan nama profil dan klik pada Generate button

   Tips

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

   

9. Unduh profil

   Klik pada tombol untuk mengunduh profil Download profil untuk mengunduh profil

   Peringatan

   File ini HARUS DISIMPAN - Anda akan membutuhkannya nanti

   

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

Peringatan

Jangan pernah mengkomit kredential yang Anda buat ke repository Anda. Simpanlah mereka dengan aman! 🔒

Menggunakan perintah konfigurasi

Selamat! Anda telah berhasil 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 kredit asli Anda yang dikumpulkan pada langkah-langkah sebelumnya:

• --apple-team-id: ID Tim Apple Anda
• --apple-key: Jalur ke file kunci yang Anda download .p8 Ganti nilai tempat penempatan di atas dengan kredit asli Anda yang dikumpulkan pada langkah-langkah sebelumnya:
• --apple-key-id: ID Kunci Apple Anda
• --apple-issuer-id: ID Pengeluarnya Apple Anda
• --certificate: Jalur ke file sertifikat Anda yang diekspor .p12 : Sertifikat
• --ios-provisioning-profile: Jalur ke file yang diunduh Anda (ID Bundle Otomatis Diperkirakan untuk Profil tunggal) .mobileprovision Jika semuanya berjalan dengan baik, Anda akan melihat output berikut:

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ output penyimpanan kredential

Bagian berjudul “Pengaturan CI/CD (GitHub Actions)”

ID Tim Anda ID Kunci Apple Anda, 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 melewati nilai-nilai tersebut sebagai rahasia GitHub Actions dan variabel lingkungan.

1) Konversi file kredit ke nilai 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

Tip

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

2) Buat rahasia repository

Dalam 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 Penerbit dari Apple key, ID kunci Apple dan ID penerbit 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 kunci melalui variabel lingkungan saja. Anda tidak perlu mengkomit file tanda tangan atau mengunggahnya sebagai artefak alur kerja.

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 🎉 Pada titik ini, Anda telah berhasil membangun aplikasi Anda 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 pembangunan ad-hoc daripada (untuk pengujian internal atau pengumpulan artefak CI), Anda dapat menggunakan --ios-distribution flag.

Peringatan

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 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 Kapan menggunakan mode ad-hoc ad_hoc Kapan Menggunakan Mode Ad-Hoc

Kapan Menggunakan Mode Ad-Hoc

• Anda ingin mendistribusikan IPA 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 build melalui --output-upload tanpa mengajukan ke App Store

Persyaratan

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

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

Catatan

Di ad_hoc mode, dan mode lainnya --apple-key, --apple-key-id, dan --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 Alasan mengapa dua baris App Store Connect di atas tidak menampilkan flag __CAPGO_KEEP_0__ ad-hoc; opsi-opsi ini hanya berlaku untuk mode

Peringatan

Tidak ada App Store Connect API key, maka build number auto-increment menggunakan fallback berbasis timestamp. Untuk menghilangkan peringatan, tambahkan --skip-build-number-bump.

Membuat profil provisioning ad-hoc

Ikuti langkah-langkah yang sama seperti Profil provisioning, tetapi pada langkah 5, pilih Ad Hoc bukan App Store:

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

Menghemat kredit iklan 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 bangun ad-hoc

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

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

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

Pengembangan CI/CD dengan pembangunan ad-hoc

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

Tips

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

Jendela Terminal

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"

Membaca setiap file mobileprovision --ios-provisioning-profile flag maps a bundle ID to its provisioning profile file. The CLI:

1. Membaca setiap file mobileprovision
2. Mengextract otomatis nama profil dari plist yang diintegrasikan
3. Mengenkripsi file menggunakan Base64
4. Menyimpan semuanya 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

(profil tunggal), jalankan: BUILD_PROVISION_PROFILE_BASE64 Jendela Terminal

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

Ini mengubah kreditur profil tunggal Anda ke format baru dan menghapus kunci legasi ( CAPGO_IOS_PROVISIONING_MAP Setelah migrasi, tambahkan profil ekstensi dengan perintah (campur tambahan):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Jendela terminal update Salin ke clipboard

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

(bukan

) untuk menambahkan profil ke kreditur yang sudah ada. update The saveThe update perintah menggabungkan profil baru dengan profil yang sudah ada. Gunakan save hanya ketika mengatur semua kredit dari awal.

Pengaturan

Profil pengaturan tidak termasuk kemampuan XYZ.

Kadang-kadang, 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 belum.

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

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

Masalah ini seharusnya teratasi.

Masalah lain

If for whatever reason you are having issues either with Capgo Native Build, configuring the credentials or building the app, please don’t hesitate to reach via our Jika Anda mengalami masalah dengan Native Build __CAPGO_KEEP_0__ atau pengaturan kredential, silakan hubungi kami melalui.