Thursday, August 10, 2023

Xcodeビルドエラー「Provisioning Profileが見つかりません」の根本原因と解決策
  /   No comments   

iOSアプリケーション開発の最終段階、実機での動作確認をしようとビルドボタンを押した瞬間、Xcodeに赤いエラーメッセージが表示される。多くの開発者が一度は経験するであろう悪名高いエラー、「a valid provisioning profile for this executable was not found」。このメッセージは、開発プロセスにおける最後の、そして最も厄介な関門の一つとして知られています。コードは完璧、ロジックも問題ないはずなのに、なぜアプリはデバイス上で起動しないのか。この問題の根源は、Appleの厳格なセキュリティとエコシステム管理の中核をなす「コード署名」の仕組みにあります。

この記事では、単にエラーを解消するための表面的な手順を羅列するのではなく、なぜこのエラーが発生するのかという根本的な原因を深掘りします。コード署名を構成する証明書、App ID、デバイス、そしてプロビジョニングプロファイルという4つの要素の関係性を理解することで、このエラーだけでなく、関連するあらゆる署名問題を体系的に解決する能力を身につけることを目指します。具体的な解決策を、初心者にも分かりやすいように、論理的な順序で詳細に解説していきます。

第1章：なぜエラーは起きるのか？コード署名の基本構造

このエラーメッセージを正しく理解するためには、まずAppleがiOSアプリの配布に際してなぜこのような複雑な仕組みを導入しているのかを知る必要があります。コード署名の目的は大きく分けて3つです。

  1. 開発者の身元保証： アプリがAppleに登録された信頼できる開発者によって作成されたものであることを保証します。
  2. アプリの完全性： アプリが開発者によって署名された後、第三者によって改ざんされていないことを保証します。
  3. 権限の管理： アプリがどのデバイスで、どのサービス（プッシュ通知、iCloudなど）を利用できるかを厳密に管理します。

この仕組みを実現するために、以下の4つの要素が密接に連携しています。プロビジョニングプロファイルは、これらすべてを結びつける「許可証」の役割を果たします。

1. 証明書 (Certificates)

証明書は「誰が」アプリを作成したのかを証明するデジタルな身分証明書です。開発者のMacのキーチェーンに保存されている「秘密鍵」と、Apple Developerポータルで発行される「公開鍵」のペアで構成されます。主な証明書は2種類あります。

  • Development Certificate (開発用証明書): 開発中に自身のデバイスにアプリをインストールするために使用します。
  • Distribution Certificate (配布用証明書): App Storeへの提出、Ad Hoc配布、またはIn-House（エンタープライズ）配布のためにアプリを署名する際に使用します。

この証明書がなければ、開発者としての身元をAppleに証明することができません。

2. App ID (Identifiers)

App IDは「何を」識別するのかを定義します。これはアプリケーションをAppleのエコシステム内で一意に識別するための文字列です。通常はcom.companyname.appnameのようなリバースドメイン形式で記述されます。App IDには、そのアプリが利用する特定のサービス（Capabilities）も紐付けられます。例えば、プッシュ通知、Game Center、Apple Payなどの機能を利用するには、App IDでそのサービスを有効にする必要があります。

3. デバイス (Devices)

デバイスは「どこで」アプリを実行するのかを指定します。開発段階では、テストに使用するiPhoneやiPadのUDID（Unique Device Identifier）をApple Developerポータルに登録する必要があります。App Storeを介さずにアプリをインストールできるのは、この登録されたデバイスのみです。

4. プロビジョニングプロファイル (Provisioning Profiles)

そして、これら3つの要素（誰が、何を、どこで）をすべて結びつけ、アプリの実行を許可する「許可証」がプロビジョニングプロファイルです。プロビジョニングプロファイルには以下の情報が含まれています。

  • 使用を許可された証明書
  • アプリを識別するApp ID
  • インストールを許可されたデバイスのリスト
  • 有効化されている権限（Entitlements）

「a valid provisioning profile for this executable was not found」というエラーは、Xcodeがビルドしようとしているアプリ（実行可能ファイル）に対して、これらすべての条件を完璧に満たす有効な「許可証」を見つけられなかった、ということを意味しているのです。原因は、この4つの要素のどこか、あるいはそれらの連携に不整合が生じていることにあります。

第2章：体系的なトラブルシューティング手順

問題の解決にあたり、やみくもに設定をいじるのは得策ではありません。体系的なアプローチを取ることで、原因を効率的に特定し、解決に導くことができます。まずは最も簡単な方法から試し、徐々に複雑な原因を探っていくのが王道です。

ステップ0：Xcodeの自動署名管理 (Automatically manage signing)

