Ad Hoc Distribution — apa itu, batasan pengujian iOS

Apa itu Ad Hoc Distribution?

Ad Hoc Distribution adalah metode distribusi aplikasi iOS yang tersedia untuk semua peserta Apple Developer Program ($99/tahun). Metode ini memungkinkan instalasi aplikasi langsung pada perangkat tanpa melalui moderasi App Store. Tujuan utama — pengujian sebelum publikasi: pengembang, penguji, dan klien dapat menginstal aplikasi di perangkat mereka sebelum rilis resmi.

Ad Hoc Distribution menggunakan Provisioning Profile yang berisi daftar UDID perangkat yang diizinkan. Saat menandatangani aplikasi, Xcode atau Fastlane membuat file IPA yang hanya dapat diinstal pada perangkat dari daftar ini. Setiap UDID ditambahkan melalui Apple Developer Portal, dan jumlah total tidak boleh melebihi 100 perangkat per akun pengembang.

Menurut data Apple (2025), Ad Hoc Distribution tetap digunakan untuk pengujian pra-rilis ketika aplikasi belum melalui moderasi App Store, tetapi sudah perlu ditunjukkan kepada klien atau diuji pada perangkat nyata. Namun, Apple merekomendasikan penggunaan TestFlight untuk pengujian beta skala besar, meninggalkan Ad Hoc untuk kelompok kecil dan kasus khusus.

Bagaimana cara kerja distribusi Ad Hoc?

Distribusi Ad Hoc bekerja melalui mekanisme instalasi OTA (Over-The-Air) atau melalui iTunes/Finder. Pengembang membuat Ad Hoc Provisioning Profile dengan UDID yang dipilih, menandatangani aplikasi dengan profil ini, dan mengekspor file IPA. Pengguna menginstal aplikasi melalui Safari melalui tautan atau melalui Finder di macOS.

Secara teknis, Ad Hoc Distribution mencakup beberapa tahap. Pertama, administrator mengumpulkan UDID perangkat pengujian — setiap UDID adalah pengidentifikasi unik 40 karakter perangkat iOS. Kemudian UDID ditambahkan ke Apple Developer Portal, Provisioning Profile dibuat, dan IPA yang ditandatangani dihasilkan. Masa berlaku profil Ad Hoc adalah satu tahun, setelah itu aplikasi berhenti terbuka.

# Fastlane — otomatisasi distribusi Ad Hoc
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Untuk menginstal aplikasi Ad Hoc, pengguna harus mempercayai sertifikat pengembang di perangkat mereka. Untuk ini, di pengaturan iOS, buka „Umum“ → „VPN & Manajemen Perangkat“ → „Profil“ dan tekan „Percaya“. Tanpa langkah ini, aplikasi tidak akan berjalan.

Pendaftaran UDID dan batasan 100 perangkat

UDID (Unique Device Identifier) adalah pengidentifikasi unik setiap perangkat iOS. Untuk Ad Hoc Distribution, perlu mengumpulkan UDID semua perangkat pengujian dan menambahkannya ke Apple Developer Portal. Jumlah maksimum adalah 100 perangkat per akun pengembang per tahun. Batasan ini berlaku untuk semua aplikasi pengembang, bukan untuk setiap aplikasi secara terpisah.

Batasan 100 perangkat direset pada akhir tahun kalender — reset terjadi pada 1 Januari. Namun, Apple merekomendasikan untuk pengujian skala besar menggunakan TestFlight, yang mendukung hingga 10.000 penguji eksternal. Ad Hoc Distribution sejak 2022 tetap relevan untuk kasus di mana aplikasi belum melalui Beta App Review atau ketika pengujian memerlukan akses ke file IPA asli.

Pengaturan Ad Hoc Distribution

Pengaturan Ad Hoc Distribution dilakukan melalui Apple Developer Portal dan Xcode. Prosesnya mencakup pendaftaran perangkat, pembuatan Provisioning Profile, penandatanganan aplikasi, dan ekspor IPA untuk distribusi. Untuk pengembangan tim, disarankan menggunakan Fastlane atau otomatisasi melalui CI/CD.

1. Kumpulkan UDID perangkat pengujian melalui udid.io atau profil konfigurasi
2. Tambahkan UDID di Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Buat Ad Hoc Provisioning Profile untuk Bundle ID yang diinginkan, sertakan perangkat terdaftar
4. Tandatangani aplikasi dengan profil Ad Hoc di Xcode: Product → Archive → Distribute Ad Hoc
5. Ekspor file IPA dan sebarkan tautan melalui server OTA atau Firebase App Distribution
6. Pengguna: buka tautan di perangkat, instal aplikasi, percayai sertifikat di pengaturan

Untuk menyederhanakan proses, digunakan layanan distribusi: Firebase App Distribution, Microsoft App Center, atau BuddyBuild. Layanan ini secara otomatis mengelola UDID, membuat profil Ad Hoc, dan mengirim undangan kepada penguji. Firebase App Distribution juga terintegrasi dengan pipeline CI/CD melalui Gradle atau Fastlane.

Nuansa penting — pembaruan UDID. Jika perlu menambahkan perangkat baru ke profil, Anda harus membuat ulang Provisioning Profile dan menandatangani ulang aplikasi. Perangkat yang sudah menginstal aplikasi akan terus menggunakannya hingga profil kedaluwarsa (1 tahun). Setelah itu, diperlukan instalasi ulang dengan profil baru.

Ad Hoc vs TestFlight dan Enterprise

Ad Hoc Distribution hanyalah salah satu dari tiga cara mendistribusikan aplikasi iOS tanpa App Store. TestFlight (gratis, hingga 10.000 penguji eksternal) dan Enterprise Distribution (tanpa batasan perangkat, untuk aplikasi perusahaan) menyelesaikan tugas serupa dengan batasan dan persyaratan yang berbeda.

TestFlight adalah metode yang disukai Apple untuk pengujian beta. Metode ini tidak memerlukan pengumpulan UDID, mendukung hingga 100 penguji internal dan 10.000 penguji eksternal, secara otomatis mengelola versi, dan menyediakan analitik instalasi. Namun, TestFlight memerlukan Beta App Review untuk penguji eksternal, yang dapat memakan waktu 1–2 hari. Ad Hoc Distribution tidak memerlukan moderasi sama sekali.

Enterprise Distribution cocok untuk aplikasi perusahaan dengan jumlah perangkat tidak terbatas, tetapi memerlukan pendaftaran di Apple Developer Enterprise Program ($299/tahun) dengan nomor D-U-N-S. Ad Hoc tersedia untuk semua peserta program standar ($99/tahun) dan tidak memerlukan konfirmasi hukum perusahaan. Untuk tim dan proyek kecil, Ad Hoc tetap menjadi cara termudah untuk mendistribusikan tanpa App Store.