React Native 0.88の公式リリース説明では、SwiftPM対応は実験的な機能で、利用するには明示的な有効化が必要とされています。
症状: SwiftPMが選べるようになり、CocoaPodsから今すぐ移すべきか迷っている。
最短の判断: 本番プロジェクトは現行構成を維持し、新規または依存の少ないプロジェクトだけを分離して試してください。CocoaPodsも引き続きサポートされています。(React Native 0.88の公式リリース説明)

この記事が役立つ人: React Native 0.88でiOSアプリを新規作成し、SwiftPMを試す価値があるか判断したい個人開発者。
CocoaPodsを使う本番アプリを保守し、ネイティブ依存や公開手順の移行リスクを見極めたい開発者。
Macでのビルドと公開を担い、試験環境や切り戻し手順を整えたい小規模チーム。

01

React Native 0.88のSwiftPM選定は、いま全面移行すべき段階ですか?

「React Native 0.88に対応が入った」ことと、「すべての既存プロジェクトを移行すべき」ことは別です。公式資料で実験的な対応と明示的な有効化が示されている以上、安定した公開フローを持つ本番アプリでは、まず現行の依存管理を保つのが妥当です。

React Native 0.87の公式リリース説明や、SwiftPM対応に関する提案資料も経緯の把握には役立ちます。ただし、過去の提案や別バージョンの情報だけで、あなたの0.88プロジェクトの互換性を証明することはできません。(0.87の公式リリース説明、SwiftPM対応に関する提案資料)

判断は次の条件で分けられます。

  • 依存が少なく、SwiftPMでの対応状況を各ライブラリについて確認できるなら、試験用ブランチで導入を検証します。
  • ネイティブモジュールや独自スクリプトの仕様が不明なら、先に情報を集めます。確認できない依存は、対応済みではなく未検証として扱います。
  • 公開作業が安定しており、切り戻しが難しいなら、CocoaPodsを維持します。移行の利点が確認できるまで、本番の依存管理方式を変える理由はありません。
02

試験前に、iOSネイティブ依存とスクリプトを棚卸しする

最初に、依存関係を「React Native本体」「ネイティブモジュール」「サードパーティーライブラリ」「プロジェクト独自のスクリプト」に分けます。ライブラリの追加手順や自動リンクの仕組みは、React Nativeのライブラリ接続資料も参照し、導入方式ごとに記録してください。(React Nativeのライブラリ接続資料)

各項目について、次の点を確認します。

  • SwiftPMでの導入手順が提供元の資料にあるか。
  • CocoaPodsの設定、Pod固有のフック、生成処理を前提にしていないか。
  • 自動リンクの後に、独自スクリプトが設定ファイルやビルド成果物を変更していないか。
  • 依存バージョンを固定するファイルや、CIでのインストール手順が移行後も整合するか。
  • 公開用の署名、アーカイブ、アップロードまで同じ構成で実行できるか。

SwiftPMの対応が確認できないライブラリは、推測で「使える」と判定しないでください。提供元の説明がない、または現行プロジェクトと異なる条件しか確認できない場合は、未確認として試験対象から分けます。

03

新規プロジェクトでは試験用ブランチで差を確かめる

依存が少ない新規プロジェクトは、SwiftPMを評価しやすい候補です。一方、SwiftPMの利用によりRuby関連の準備を減らせる可能性だけを見て、移行全体が簡単になるとは判断できません。ライブラリの対応状況、ビルド設定、チームの運用手順まで含めて比べます。

比較項目 SwiftPMを試す場合 CocoaPodsを維持する場合
導入の確認 各依存がSwiftPMで使えるか個別に確認します 現在のPod設定と依存解決を引き継ぎます
プロジェクト設定 React Native 0.88での有効化方法と生成結果を検証します 既存の設定やスクリプトへの影響を抑えられます
運用上の注意 実験的な経路として、ビルドと公開まで試験します 実績ある手順を維持できますが、移行判断は別途必要です
切り戻し 変更を試験ブランチに限定して戻せるようにします 現行のロック状態と手順を保管します

試験用ブランチでは、依存管理の変更と公開設定の変更を同時に行わないでください。差分の原因を追いにくくなり、失敗時にどの変更を戻すべきか判断しづらくなります。

Appleの資料では、Xcodeプロジェクトへのパッケージ追加方法と、CIでSwiftパッケージを使う際の考慮事項が説明されています。手元のXcodeで解決できたことだけでなく、CI上で依存取得からビルドまで再現するかも確認します。(Xcodeでのパッケージ追加手順、CIでのSwiftパッケージ利用に関する説明)

04

既存CocoaPodsプロジェクトは段階を分けて移行する