多くの場合、最も手軽で強力な解決策は、Xcodeの自動署名管理機能に任せることです。特に個人開発者や小規模なチームにとっては、この機能がほとんどの問題を解決してくれます。

  1. Xcodeでプロジェクトを開き、プロジェクトナビゲーターでプロジェクトファイル（青いアイコン）を選択します。
  2. 中央のエディタエリアで、該当するターゲット（TARGETS）を選択します。
  3. 「Signing & Capabilities」タブを開きます。
  4. 「Automatically manage signing」のチェックボックスにチェックを入れます。
  5. 「Team」ドロップダウンから、自身のApple Developerアカウントを選択します。

この設定を有効にすると、Xcodeは選択されたチームアカウントに基づき、必要な開発用証明書とプロビジョニングプロファイルを自動的に作成・管理しようと試みます。もし、Bundle Identifierに一致するApp IDが存在しない場合は、それも自動で作成します。多くの単純なケースでは、これだけでエラーが解消されるはずです。しかし、この機能が万能ではない理由も存在します。

  • 特定のプッシュ通知証明書など、手動での設定が必要な複雑な権限を使用している場合。
  • CI/CD環境など、自動化されたビルドプロセスで特定のプロファイルを使用する必要がある場合。
  • 複数の開発者で証明書を共有する厳格な管理体制を敷いている場合。

自動管理で解決しない、あるいは手動管理が必要な場合は、次のステップに進みます。

ステップ1：Xcodeプロジェクト設定の徹底的な確認

手動で署名を管理している場合、エラーの最も一般的な原因はXcode内の設定ミスです。確認すべき箇所は主に「Signing & Capabilities」タブと、より詳細な「Build Settings」です。

「Signing & Capabilities」タブの確認

まず、ターゲットの「Signing & Capabilities」タブを詳細に確認します。

  1. Team: 正しい開発者チームが選択されていますか？複数のチームに所属している場合は特に注意が必要です。
  2. Bundle Identifier: ここに表示されているIDは、使用しようとしているプロビジョニングプロファイルに紐付いたApp IDと完全に一致していますか？（ワイルドカードApp IDの場合はそのパターンに一致しているか）タイプミスがないか、一文字ずつ確認してください。
  3. Provisioning Profile: 意図したプロビジョニングプロファイルが選択されていますか？「Xcode Managed Profile」などが意図せず選択されていることがあります。ドロップダウンから正しいプロファイルを選択し直してください。
  4. Signing Certificate: 選択したプロビジョニングプロファイルに対応する有効な証明書が選択されていますか？「No signing certificate found」などのエラーが表示されている場合は、証明書自体に問題がある可能性があります。

この画面で赤いエラーアイコンや警告メッセージが表示されている場合、その内容が直接的なヒントになります。「Provisioning profile "Profile Name" doesn't include signing certificate "Developer Name".」のようなメッセージは、プロファイルと証明書の組み合わせが間違っていることを示しています。

「Build Settings」タブの確認

「Signing & Capabilities」タブの設定は、「Build Settings」タブの署名関連設定を簡易的に表示したものです。より詳細な設定や、DebugビルドとReleaseビルドで設定を分けている場合は、こちらを確認する必要があります。

  1. ターゲットを選択した状態で「Build Settings」タブに移動します。
  2. 検索バーに「Signing」と入力して、署名関連の設定を絞り込みます。
  3. Code Signing Identity: ここで、ビルド構成（Debug, Releaseなど）ごとに使用する証明書が指定されています。「Any iOS SDK」に対して正しい開発用証明書（Apple Development）が設定されているか確認します。
  4. Provisioning Profile: ここでビルド構成ごとに使用するプロファイルがUUIDで指定されています。意図したプロファイルが設定されているか確認します。

特に注意すべきは、プロジェクトレベル（PROJECT）の設定とターゲットレベル（TARGETS）の設定が競合しているケースです。通常、ターゲットの設定が優先されますが、意図しない設定が上位レベルから継承されている可能性も考慮に入れるべきです。

第3章：デバイス登録とプロファイルの不整合を解決する

Xcode内の設定が正しいにも関わらずエラーが解消されない場合、次に疑うべきは「プロビジョニングプロファイルに、ビルド対象のデバイスが含まれていない」というケースです。これは開発用プロファイル（Development Provisioning Profile）で頻繁に発生する問題です。

ステップ1：デバイスのUDIDを正確に取得する

