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

Prasyarat

• Akun Capgo (cukup dengan uji coba gratis untuk memulai)
• Aplikasi Anda sudah terdaftar di Capgo (jalankan bunx @capgo/cli@latest app add jika tidak)
• A komputer Mac dengan Xcode terpasang (mungkin bisa mengatur build di mesin linux/windows, tapi belum terdokumentasi)
• Akun pengembang Apple yang valid ($99/tahun) (Anda harus memiliki hak admin atau hak pemilik di akun pengembang Apple)
• Aplikasi Anda harus dapat membangun dengan sukses melalui Xcode
• Aplikasi Capacitor
• Sebuah 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: 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
• Gunakan akun yang dapat mengakses baik Apple Developer dan App Store Connect untuk sertifikat, catatan aplikasi, API kunci, dan TestFlight
• Pastikan ID paket akhir Anda selesai sebelumnya. Mengubahnya nanti biasanya berarti melakukan setup App Store ulang
• Rencanakan item App Store Connect ini sebelum App Review: URL dukungan, URL kebijakan privasi, peringkat usia, screenshot, kinerja ekspor, dan detail kontak App Review

Catatan

Sumber referensi resmi yang berguna:

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

Peringatan

Pengembang 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 dan iPadOS 26 SDK atau lebih baru.

Dianjurkan: pendaftaran otomatis

Anda tidak perlu melakukan semua ini secara manual. Pendaftaran Capgo membuat dan mengkonfigurasi kunci tanda tangan iOS (sertifikat distribusi + profil pengaturan) untuk Anda — ini adalah jalur yang dianjurkan:

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

Walkthrough 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 kerja.

Build manual pertama

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

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

Sebelum kita dapat memulai, Anda harus memiliki sertifikat distribusi 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. Pergi ke Accounts

4. Cari Akun Apple yang ditambahkan ke Akun Pengembang Apple

5. Temukan tim yang akan Anda gunakan untuk mengdeploy 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 membuat sertifikat baru. Saya tidak akan membahas itu dalam tutorial ini

   1. Klik pada tombol + tombol dan kemudian di 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.

Pembangunan 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 product -> archive tombol.

   

3. Tunggu proses pembangunan selesai

4. Klik pada tombol Distribute App tombol distribusi Xcode

   

5. sebagai metode distribusi dan klik tombol TestFlight Internal Only tombol distribusi internal TestFlight Xcode Distribute Metode distribusi aplikasi internal Xcode

   

6. Isi bidang-bidang berikut:

   tombol

   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 hingga upload selesai

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

10. Klik pada tombol Done tombol

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

1. Tambahkan diri kamu 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. context: Halaman/area: Halaman solusi aplikasi contoh. Peran: Label UI singkat atau item navigasi. Dilihat di: komponen solusi/SolutionAppExample.astro. Kunci pesan `solution_app_examples_rating` (Rating Contoh Aplikasi Solusi).
5. Siapkan tangkapan layar yang sesuai dengan perangkat yang kamu dukung

Tambahkan detail kontak App Review dan kredential uji sebelum pengajuan produksi

Marilah kita mulai dengan yang pertama:

1. Judul bagian “Mengambahkan diri kamu ke TestFlight” Pergi ke halaman Halaman 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 Aplikasi

5. Pilih Aplikasi App Store Connect

6. Tombol Uji Coba App Store Connect TestFlight Tombol Uji Coba App Store Connect

7. Klik pada tombol Internal Testers plus Tombol

8. Buat kelompok baru

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

   

9. Klik pada Invite testers Tombol

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 harus melihat diri Anda dalam grup.

    

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

Mengatur Informasi Kepatuhan

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

1. Kamu bisa melakukannya secara manual setiap kali kamu membangun aplikasi.
2. Kamu bisa mengonfigurasi file plist kamu untuk secara otomatis menetapkan nilai ini ke false.

Mulai dengan yang 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 keselarasandan klik pada Manage

4. Pilih opsi yang paling sesuai dengan aplikasi Anda

   Untuk saya, ini adalah nonetetapi 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. Terbuka di Info.plist file

