Bangun iOS

Bangun 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 mengonfigurasi sertifikat untuk Capgo Native Build

Prerequisites

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

Pertanda

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

Sebelum Anda memulai di portal-portal Apple

Sebelum Anda mengatur sertifikat atau memicu 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 Sendiri: nama pribadi Anda menjadi nama penjual di App Store
  • Pengusaha: 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
• Pakai akun yang dapat mengakses baik Apple Developer dan App Store Connect untuk sertifikat, catatan aplikasi, API kunci, dan TestFlight
• Simpan ID paket akhir Anda sebelumnya. 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, screenshot, kinerja ekspor, dan detail kontak App Review

Catatan

Referensi resmi yang berguna:

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

Peringatan

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

Rekomendasi: onboarding otomatis

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

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

Langkah-langkah manual di bawah ini hanya untuk mereka yang lebih suka mengatur kunci tanda tangan sendiri, atau ingin memahami secara spesifik apa yang Capgo lakukan di bawah kerangka.

Build manual pertama

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

• Anda akan mengatur sertifikat distribusi pada mesin lokal Anda
• Anda 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 dapat memulai, Anda harus memiliki sertifikat distribusi terinstal di 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. Pergi ke Accounts

4. Cari Akun Apple yang ditambahkan ke Akun Pengembang Apple

5. Cari tim yang akan digunakan untuk menginstal 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 pada jumlah sertifikat distribusi yang dapat Anda miliki, yaitu 3. Jika Anda memiliki lebih dari 3 sertifikat, Anda perlu menghapus salah satu untuk dapat membuat sertifikat baru. Hal ini tidak akan saya bahas dalam tutorial ini.

   1. Klik pada tombol + Tombol, kemudian klik 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. Membuka aplikasi di Xcode

   Jalankan bunx cap open ios Klik tombol untuk membuka aplikasi di Xcode.

2. Temukan dan klik pada tombol archive Tombol

   Dalam bilah alat Xcode, temukan dan klik pada tombol. product -> archive button.

   

3. Tunggu proses build selesai

4. Klik pada tombol Distribute App tombol

   

5. Pilih 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

   Lalu, klik pada tombol next Tombol

   

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

8. Tunggu sampai upload selesai

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

10. Klik pada tombol Done Tombol

Anda mungkin berpikir secara insting bahwa semuanya sudah baik sekarang dan Anda akan dapat melihat aplikasi Anda di TestFlight sekarang, tetapi ada beberapa hal lagi yang perlu diselesaikan:

1. Daftarkan diri Anda ke TestFlight
2. Pastikan kelengkapan ekspor sehingga 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

Mari 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 Anda membuat catatan aplikasi. Jika Anda hanya memiliki satu akun pengembang, Anda dapat melewatkan langkah ini.

4. Klik pada tombol Apps tombol

5. Cari 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 button

8. Buat kelompok baru

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

   

9. Klik pada Invite testers button

10. Tambahkan diri Anda ke kelompok

    Cari diri Anda di daftar dan pilih kotak centang di samping nama Anda. (Mungkin Anda 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 di grup.

    

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

Mengatur 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 Dokumentasi Apple Anda dapat melakukannya secara manual setiap kali Anda membangun aplikasi.

1. Anda dapat melakukan ini secara manual setiap kali Anda membangun aplikasi.
2. Anda dapat mengonfigurasi file plist Anda untuk secara otomatis menetapkan nilai ini ke false.

Setting up the compliance information

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

2. Klik pada Builds -> iOS

3. Temukan build yang memiliki informasi kepatuhan yang hilang dan klik pada Manage

4. Pilih opsi yang paling sesuai dengan aplikasi Anda

   Bagi saya, ini adalah noneTapi 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. Membuka file Info.plist Membuka file

2. Tambahkan kunci berikut:

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

3. Membuka file

Perhatian

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 ALMOST Siap untuk menguji aplikasi Anda di TestFlight. Sebelumnya, Anda perlu melakukan hal-hal berikut:

1. Aplikasi TestFlight Aplikasi TestFlight Terima undangan untuk menguji aplikasi Anda
2. Terima undangan untuk menguji aplikasi Anda

I will skip the details of how to install the TestFlight app on your device. If you are not sure how to install an app, Google has some great guides on how to do it.

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

1. Buka surel dari Apple dengan tautan untuk menerima undangan

2. Klik di View in TestFlight button

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

5. Tunggu aplikasi terinstal

6. Klik pada tombol 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 ke TestFlight.

Mengonfigurasi Capgo Pembangunan Native

Ada beberapa hal yang perlu Anda konfigurasi dalam Capgo Pembangunan Nativ 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) Situs Portal Pengembang Apple)
--apple-key	Path ke API Kunci Toko App Anda (.p8 file)
--apple-key-id	ID Kunci Aplikasi App Store Connect Anda API
--apple-issuer-id	ID Pengemudian Toko App Anda
--certificate	Path ke sertifikat distribusi Anda (.p12 file)
--ios-provisioning-profile	Petaan 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. Pergi ke Akun Pengembang Apple dan gulir ke bawah

