Appleは、Apple siliconで起きるリンクエラーの原因として、事前構築されたライブラリにシミュレーター向けのアーキテクチャが含まれていないケースを説明しています。Appleの技術ノート

症状: building for iOS Simulator but linking in object file built for iOS と表示され、iOSシミュレーター向けビルドが止まります。
最短手順: エラーに記載されたライブラリのプラットフォーム切片を確認し、シミュレーター用を含むXCFrameworkへ更新するか、対象別に再構築してください。arm64を長期的に除外する方法は、まず選ぶべき修正ではありません。

Apple siliconへ移行してこのエラーに遭遇したiOS開発者、事前構築ライブラリや第三者SDKを使うチーム、XCFrameworkを管理するビルド担当者向けです。
ソースコードだけで構成されたプロジェクトで、外部バイナリ依存がない場合は、まずこのエラーに記されたライブラリ名を探してください。

エラー文が示すのはCPUではなく対象プラットフォームです

エラーにあるSimulatorは、現在のビルド先がiOSシミュレーターであることを示します。一方、built for iOSは問題のオブジェクトファイルがiOS向けとして作られたことを示し、arm64はCPUアーキテクチャを示します。したがって、arm64という文字が両方に出ていても、シミュレーターと実機のバイナリが同じものとして使えるとは限りません。

最初に、エラーが示すライブラリ名、失敗したターゲット、Xcodeで選択中のビルド先を確認します。別のターゲットや別のライブラリの設定を変えると、原因に手を付けないままビルド環境だけを複雑にするおそれがあります。

確認対象 何を示すか 次の判断
iOS Simulator 現在のビルド先 シミュレーター用切片の有無を調べます
built for iOS 依存バイナリの対象プラットフォーム 実機用切片だけでないか確認します
arm64 CPUアーキテクチャ これだけで互換性を判断しません
エラー内のライブラリ名 リンクに失敗した依存 該当する配布物やビルド設定を調べます

CPUアーキテクチャの情報だけでは、バイナリがどのプラットフォーム向けかは判定できません。Appleも、Apple siliconでのビルドエラーについて、対応するライブラリへの更新や設定の確認を案内しています。まずはAppleのApple silicon向けビルドエラーの説明と依存の配布内容を照らし合わせてください。

切片の有無で修正方針を選びます

XCFrameworkは、異なるプラットフォームやビルド対象向けのフレームワークをまとめて配布する形式です。iOS実機用とiOS Simulator用の切片を区別して含められるため、Apple siliconでシミュレーターを使う場合も、シミュレーター向けの対応状況を個別に確認できます。AppleのXCFramework作成資料では、複数のプラットフォーム向けバイナリを一つのバンドルにまとめる方法が説明されています。

依存の状態 判定 推奨する対応 注意点
実機用とシミュレーター用の切片がそろう 対象プラットフォームが一致 正しいXCFrameworkをリンクして再ビルド 選択中のターゲットや検索パスも確認します
実機用の切片しかない シミュレーター向けが不足 対応済みの配布物へ更新します arm64除外だけでは不足自体は解消しません
自作の静的ライブラリで切片が不足 ビルド対象ごとの成果物が未整備 実機用とシミュレーター用を別々にビルドし、XCFrameworkにまとめます 一方の成果物を別の対象へ流用しないでください
ソース依存で切片が不足 配布済みバイナリに依存しない 正しいSDK・対象で再ビルドできるか確認します ビルド設定と依存側の対応状況を併せて確認します

第三者SDKの場合、まず提供元の現行バージョンと配布形式を確認してください。配布物の説明にシミュレーター対応が明記されていても、使用中のバージョンや実際に選ばれたバイナリが異なる可能性があるため、最後は自分のプロジェクトでリンクできるかを確かめます。Appleは、バイナリ形式のSwiftパッケージでフレームワークを配布する方法も案内しています。バイナリフレームワークをSwiftパッケージとして配布する資料も、依存の提供方式を調べる際の参考になります。

自分で作った静的ライブラリなら、シミュレーター向けにビルドした成果物を用意し、実機向け成果物と区別してパッケージします。作成方法を確認するときは、Appleのマルチプラットフォームバイナリ作成手順を参照してください。

依存の種類別に切り分けます

同じリンクエラーでも、修正する場所は依存の提供方法で異なります。第三者から入手したバイナリは利用側だけで再構築できないことがあり、プロジェクト内の自作ライブラリなら生成元の設定まで確認できます。

依存の種類 最初に確認する場所 優先する修正
第三者の事前構築SDK 配布バージョン、対応プラットフォーム、同梱切片 Simulator対応版へ更新します
自作の静的ライブラリ ライブラリのビルド対象と生成手順 対象ごとに再ビルドし、XCFrameworkにまとめます
ソース依存 依存の取得方法、選択されたSDK、ビルド設定 Simulator向けにビルドされているか確認します

EXCLUDED_ARCHSでarm64を除外する設定は、ライブラリがそのアーキテクチャに対応していないことが明確で、対象を限定した検証ができる場合の一時回避策です。すべてのプロジェクトで一律に使うと、別の依存やビルド先に影響し、問題が見えにくくなることがあります。設定を変更するなら、Xcodeのビルド設定リファレンスで対象SDKや設定の適用範囲を確認してください。

