未署名 IPA とローカル実機テスト

用途と重要な制限

ローカルインストールは開発・短期検証専用で、本番配信ではありません。未署名 IPA は iPhone に直接インストールできず、対象端末と entitlement を許可する証明書とプロビジョニングプロファイルで署名する必要があります。

無料 Personal Team の制限:

  • 最大 10 App ID(7 日で失効)
  • 最大 3 台(7 日で失効)
  • 端末ごとに最大 3 Personal Team App
  • プロファイルは 7 日で失効し、再ビルド/再署名/再インストールが必要
  • App Store Connect、TestFlight、Ad Hoc、App Store 配信は不可
  • 一部の管理対象サービス・entitlement は利用不可

継続的なチームテストには TestFlight、既知端末には Ad Hocを使用してください。

推奨:Xcode Personal Team

iOS プロジェクトを開ける場合、サードパーティで既存 IPA を署名するより Apple の開発フローを推奨します。

  1. 対応 Mac に現行 Xcode をインストール。
  2. Apple Account で Xcode にサインイン。
  3. Signing & Capabilities で Personal Team を選択。
  4. iPhone/iPad を接続して Mac を信頼し、要求されたら Developer Mode を有効化。
  5. 実機を run destination にしてビルド。
  6. 7 日の失効後に再プロビジョニングして再インストール。

MeDo が未署名 IPA のみ提供する場合、次のリスクを確認してから進みます。

MeDo で未署名 IPA を生成

パッケージング画面でローカルデバッグとバージョンを選びます。

無料ローカルデバッグ

App 名、Bundle ID、Version / Build Number、配信方法を確認し、パッケージング開始を選びます。3–8 分は目安です。

ビルド設定ステップ 1 ビルド設定ステップ 2

IPA のダウンロードと保護

結果画面または App 詳細のインストールパッケージのエクスポートからダウンロードします。

IPA ダウンロード 1 IPA ダウンロード 2

非公開 endpoint、テスト資格情報、未公開素材、独自コードを含む場合は機密として扱い、承認済み経路で転送し、古いビルドを削除します。

サードパーティ署名ツールを使う前に

Sideloadly、AltStore Classic、AltServer はサードパーティ製品であり、Apple の配信サービスや MeDo のコンポーネントではありません。Apple Account で Personal Team の署名アセットを作成または選択し、端末向けに IPA を再署名してインストールします。どちらの方法も無料 Personal Team の制限を回避したり、非対応 entitlement を有効にしたりすることはできません。いずれかの方法を選ぶ前に:

  • 組織・地域のセキュリティポリシーで許可されているか確認。
  • 正規サイトから取得してインストーラーを検証。
  • アカウント資格情報、token、端末 ID、証明書、App ファイルへのアクセス範囲を理解。
  • 支払情報や個人情報のない専用開発 Apple Account を優先。
  • 組織の Account Holder や本番 App Store Connect API Key は絶対に提供しない。
  • 2 要素認証を維持し、使用後にセッションを確認。
  • 出所不明な共有署名サービスを使わない。

選択肢 1:Sideloadly

デスクトップツールで IPA を直接署名・インストールする場合は Sideloadly を使用します。

  1. 公式サイトから Sideloadly をダウンロードし、Windows または macOS にインストールします。Windows の公式セットアップでは、Microsoft Store 版ではなく Apple の直接ダウンロード版 iTunes / iCloud が必要です。
  2. ロックを解除した iPhone / iPad を USB で接続してこのコンピュータを信頼を承認し、Sideloadly の iDevice 欄で正しい端末を選択します。
  3. MeDo で生成した IPA を Sideloadly にドラッグするか、IPA 欄から選択します。
  4. 承認済みの開発用 Apple Account のメールアドレスを入力し、Start を選択します。
  5. パスワードと 2 要素認証を完了します。Sideloadly が Apple で認証し、開発用署名アセットを準備して IPA を再署名し、選択した端末にインストールします。
  6. App を開く前に、下記の初回起動と更新の確認を完了します。