2. Temukan Team ID

   

Kunci Apple, ID Kunci Apple, dan ID Pengeluarnya Apple

Sekarang, mari kita lanjutkan ke 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 Portal Pengguna dan Akses App Store

   Catatan

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

2. Pilih tim yang benar di dropdown

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

3. Klik pada Integrations Tombol

4. Cari issuer

   Peringatan

   Ini HARUS DI SIMPAN - Anda akan membutuhkannya nanti

   Klik pada tombol untuk menyalin issuer copy Pengguna App Store Connect copy issuer

5. Tombol tambah kunci App Store Connect

6. Atur nama kunci dan atur akses ke App manager Set the access to Generate Tombol

7. Simpan ID kunci

   Peringatan

   Hal ini TIDAK BOLEH DILUPAKAN - Anda akan membutuhkannya nanti Salin ID kunci App Store Connect

   

8. Simpan ID kunci

   Peringatan

   Indonesia UNTUK DISIMPAN - Anda akan membutuhkannya nanti

   Bahaya

   JANGAN PERNAH MENGUNGKAP KUNCI INI KE SIAPA SAJAWAH - HANYA GUNAKAN 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 awal dari panduan ini adalah mengatur sertifikat distribusi.

Namun, Apple dalam kebijaksanaannya yang tak terbatas, memutuskan bahwa cara Anda mengexport sertifikat sangat berbeda dari cara Anda membuatnya 😂 Mari kita mulai mengatur hal itu:

1. Terbuka Akses Keychain

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

2. Pilih login Kategori akses Keychain 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 sebuah .p12 file

   Peringatan

   Ini PERLU DI SIMPAN - Anda akan membutuhkannya nanti Anda akan memerlukan itu nanti.

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

   

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

   • Melewati kata sandi (direkomendasikan untuk kesederhanaan): Klik OK Tidak memasukkan kata sandi
   • Buat kata sandi: Jika Anda ingin melindungi sertifikat dengan kata sandi, Anda dapat menyetelnya di sini. Dengan Kata Sandi .p12 file-file tersebut sepenuhnya didukung oleh Capgo CLI - cukup berikan kata sandi menggunakan --p12-password Dialog Simpan Sertifikat Keychain Access dengan Kata Sandi

   

7. Ketika diminta untuk "kunci login keychain", masukkan kata sandi yang Anda gunakan untuk login ke Mac Anda

   Masukkan kata sandi yang Anda gunakan untuk masuk ke Mac Anda. Kemudian, klik pada 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 Profesi Pengembang Apple

2. Pilih tim yang benar di dropdown

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

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

   

4. Klik pada + button

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

   

6. Pilih aplikasi yang ingin Anda bangun

   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 pada tombol Continue Tombol

   

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

   

8. Berinama profil

   Berikan nama profil dan klik pada tombol Generate Tombol

   Tip

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

   

9. Download the profile

   Klik pada Download Tombol untuk mengunduh profil

   Peringatan

   File ini HARUS DI SIMPAN - Anda akan membutuhkannya nanti

   

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

Pertimbangan

Hindari mengkomit kredential yang baru saja dibuat ke repositori Anda. Simpanlah dengan aman! 🔒

Melakukan perintah pengaturan

Anda telah melakukannya! Anda telah mendapatkan semua yang Anda butuhkan untuk mengonfigurasi Capgo Build Nativ.

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-nilai tempat penempatan di atas dengan kreditual asli Anda yang dikumpulkan dalam langkah-langkah sebelumnya:

• --apple-team-id: ID Tim Apple Anda
• --apple-key: Jalur ke file kunci yang diunduh Anda .p8 file kunci
• --apple-key-id: ID Pengeluarnya Apple Anda
• --apple-issuer-id: ID Penerbit Apple Anda
• --certificate: Jalur ke file yang telah diekspor .p12 : File
• --ios-provisioning-profile: Jalur ke file kunci yang diunduh Anda .mobileprovision file (ID aplikasi bundle otomatis ditentukan untuk profil tunggal)

Jika semuanya berjalan lancar, Anda akan melihat output berikut:

Gagal autentikasi Apple? Sinkronkan jam Anda

Jika kunci App Store Connect API 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.

Lihatlah Panduan troubleshooting pembuat setup CI/CD (__CAPGO_KEEP_0__ Aksi)

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

# 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

Rahasia GitHub harus berupa nilai satu baris. tr -d '\n' menghilangkan baris pemisah 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 Penerbit Apple
APPLE_ISSUER_ID	ID Penerbit dari Apple key, ID Penerbit 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)	Your .p12 kata sandi jika telah ditetapkan selama ekspor

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 }}

Saran

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

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

Kirimkan ke ulasan App Store

Jalur pembangunan App Store biasa mengunggah pembangunan ke App Store Connect/TestFlight. Jika rilis CI Anda juga harus menambahkan pembangunan yang diproses TestFlight ke versi App Store dan mengajukannya untuk Tinjauan App, kirimkan --submit-to-store-review Jendela terminal

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

ini memerlukan kunci kredential App Store Connect API (APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, and APP_STORE_CONNECT_TEAM_ID). App-specific password uploads and ad_hoc Tidak dapat mengirimkan distribusi 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 persetujuan Apple, atau --no-ios-automatic-release untuk menunggu rilis manual. --ios-testflight-groups versi masih tersedia untuk distribusi beta eksternal, tetapi tidak diperlukan untuk pengajuan ulasan App Store.

Mode Distribusi Ad-Hoc

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

Pertimbangan

Distribusi ad-hoc bukanlah opsional seperti Enterprise (Dalam Ruang) distribusi. Distribusi Enterprise memerlukan akun pengembang Apple Enterprise yang terpisah dan menggunakan profil pengaturan yang berbeda. Capgo saat ini mendukung app_store dan ad_hoc mode saja.

Kapan menggunakan mode ad-hoc

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

Persyaratan

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

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

Catatan

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

Peringatan

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

Membuat profil pengaturan ad-hoc

Ikuti langkah-langkah yang sama seperti Profil pengaturantetapi pada langkah 5, pilih Ad Hoc Ad Hoc sebaliknya dari:

1. App Store Profesi Pengembang Apple
2. Klik tombol + Klik tombol
3. Pilih Ad Hoc dan klik Lanjutkan
4. Pilih aplikasi dan sertifikat distribusi Anda
5. Pilih perangkat yang ingin Anda daftarkan
6. Berinama dan unduh 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 Perlu.

Membuat 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 build ad-hoc

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

Trik

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

Aplikasi dengan Ekstensi (Pengaturan Tanda Tangan Multi-Tujuan)

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

Bab 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 profil pengaturan file-nya. Profil CLI:

1. Membaca setiap file mobileprovision
2. Mengextract profil secara otomatis dari plist yang diintegrasikan
3. Mengenkripsi file menggunakan Base64
4. Menyimpan semua sebagai kredential tunggal CAPGO_IOS_PROVISIONING_MAP Tips

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 mengonversi kreditensi profil tunggal Anda ke versi 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 (penggabungan penambah)

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

Tips

Pilih update (bukan saveUntuk menambahkan profil ke kredit yang sudah ada. update hanya ketika mengatur semua kredit dari awal. save Hanya ketika mengatur semua kredit dari awal.

Troubleshooting

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 pengembang telah dibuat. Profil pengembang lama belum termasuk kemampuan baru.

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

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

Hal ini seharusnya dapat memperbaiki masalah.

Masalah lain

Jika Anda mengalami masalah dengan Capgo Build Nativ, mengonfigurasi kredit atau membangun aplikasi, silakan hubungi kami melalui dukungan.

Teruskan dari Build iOS

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