2. Tambahkan kunci berikut:

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

3. Simpan file

Perhatian

Ini adalah dokumentasi resmi Apple tentang cara memberitahu Apple tentang kewajiban Anda untuk mengikuti regulasi enkripsi ekspor.

Menginstal aplikasi TestFlight dan menerima undangan

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

1. dari App Store pada perangkat iOS/iPadOS Anda 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.
2. Mengenai menerima undangan, Anda akan menerima surel dari Apple dengan tautan untuk menerima undangan.

Buka surel dari Apple dengan tautan untuk menerima undangan

Klik pada

1. tombol

2. button View in TestFlight button

3. Klik pada tombol Install Tombol

4. Instal aplikasi di 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 dan klik Open Selamat 🎉 Anda telah menerima undangan untuk menguji aplikasi Anda di TestFlight. Sekarang, Anda dapat mengonfigurasi __CAPGO_KEEP_0__ Build Natively untuk membangun dan mengirimkan aplikasi ke TestFlight.

Congratulations 🎉 You have accepted the invitation to test your app in TestFlight. Now, you can configure Capgo Native Build to build and submit your app to TestFlight.

Mengatur Capgo Pembangunan Nativ

Ada beberapa hal yang perlu Anda atur dalam Capgo Pembangunan Nativ untuk dapat membangun dan mengirimkan aplikasi ke TestFlight. Berikut adalah daftar hal yang akan Anda lewatkan ke 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 Key File App Store Connect Anda (“.p8 file)
--apple-key-id	ID Kunci API Key App Store Connect Anda
--apple-issuer-id	ID Pengirim 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. Mencari informasinya cukup mudah.

1. Pergi ke Akun Pengembang Apple dan gulirkan ke bawah

2. Temukan lokasi ID Tim di akun pengembang Team ID

   

Lokasi kunci Apple, ID kunci Apple, dan ID penerbit Apple

Sekarang, mari kita lanjutkan ke kunci Apple.

macOS: biarkan Capgo membuat kunci ini untuk Anda

Pada macOS, capgo build init mungkin membuat kunci App Store Connect API ini 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 — tanpa menyalin-pisah. Langkah-langkah manual di bawah ini adalah alternatif (dan jalur pada Windows atau Linux).

1. Pergi ke Halaman pengguna dan akses App Store Connect

   Catatan

   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 pojok kanan atas
   2. Klik tim yang ingin Anda gunakan

3. Klik pada Integrations Tombol

4. Temukanlah issuer

   Peringatan

   Ini PERLU DI SIMPAN - Anda akan membutuhkannya nanti

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

5. Tombol tambah kunci App Store Connect

6. __CAPGO_KEEP_0__ App manager dan klik pada tombol Generate tombol

7. Simpan ID kunci

   Pertimbangan

   Ini PERLU DIHIMPAUNGAN - Anda akan membutuhkannya nanti Salin ID kunci App Store Connect

   

8. Pertimbangan

   Hatihati

   Perlu diingat IS TO BE SAVED - Anda memerlukan hal ini nanti

   Peringatan

   JANGAN PERNAH BERBAGI KUNCI DENGAN SIAPA PUN - HANYA GUNAKAN DALAM CAPGO CLI

   

   

Hari ini Anda telah menciptakan kunci Apple, ID kunci Apple, dan ID penerbit Apple.

Sertifikat

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

Namun, Apple dalam kebijakan mereka yang tidak terbatas, memutuskan bahwa cara Anda mengexport sertifikat sangat berbeda dari cara Anda membuatnya

1. Buka Akses Keychain

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

2. Pilih kategori dan klik pada tombol login buka My Certificates untuk membuka

3. Cari 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

   1. Pilihlah 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:

   • Melewati kata sandi (direkomendasikan untuk kesederhanaan): Klik OK Tidak memasukkan kata sandi
   • Membuat kata sandi: Jika Anda ingin melindungi sertifikat dengan kata sandi, Anda dapat membuatnya di sini. File yang dilindungi kata sandi sepenuhnya didukung oleh __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - cukup berikan kata sandi menggunakan opsi ketika menjalankan perintah konfigurasi. .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password Pilihlah format file yang tepat

   