確認から再ビルドまでの手順

次の順に進めると、依存の問題とプロジェクト設定の問題を混同しにくくなります。

  1. エラーの対象を記録します。 ライブラリ名、失敗したターゲット、選択中のシミュレーターを控えます。エラーの対象が別ターゲットに切り替わっていないかも確認してください。
  2. 依存の実体を特定します。 プロジェクトのリンク設定やパッケージ管理の設定から、どのバージョンのバイナリが使われているかを調べます。エラー表示だけで依存の出所が分からない場合は、ビルド設定も確認します。
  3. プラットフォーム別の切片を調べます。 XCFrameworkなら同梱内容とプラットフォーム情報を確認し、実機用とシミュレーター用が区別されているかを見ます。lipoなどでCPUアーキテクチャを確認できても、それだけでプラットフォームの適合性まで判断しないでください。
  4. 原因に応じて依存を直します。 第三者SDKならシミュレーター対応版へ更新します。自作ライブラリなら対象ごとに再ビルドし、適切なXCFrameworkを作成します。ソース依存なら、選択されたSDKと生成先を確認して再ビルドします。
  5. 回避設定の影響範囲を限定します。 EXCLUDED_ARCHSを試す場合は、対象SDKや構成を限定し、変更前後の設定を記録します。設定を変えた結果、ほかのターゲットがビルドできなくなっていないかも調べます。
  6. 実機とシミュレーターの両方で確認します。 まず対象のSimulatorでビルドし、続いてiOS実機向けにもビルドします。Appleのシミュレーターまたは実機でアプリをビルドして実行する説明に沿って、ビルド先の切り替えを確認してください。
  7. 依存の来歴を残します。 SDKやXCFrameworkのバージョン、入手元、確認した対象プラットフォーム、修正内容を記録します。ツールチェーン更新後の再発時に、以前の成果物を誤って使っていないか照合できます。

ここでの「両方のビルド」は、同じバイナリを二つの対象へ無理に流用するという意味ではありません。それぞれのビルド先に対応した切片が選ばれ、リンクできることを確認する手順です。

対象別の確認リスト

修正を完了扱いにする前に、以下を一つずつ確認してください。

  • [ ] エラーに示されたライブラリと失敗ターゲットを特定した
  • [ ] 現在のビルド先がiOSシミュレーターか実機かを確認した
  • [ ] arm64の表示だけで互換性を判断せず、プラットフォーム切片を調べた
  • [ ] 第三者SDK、自作ライブラリ、ソース依存のどれかを判別した
  • [ ] シミュレーター向けの依存を更新または再構築した
  • [ ] EXCLUDED_ARCHSを使う場合、対象と影響を限定して記録した
  • [ ] Simulatorと実機の両方で、それぞれの対象向けにビルドした
  • [ ] 依存バージョンと成果物の入手元を記録した

FAQ:切片と一時回避の判断

シミュレーター向けビルドがiOS arm64のライブラリで止まった場合

エラーに記載されたライブラリ名とターゲットを控え、ビルド先がiOSシミュレーターであることを確認します。そのうえで、配布物にシミュレーター用切片が含まれているかを調べてください。CPU名がarm64で一致していても、プラットフォームが異なればリンクできないことがあります。

実機用arm64ライブラリとSimulator用arm64ライブラリの違い

arm64はCPUアーキテクチャを表しますが、それだけではビルド対象のプラットフォームまでは示しません。iOS実機用とiOS Simulator用は、同じarm64でも別の対象として扱われます。実機用切片しかない場合は、シミュレーター用を含む配布物に更新するか、ソースから対象別に再ビルドします。

第三者SDKにSimulator arm64の切片がない場合

提供元の新しいSDKやXCFrameworkを確認し、Simulator用切片の有無をリリース情報と実際のビルドで照合してください。対応版がなければ、提供元へ対応状況を問い合わせるか、ソースが利用できる場合に対象別でビルドします。arm64を除外する設定は不足を直さないため、恒久策として扱わないでください。

EXCLUDED_ARCHSが有効な一時回避になる条件

特定の依存があるアーキテクチャに対応していないと確認でき、対象SDKや構成を限定して動作検証できる場合には、一時回避として検討できます。ただし、Simulator全体でarm64を除外すると、別の依存やビルド先に影響する可能性があります。更新や再構築ができるなら、そちらを優先してください。

別環境での再現が必要な場合

修正後もビルド先や依存の状態を切り分けられないときは、別のMacまたは隔離した環境で同じ依存バージョンを使い、Simulatorと実機のビルドをやり直す方法があります。現在のMacだけで検証を続けると、ローカルの設定や残存成果物が影響しているのか、依存そのものが原因なのかを分けにくくなることがあります。

長期にわたり固定された環境で大きなビルドを繰り返すなら、自前のMacを管理するほうが適する場合もあります。一方、短期間だけ再現用の環境が必要で、手元の設定から切り離して確認したい場合は、SSHMacのMac環境を一時利用し、依存の更新後に両方のビルド先を検証する選択肢があります。利用条件はMacレンタルプランで確認できます。接続方法や利用開始時の確認事項は、SSHMacヘルプセンターも参照できます。