無料 Apple Account では署名済み App は 7 日で失効します。同じ Apple Account で同じ IPA を再署名できます。Sideloadly は App を自動更新の対象にできるため、Start の前に設定を確認し、セキュリティポリシーでバックグラウンド daemon が禁止されている場合は無効にします。更新には USB を使うか、最初に USB でペアリングして Finder または iTunes で Wi-Fi 同期を有効にし、コンピューターと端末を同じネットワークに接続します。

選択肢 2:AltStore Classic と AltServer

使用するのは AltStore Classic であり、AltStore PAL ではありません。AltStore Classic は任意の IPA をインストールでき、Windows または macOS 上の AltServer と連携します。AltStore PAL は任意の IPA をインストールできません。

  1. 公式の Windows または macOS ガイドに従って AltServer をインストールします。Windows では、Microsoft Store 版ではなく Apple の直接ダウンロード版 iTunes / iCloud を使用します。
  2. 端末を接続してロックを解除し、コンピューターを信頼して、iTunes または Finder で Wi-Fi 同期を有効にします。
  3. AltServer メニューで Install AltStore、対象端末の順に選択し、承認済みの開発用 Apple Account で認証します。
  4. 端末で開発者 ID を信頼し、下記の手順で Developer Mode を有効にします。
  5. AltServer を実行したまま、端末を USB または同じ Wi-Fi ネットワークで接続します。MeDo IPA を「ファイル」App に保存し、AltStore → My Apps+ を選択して IPA を指定します。
  6. Apple Account の確認を完了し、AltStore による署名とインストールを待ちます。
  7. 7 日の失効前に AltServer を利用できる状態にして、AltStore で Refresh All を実行します。AltStore 自体が無料アカウントの 3 個の有効なサイドロード App 枠のうち 1 個を使用します。

初回起動と更新

表示内容は署名 ID、iOS、端末管理状態で異なります。

  1. iOS 16 以降では、設定 → プライバシーとセキュリティ → デベロッパモードを開き、Developer Mode を有効にします。
  2. 設定 → 一般 → VPN とデバイス管理(またはプロファイルとデバイス管理)を開き、Apple Account に対応する開発者 ID を選択して信頼を承認します。
  3. Apple 証明書検証が必要な間はオンラインにする。
  4. 表示された開発者が意図したアカウント/チームか確認。

自社の正規 Apple Developer Enterprise Program ビルドでない限り、「Enterprise App」の信頼手順を使わないでください。Personal Team / Ad Hoc は Enterprise App ではありません。

トラブルシューティング

App が利用できなくなった

7 日の Personal Team プロファイルが失効した可能性があります。Sideloadly で IPA を再署名するか、AltServer を起動して AltStore で Refresh All を実行します。AltStore 自体が失効した場合は、削除せずに AltServer から再インストールします。

ツールが端末を検出しない

  • 端末のロックを解除して USB を接続し直し、コンピューターと端末の両方で信頼を承認します。
  • Windows では、選択したツールに必要な Apple 端末サポートコンポーネントがインストール済みか確認します。
  • Wi-Fi を使う場合は端末の Wi-Fi 同期を有効にし、コンピューターと端末を同じネットワークに接続します。
  • AltStore では AltServer が実行中で到達可能か確認します。ネットワークが端末検出を遮断する場合は USB を使います。

署名に失敗

  • Apple Account と 2 要素認証を確認。
  • 端末・App ID 制限を確認。
  • Bundle ID の重複を確認。
  • 非対応 entitlement を削除するか有料プログラムへ移行。

インストール・起動に失敗

  • プロファイルに対象端末が含まれるか確認。
  • Developer Mode と端末の信頼を確認。
  • iOS バージョンとアーキテクチャへの対応を確認。
  • 初回検証中はオンラインにする。
  • Bundle ID / entitlement 変更後に再署名。

参考資料