7. Ketika diminta untuk memasukkan kata sandi “kunci keychain login”, masukkan kata sandi yang Anda gunakan untuk masuk ke Mac Anda

   Masukkan kata sandi yang Anda gunakan untuk masuk ke Mac Anda. Kemudian, klik pada Allow tombol.

   

Selamat! 🎉 Anda telah diekspor sertifikat.

Profil Pengaturan

Page/area: Pembangun Capgo / produk halaman native cloud build. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman native-build.astro. Pesan kunci `native_build_v2_wiz_ios_s3_l` (Native Build V2 Wiz Ios S3 L).

1. Judul Bagian “Profil Pengaturan” Sekarang, Anda sudah siap untuk diekspor profil pengaturan. Saya berjanji, ini adalah hal terakhir yang Anda perlu dapatkan dari Apple.

2. Pergi ke halaman ‘Apple Developer Profiles’ (Profil Pengembang Apple).

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

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

   

4. Klik pada tombol + Tombol tambah profil Apple Developer

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

   

6. Pilih Aplikasi yang Anda Inginkan untuk Dibangun

   Cari Aplikasi Anda di Dropdown dan Klik pada Tombol Continue Tombol

   

7. Pilih Sertifikat Distribusi yang Benar

   Pilih Sertifikat yang Anda Export di 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 Export. Kemudian Periksa Tanggal Kadaluarsa.

   

8. Berinama Profil

   Berikan nama profil dan klik pada tombol Generate tombol

   Tip

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

   

9. Unduh profil

   Klik pada tombol untuk mengunduh profil Download Peringatan

   File ini

   tombol untuk mengunduh profil UNTUK DISIMPAN - Anda akan membutuhkannya nanti

   

Selamat 🎉 Anda telah memiliki segala sesuatu yang diperlukan untuk mengonfigurasi Capgo Native Build.

Peringatan

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

Menggunakan perintah pengaturan

Anda telah melakukannya! Anda telah memiliki segala sesuatu yang diperlukan 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 pengganti

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

• --apple-team-id: ID Tim Apple Anda
• --apple-key: Jalur ke file Apple Anda yang diunduh .p8 : File kunci Apple Anda
• --apple-key-id: ID Pengirim Apple Anda
• --apple-issuer-id: Jalur ke sertifikat Anda yang diekspor
• --certificate: Sertifikat Anda .p12 : Jalur ke file Apple Anda yang diunduh
• --ios-provisioning-profile__CAPGO_KEEP_0__ .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 API Apple 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 pembangun untuk langkah-langkah sinkronisasi jam. Konfigurasi CI/CD (__CAPGO_KEEP_0__ Aksi)

Judul bagian “Konfigurasi CI/CD (GitHub Aksi)”

langkah-langkah sebelumnya ID Tim, Kunci Apple, ID kunci Apple, dan ID penerbit Apple, Sertifikat, dan Profil Pengaturan, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

Seluruh yang Anda butuhkan untuk CI/CD sudah ada. Bagian ini hanya menjelaskan cara mengirimkan nilai-nilai tersebut sebagai rahasia aksi __CAPGO_KEEP_0__ dan variabel lingkungan.

# 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 berupa nilai satu baris. tr -d '\n' menghilangkan baris-baris baca 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 Penerbit Apple
APPLE_ISSUER_ID	ID Penerbit dari Kunci Apple, 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 Jika diatur selama ekspor	3) Gunakan variabel lingkungan di workflow __CAPGO_KEEP_0__ Anda di Actions .p12 Judul bagian “3) Gunakan variabel lingkungan di workflow __CAPGO_KEEP_0__ Anda di Actions”

3) Use env vars in your GitHub Actions workflow

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

Trik

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

Melakukan pembangunan

Sekarang, Anda sudah siap untuk menjalankan pembangunan 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.

Kirimkan ke Ulasan App Store