まず、テストに使用したいデバイスのUDID（40文字の英数字）を正確に知る必要があります。取得方法は複数あります。

  • Xcodeを使用する方法（推奨）：
    1. デバイスをMacにUSBで接続します。
    2. Xcodeの上部メニューから「Window」>「Devices and Simulators」を選択します。
    3. 左のリストから接続したデバイスを選択します。
    4. 右側に表示される詳細情報の中の「Identifier」がUDIDです。これをコピーします。
  • Finderを使用する方法（macOS Catalina以降）：
    1. デバイスをMacにUSBで接続します。
    2. Finderを開き、サイドバーの「場所」から接続したデバイスを選択します。
    3. デバイス名のすぐ下に表示されているデバイスの種類や容量などのテキスト部分をクリックします。クリックするたびに情報が切り替わり、UDIDが表示されます。

ステップ2：Apple Developerポータルでデバイスを登録する

取得したUDIDを、Apple Developerアカウントに登録します。

  1. Apple Developer Webサイトにアクセスし、アカウントにログインします。
  2. 「Certificates, Identifiers & Profiles」セクションに移動します。
  3. 左側のメニューから「Devices」をクリックします。
  4. 右上の「+」ボタンをクリックして、新しいデバイスを追加します。
  5. 「Platform」で「iOS, tvOS, watchOS」を選択し、「Device Name」（例：「Taro's iPhone 14 Pro」など分かりやすい名前）と、先ほどコピーした「Device ID (UDID)」をペーストします。
  6. 「Continue」を押し、内容を確認して「Register」をクリックします。

ステップ3：プロビジョニングプロファイルを再生成・適用する

非常に重要な点ですが、デバイスを登録しただけでは既存のプロビジョニングプロファイルには反映されません。 登録したデバイス情報を含むように、プロファイルを編集して再生成する必要があります。

  1. Apple Developerポータルの「Certificates, Identifiers & Profiles」内で、左側のメニューから「Profiles」を選択します。
  2. エラーが発生しているプロジェクトで使用しているプロビジョニングプロファイルを見つけてクリックします。
  3. 「Edit」ボタンをクリックします。
  4. 「Devices」のセクションまでスクロールし、先ほど登録した新しいデバイスにチェックが入っていることを確認します。（もしくは「Select All」をクリックして全ての登録済みデバイスを含めることもできます）
  5. 「Save」ボタンをクリックして変更を保存します。この時点でプロファイルのステータスが「Invalid」から「Active」に変わります。
  6. 「Download」ボタンをクリックして、更新されたプロファイル（.mobileprovisionファイル）をダウンロードします。
  7. ダウンロードしたファイルをダブルクリックします。するとXcodeが自動的に認識し、ライブラリにインストールされます。

最後にXcodeに戻り、プロジェクトをクリーン（Shift + Command + K）してから再度ビルドを試みてください。Xcodeが新しいプロファイルを正しく認識しない場合があるため、一度Xcodeを完全に終了してから再起動するのも有効な手段です。

第4章：証明書とプロファイルの有効期限問題への対処

これまでの手順で解決しない場合、証明書やプロビジョニングプロファイル自体の有効期限が切れている可能性があります。これらのアセットはセキュリティ上の理由から有効期間が定められており、期限が切れると無効（Invalid）になります。

ステップ1：有効期限の確認

まずはApple Developerポータルで、関連するすべてのアセットの有効期限を確認します。

  1. 「Certificates, Identifiers & Profiles」にアクセスします。
  2. 「Certificates」セクションで、プロジェクトで使用している証明書（DevelopmentまたはDistribution）の有効期限（Expires）を確認します。
  3. 「Profiles」セクションで、使用しているプロビジョニングプロファイルの有効期限を確認します。

プロファイルは、それに紐付く証明書の有効期限が切れると自動的に無効になります。したがって、証明書の期限が近い場合は、まず証明書から更新する必要があります。

ステップ2：期限切れ証明書の更新

開発用証明書の有効期限は1年、配布用証明書は1年です（Apple Developer Enterprise Programを除く）。期限が切れた場合は、新しい証明書を作成する必要があります。

  1. Macの「キーチェーンアクセス」アプリを起動します。
  2. メニューバーから「キーチェーンアクセス」>「証明書アシスタント」>「認証局に証明書を要求…」を選択します。
  3. メールアドレスと通称を入力し、「要求の処理」で「ディスクに保存」を選択して、証明書署名要求（.certSigningRequestまたはCSR）ファイルを保存します。
  4. Apple Developerポータルの「Certificates」セクションに戻り、「+」ボタンで新しい証明書を作成します。
  5. 適切な証明書の種類（例：「Apple Development」）を選択し、「Continue」をクリックします。
  6. 先ほど作成したCSRファイルをアップロードし、証明書を生成します。
  7. 生成された証明書（.cerファイル）をダウンロードし、ダブルクリックしてキーチェーンアクセスにインストールします。これで、新しい有効な証明書が利用可能になります。

