Ad Hoc Distribution — その概要、iOSテストの制限

Ad Hoc Distributionとは？

Ad Hoc Distributionは、すべてのApple Developer Programメンバー（$99/年）が利用できるiOSアプリケーション配布方法です。App Storeの審査を経由せずにデバイスに直接アプリをインストールできます。主な目的はリリース前のテストです。開発者、テスター、クライアントは公式リリース前に自分のデバイスにアプリをインストールできます。

Ad Hoc Distributionは、許可されたデバイスのUDIDリストを含むProvisioning Profileを使用します。アプリに署名する際、XcodeまたはFastlaneはIPAファイルを作成し、このリストのデバイスにのみインストールできます。各UDIDはApple Developer Portalを通じて追加され、開発者アカウントあたり合計100台を超えることはできません。

Apple（2025）によると、Ad Hoc DistributionはアプリがまだApp Storeの審査を通過していないが、クライアントに表示したり実際のデバイスでテストしたりする必要がある場合のリリース前テストに引き続き需要があります。ただし、Appleは大規模なベータテストにはTestFlightの使用を推奨しており、Ad Hocは小規模グループや特別なケースに残しています。

Ad Hoc配布の仕組み

Ad Hoc配布は、OTA（Over-The-Air）インストールまたはiTunes/Finderを介して機能します。開発者は選択したUDIDでAd Hoc Provisioning Profileを作成し、このプロファイルでアプリに署名し、IPAファイルをエクスポートします。ユーザーはSafariのリンクから、またはmacOSのFinderを介してアプリをインストールします。

技術的には、Ad Hoc配布にはいくつかの段階が含まれます。最初に、管理者がテストデバイスのUDIDを収集します。各UDIDはiOSデバイスの一意の40文字の識別子です。次に、UDIDがApple Developer Portalに追加され、Provisioning Profileが作成され、署名済みIPAが生成されます。有効期限はAd Hocプロファイルで1年で、その後アプリは開かなくなります。

# Fastlane — Ad Hoc配布を自動化
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Ad Hocアプリをインストールするには、ユーザーはデバイスで開発者の証明書を信頼する必要があります。iOSの設定で「一般」→「VPNとデバイス管理」→「プロファイル」に進み、「信頼」をタップします。この手順がないと、アプリは起動しません。

UDID登録と100台の制限

UDID（Unique Device Identifier）は、各iOSデバイスの一意の識別子です。Ad Hoc配布では、すべてのテストデバイスのUDIDを収集し、Apple Developer Portalに追加する必要があります。最大は開発者アカウントあたり年間100台です。この制限は、アプリごとではなく開発者のすべてのアプリに適用されます。

100台の制限は暦年の終わりにリセットされます — リセットは1月1日に行われます。ただし、Appleは大規模なテストには最大10,000人の外部テスターをサポートするTestFlightの使用を推奨しています。Ad Hoc Distributionは2022年以降、アプリがまだBeta App Reviewを通過していない場合や、テストに元のIPAファイルへのアクセスが必要な場合に関連性を維持しています。

Ad Hoc Distributionの設定

設定はApple Developer PortalとXcodeを介して行います。プロセスには、デバイスの登録、Provisioning Profileの作成、アプリへの署名、配布用のIPAのエクスポートが含まれます。チーム開発では、FastlaneまたはCI/CDによる自動化の使用をお勧めします。

1. udid.ioまたは構成プロファイルを介してテストデバイスのUDIDを収集
2. Apple Developer PortalにUDIDを追加 → Certificates, Identifiers & Profiles → Devices
3. 必要なBundle ID用のAd Hoc Provisioning Profileを作成し、登録済みデバイスを含める
4. XcodeでAd Hocプロファイルを使用してアプリに署名：Product → Archive → Distribute Ad Hoc
5. IPAファイルをエクスポートし、OTAサーバーまたはFirebase App Distributionを介してリンクを配布
6. ユーザー：デバイスでリンクを開き、アプリをインストールし、設定で証明書を信頼

プロセスを簡素化するために、配布サービスを使用します：Firebase App Distribution、Microsoft App Center、BuddyBuildなど。これらのサービスはUDIDを自動的に管理し、Ad Hocプロファイルを作成し、テスターに招待を送信します。Firebase App DistributionはGradleまたはFastlaneを介してCI/CDパイプラインとも統合されます。

重要なニュアンス — UDIDの更新。プロファイルに新しいデバイスを追加する必要がある場合、Provisioning Profileを再作成し、アプリに再署名する必要があります。すでにアプリをインストールしたデバイスは、プロファイルの有効期限（1年）まで引き続き使用できます。その後は、新しいプロファイルでの再インストールが必要です。

Ad Hoc vs TestFlightおよびEnterprise

Ad Hoc Distributionは、App StoreなしでiOSアプリを配布する3つの方法のうちの1つに過ぎません。TestFlight（無料、最大10,000人の外部テスター）およびEnterprise Distribution（デバイス制限なし、エンタープライズアプリ向け）は、異なる制限と要件で関連するタスクを解決します。

TestFlightはAppleがベータテストに推奨する方法です。UDIDの収集は不要で、最大100人の内部テスターと10,000人の外部テスターをサポートし、バージョンを自動的に管理し、インストール分析を提供します。ただし、TestFlightでは外部テスター向けにBeta App Reviewを通過する必要があり、これには1〜2日かかる場合があります。Ad Hoc Distributionには審査はまったく必要ありません。

Enterprise Distributionはエンタープライズアプリに適しており、デバイス数の制限はありませんが、D-U-N-S番号を使用したApple Developer Enterprise Program（$299/年）への登録が必要です。Ad Hocは標準プログラム（$99/年）のすべてのメンバーが利用でき、会社の法的確認は不要です。小規模なチームやプロジェクトにとって、Ad HocはApp Storeなしでの配布の最も簡単な方法であり続けています。