Jalur pembangunan App Store biasa mengunggah pembangunan ke App Store Connect/TestFlight. Jika rilis CI Anda juga harus menempelkan pembangunan yang diproses TestFlight ke versi App Store dan mengirimkannya untuk Ulasan App, tambahkan --submit-to-store-review 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

Persyaratan ini adalah kunci kredensial App Store Connect API (“APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT, dan APP_STORE_CONNECT_TEAM_ID). Kata sandi upload aplikasi khusus dan ad_hoc penyebaran tidak dapat mengirimkan pembangunan untuk ulasan. --store-release-name Versi App Store; jika tidak ada, Capgo membaca MARKETING_VERSION dari proyek Xcode. --store-release-notes adalah teks fallback App Store Apa Baru, dan setiap --store-release-notes-locale "locale=notes" masuk 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 masih tersedia untuk distribusi beta eksternal, tetapi tidak diperlukan untuk pengajuan ulasan App Store.

Pengaturan Distribusi Ad-Hoc

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

Catatan

Distribusi ad-hoc adalah bukan tidak sama dengan Enterprise (Dalam Ruang) distribusi. Distribusi Enterprise memerlukan akun Apple Developer Enterprise terpisah dan menggunakan profil provisioning yang berbeda. Capgo saat ini mendukung app_store dan ad_hoc context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Kunci pesan `dan` (Dan).

hanya mode tertentu.

• Judul bagian “Kapan menggunakan mode ad-hoc”
• You don’t have or don’t want to use an App Store Connect API key
• Anda tidak memiliki atau tidak ingin menggunakan kunci __CAPGO_KEEP_0__ App Store Connect --output-upload Anda ingin mengumpulkan artefak pembangunan melalui

tanpa mengajukan ke App Store

Bangun aplikasi ad-hoc memiliki persyaratan yang lebih sedikit dibandingkan dengan bangun aplikasi App Store:

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

Peringatan

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

Peringatan

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

Membuat Profil Pengembangan Ad-Hoc

Ikuti langkah-langkah yang sama seperti Profil Pengaturan,tapi pada langkah 5, pilih Sertifikat Lokal alih daripada App Store:

1. Pergi ke Profil Pengembang Apple
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. 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-idatau --apple-issuer-id diperlukan.

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

CI/CD dengan pembangunan ad-hoc

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

github/aliran-kerja/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

Penting untuk 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.), setiap target ekstensi memerlukan profil pengaturan sendiri. Capgo mendukung hal ini melalui flag yang dapat diulang. --ios-provisioning-profile Contoh: Aplikasi + Ekstensi Berbagi

Section titled “Apps with Extensions (Multi-Target Signing)” is not translated as it is a title and not a text that needs to be translated.

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"

Masing-masing --ios-provisioning-profile flag mewakili ID paket ke profil pengaturan file-nya. Profil CLI:

1. Baca setiap file mobileprovision
2. Auto-ekstrak nama profil dari plist yang diintegrasikan
3. Meng-Base64-kan file
4. Menyimpan semuanya sebagai satu CAPGO_IOS_PROVISIONING_MAP kredensial

Trik

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

Migrasi dari Profil Tunggal

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

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

Ini mengubah kredensial profil tunggal kamu yang ada ke format baru dan menghapus kunci legasi ( CAPGO_IOS_PROVISIONING_MAP Setelah migrasi, tambahkan profil ekstensi dengan perintah (penjumlahan bergabung):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Tampilan 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"

Trik

Pakai update (bukan 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

Judul bagian ‘Pengaturan’

Judul bagian ‘Profil pengaturan tidak mencakup 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 tidak termasuk kemampuan baru tersebut.

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

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

Masalah ini seharusnya dapat diatasi.

Masalah lainnya

Jika Anda mengalami masalah dengan alasan apa pun, baik itu dengan Capgo Pembangunan Nativ, pengaturan kredit atau pembangunan aplikasi, silakan tidak ragu-ragu untuk menghubungi kami melalui dukungan.

Lanjutkan dari Pembangunan iOS

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