Xcode & iOS Signing untuk Flutter

Artikel ini melengkapi “Install Flutter (manual)” khusus sisi iOS/macOS. Target: proyek Flutter dapat berjalan di iOS simulator dan siap untuk proses signing ketika butuh rilis/TestFlight.

1) Install Xcode & Command Line Tools

Install Xcode dari App Store.
Install CLT:

xcode-select --install

Setujui lisensi (jika diminta):

sudo xcodebuild -license

Buka Xcode sekali agar komponen awal terinisialisasi.

2) CocoaPods (Dependency iOS)

Flutter iOS menggunakan CocoaPods. Pastikan Ruby dan bundler berjalan baik.

Install CocoaPods:

sudo gem install cocoapods
pod --version

Jika ada isu permission, pertimbangkan Homebrew Ruby atau mengaktifkan brew install cocoapods.

3) Jalankan di iOS Simulator

flutter create hello_ios
cd hello_ios
flutter run -d ios

Jika simulator belum ada, buka Xcode → Window → Devices and Simulators → tambah simulator (mis. iPhone 15).

4) Konsep Signing: Certificates & Profiles

Apple Developer Account diperlukan untuk rilis ke perangkat/Store.
Buat App ID (Bundle Identifier unik, mis. com.org.app).
Certificates:
- Development: untuk install di device debug.
- Distribution: untuk App Store/TestFlight.
Provisioning Profiles:
- Development Profile: pairing App ID + Development cert.
- Distribution Profile: pairing App ID + Distribution cert.

Semua dikelola via Apple Developer portal atau otomatis lewat Xcode.

5) Konfigurasi di Proyek Flutter

Buka workspace iOS:

open ios/Runner.xcworkspace

Pada target Runner → Signing & Capabilities:
- Pilih Team (Apple Developer).
- Aktifkan “Automatically manage signing” (dipermudah oleh Xcode).
- Pastikan Bundle Identifier sesuai App ID.

Build rilis (untuk pengujian):

flutter build ios --release

Untuk distribusi/TestFlight, proses archive di Xcode:

Product → Archive → Distribute App → App Store Connect → Upload.

6) Fastlane (Opsional)

Automasi signing & upload:

brew install fastlane

Di direktori ios/, inisialisasi Fastlane dan konfigurasi lane untuk build/upload. Ideal untuk CI.

Troubleshooting Umum

codesign failed
- Cek certificate & profile, pastikan Team dan Bundle Identifier tepat.
Provisioning profile not found
- Aktifkan “Automatically manage signing” atau unduh profile yang benar.
pod install gagal
- Jalankan pod repo update, atau rm -rf ios/Pods ios/Podfile.lock && pod install.
CFBundleIdentifier salah
- Samakan di Runner (Xcode) dan konfigurasi Firebase/entitlements jika ada.

Ringkasan

Dengan Xcode, CLT, CocoaPods, serta signing yang benar (certificates + profiles), proyek Flutter Anda siap jalan di iOS simulator maupun proses distribusi ke TestFlight/App Store.