ステップ3：期限切れプロビジョニングプロファイルの更新

証明書を更新した場合、その新しい証明書を使用するようにプロビジョニングプロファイルも更新（再生成）する必要があります。

  1. Apple Developerポータルの「Profiles」セクションで、無効になっているプロファイルを選択し、「Edit」をクリックします。
  2. 「Certificates」のセクションで、先ほど作成した新しい証明書が選択されていることを確認します。
  3. そのまま「Save」をクリックしてプロファイルを再生成し、ダウンロードしてXcodeにインストールします。

このプロセスが完了したら、Xcodeの「Signing & Capabilities」設定に戻り、新しいプロファイルと証明書が正しく選択されていることを再度確認してからビルドを実行します。

第5章：高度なトラブルシューティングと最終手段

上記すべての手順を試しても問題が解決しない場合、より根深く、一般的でない原因が潜んでいる可能性があります。

1. キーチェーンアクセスの問題

証明書はキーチェーンアクセスに秘密鍵とペアで保存されています。このペアリングが崩れると、証明書は有効に見えても署名に使用できません。

  • キーチェーンアクセスで該当の証明書を探し、左の三角形を展開して秘密鍵が紐付いているか確認します。
  • 証明書が「この証明書は不明な認証局によって署名されています」や「信頼されていません」と表示されている場合、Appleの中間証明書（Apple Worldwide Developer Relations Certification Authority）が不足または失効している可能性があります。Appleの証明書リポジトリから最新の中間証明書をダウンロードしてインストールしてみてください。

2. .entitlements ファイルの不整合

プッシュ通知やiCloudなど、特別な権限（Entitlements）を使用するアプリでは、プロジェクトに.entitlementsファイルが存在します。このファイルに記述された権限と、プロビジョニングプロファイルに紐付いたApp IDで有効になっている権限が一致していないと、署名エラーが発生することがあります。

「Signing & Capabilities」タブで設定した権限が、Apple DeveloperポータルのApp IDの設定と完全に一致しているか、再度確認してください。

3. クリーンアップとリセット

XcodeやmacOSは、古いプロファイルやビルドキャッシュを保持し続けることがあり、これが予期せぬ問題を引き起こす原因となります。以下の「大掃除」を試す価値は十分にあります。

  • ビルドフォルダのクリーン： Xcodeで Shift + Command + K を実行します。
  • Derived Dataの削除： Xcodeのメニューから「Settings...」（または「Preferences...」）>「Locations」を開き、Derived Dataのパスの横にある矢印をクリックしてFinderで開きます。Xcodeを完全に終了させた後、その中身をすべて削除します。（次回のビルドに時間はかかりますが、多くの不可解な問題が解決します）
  • 古いプロファイルの削除： Finderで Command + Shift + G を押し、パスに ~/Library/MobileDevice/Provisioning Profiles と入力して移動します。ここにある古い、あるいは不要なプロファイルファイルをすべて削除し、必要なものだけをApple Developerポータルから再ダウンロードしてインストールします。
  • XcodeとMacの再起動： 全てのクリーンアップ作業が終わったら、XcodeとMac自体を再起動します。これは、システムレベルのキャッシュをクリアするのに役立ちます。

最終手段：Appleへの問い合わせ

万策尽きた場合は、問題が自身のアカウントやApple側のシステムに起因している可能性も考えられます。Apple Developer Programのメンバーシップには、テクニカルサポートリクエスト（TSI）が含まれています。Appleの専門家に直接問題を相談することで、解決の糸口が見つかるかもしれません。

まとめ

「a valid provisioning profile for this executable was not found」というエラーは、多くのiOS開発者を悩ませる複雑な問題です。しかし、その根底にあるのは、証明書、App ID、デバイス、プロビジョニングプロファイルという構成要素間の論理的な関係性の破綻です。場当たり的な対応ではなく、今回解説した体系的なアプローチに沿って、一つずつ可能性を検証していくことが、確実な解決への最短ルートとなります。

まずはXcodeの自動管理を試し、次にXcode内の設定を精査する。それでもダメならデバイスの登録とプロファイルの再生成を確認し、最後に証明書とプロファイルの有効期限をチェックする。この手順を頭に入れておけば、次にこのエラーに遭遇したときも、冷静に対処できるはずです。この複雑な仕組みを乗り越えた先に、あなたのアプリがユーザーのデバイスで輝く瞬間が待っています。


0 개의 댓글:

Post a Comment