既存アプリは、作業コピーまたは独立ブランチを使い、現行のビルドが再現できる状態を先に保存します。そのうえで、次の順に検証してください。

  • 現在のReact Native、Xcode、ネイティブ依存とビルドスクリプトを記録します。
  • 自動リンク後の設定や、Pod固有の処理を洗い出します。
  • SwiftPMで導入できる依存と、対応根拠が見つからない依存を分けます。
  • 試験ブランチで依存管理だけを変更し、ロック状態と生成ファイルの差を確認します。
  • クリーンチェックアウトから依存解決、iOSビルド、シミュレーター実行を順に試します。
  • 公開用のアーカイブとApp Store Connectへのアップロードまで確認してから、段階的な採用を判断します。

混在構成を検討する場合も、どの依存がどちらの管理方式に属するか、重複して導入されないかをプロジェクトごとに確認します。SwiftPMとCocoaPodsがあらゆるReact Native構成で安全に共存すると、一律に仮定するのは避けてください。

05

Macでは依存解決から公開まで別々に合否を付ける

検証結果は「依存解決に成功」「ビルドに成功」「アプリの動作を確認」「公開手順を確認」に分けて記録します。依存が取得できても、アプリが正常に動くことや、公開用のアップロードが完了することまでは保証されません。アップロードの要件は、App Store Connectのビルドアップロード手順で確認してください。

Mac環境を選ぶ際は、使うXcodeとmacOSがAppleのシステム要件を満たすかを照合します。必要な組み合わせはプロジェクトごとに変わるため、一般的な環境の成功談ではなく、あなたの依存と公開手順で確かめる必要があります。(Xcodeのシステム要件)

手元にMacがない場合でも、Mac上で実際の依存解決から公開前の確認まで行える環境があれば、同じ段階を検証できます。ただし、遠隔環境で利用できるXcodeや作業方法を事前に確認し、クリーンチェックアウトから再現できるかを合否基準に含めてください。

06

公開前に再確認した更新情報

最終更新:2026年10月29日。 React Native公式の0.88リリース説明と最新の公式リリース情報を基に、SwiftPMの実験的な位置づけ、明示的な有効化、CocoaPodsのサポート状況を確認しています。XcodeとmacOSの組み合わせは、実際に使用する環境についてAppleのシステム要件も照合してください。(React Native 0.88公式情報、AppleのXcodeシステム要件)

次の版でSwiftPMを既定にするという計画が示されても、それだけで現在のプロジェクトの移行が完了したことにはなりません。公式の対応状態が変わったとき、または主要ライブラリの対応状況が変わったときに、同じ検証をやり直してください。

07

FAQ:移行前に確認したいこと

React Native 0.88のSwiftPMは本番アプリに適していますか?

SwiftPM対応は実験的で、利用には明示的な有効化が必要です。CocoaPodsも引き続きサポートされているため、本番アプリでは現行構成を急いで置き換えず、試験ブランチで依存解決から公開まで確認してください。新規または依存の少ないプロジェクトなら、正式な採用を決める前の評価対象にできます。

CocoaPodsから移る前に、どのネイティブ依存を確認しますか?

React Native本体、ネイティブモジュール、外部ライブラリ、独自スクリプトを別々に調べます。SwiftPMでの導入根拠、Pod固有の設定、自動リンク後の処理、ロック状態を記録してください。対応を確認できないものは未検証として扱い、確認が済むまで移行の前提にしないことが重要です。

SwiftPMとCocoaPodsは同じプロジェクトで併用できますか?

併用の可否は、プロジェクトの依存関係と設定に左右されます。方式ごとの導入対象、重複の有無、ビルドスクリプトの実行順、クリーンチェックアウト後の挙動を試験用ブランチで確認してください。併用を前提に本番設定を変更するのではなく、実際の構成で再現できることを確かめてから決めます。

手元にMacがないとき、iOSビルドはどう確認しますか?

Xcodeを利用できるMac環境で、実際のReact Nativeと依存関係を使って検証します。依存解決、ビルド、シミュレーターでの動作、公開用アップロードを別々に確認し、成功した段階を記録してください。遠隔環境を使う場合は、必要なXcodeとmacOSの組み合わせ、依存の再取得、公開手順まで実行できるかを事前に確かめます。

08

検証用Macが必要なら、環境の条件を確認してから選ぶ

開発用PCだけに頼ると、手元の容量や稼働時間が制約になり、複数の依存構成を並行して検証しにくいことがあります。一方、Macを購入すれば初期費用と保守の負担があり、短期の移行確認だけなら過剰になる場合もあります。長期にわたる安定した高負荷運用や、物理ポートを使う作業が中心なら、自分のMacを保有する方が合うこともあります。

まずは必要なXcode環境、接続方法、作業期間、公開手順を整理してください。条件に合う遠隔Mac環境で試したい場合は、KVMNODEのMac環境で利用条件を確認し、実際のプロジェクトを使った検証に適するか判断できます。購入とレンタルのどちらが合うか迷う場合は、日本でMac miniを購入する場合の選択肢も比べ、検証期間や必要な運用負担に合わせて選んでください。