Swift Package Manager
Firebase では、新しいプロジェクトに Swift Package Manager をおすすめします。
Xcode を使用する場合
Swift Package Manager のサポートには、Xcode 16.2 以降が必要です。
CocoaPods ベースのプロジェクトから移行する場合は、
pod deintegrate
を実行して Xcode プロジェクトから CocoaPods を削除します。CocoaPods が生成した.xcworkspace
ファイルは、後で安全に削除できます。プロジェクトに初めて Firebase を追加する場合、この手順は無視してください。Xcode で、[File] > [Add Packages] の順に移動して、Firebase ライブラリをインストールします。
表示されるプロンプトで、Firebase GitHub リポジトリを選択します。
https://github.com/firebase/firebase-ios-sdk.git
使用する Firebase のバージョンを選択します。新しいプロジェクトの場合は、最新バージョンの Firebase を使用することをおすすめします。
アプリに含める Firebase ライブラリを選択します。
完了すると、Xcode はパッケージの依存関係の解決とバックグラウンドでのダウンロードを開始します。
Package.swift
経由
Package.swift
マニフェストを使用して Firebase を Swift パッケージに統合するには、Firebase をパッケージの dependencies
配列に追加します。詳細については、Swift Package Manager のドキュメントをご覧ください。
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
次に、Firebase プロダクトに依存するすべてのターゲットの dependencies
配列に、依存対象の Firebase プロダクトを追加します。
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
プロダクト固有の考慮事項
Firebase プロダクトによっては、正しく機能するために追加の統合手順が必要になることがあります。
Google Analytics
Google Analytics では、ターゲットのビルド設定に -ObjC
リンカーフラグを追加する必要があります(推移的に配置する場合)。
Crashlytics
Crashlytics ではデバッグ シンボルをアップロードする必要があります。
Xcode の実行スクリプトのビルド フェーズを使用して、ビルド後にデバッグ シンボルを自動的にアップロードできます。この実行スクリプトは次の場所にあります。
${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run
シンボルをアップロードするもう一つの方法は、upload-symbols
スクリプトを使用することです。このスクリプトをプロジェクト ファイルのサブディレクトリ(scripts/upload-symbols
など)に配置し、実行可能にします。
chmod +x scripts/upload-symbols
このスクリプトを使用して、dSYM ファイルを手動でアップロードできます。このスクリプトの使用上の注意と追加手順を確認するには、パラメータを指定せずに upload-symbols
を実行してください。
CocoaPods
Firebase では、Swift Package Manager に加えて、CocoaPods を使用したインストールがサポートされています。
Firebase の CocoaPods ディストリビューションには、Xcode 16.2 と CocoaPods 1.12.0 以降が必要です。CocoaPods を使用して Firebase をインストールする方法は次のとおりです。
Podfile がない場合は作成します。プロジェクトのディレクトリのルートから、次のコマンドを実行します。
pod init
アプリで使用したい Firebase Pod を Podfile に追加します。
サポートされている Firebase プロダクトをアプリに追加できます。
# Add the Firebase pod for Google Analytics pod 'FirebaseAnalytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'FirebaseAuth' pod 'FirebaseFirestore'
デバイスレベルの広告識別子である IDFA について詳しくは、Apple のユーザーのプライバシーとデータの使用と、App Tracking Transparency に関するドキュメントをご覧ください。
# Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'FirebaseAuth' pod 'FirebaseFirestore'
Pod をインストールし、
.xcworkspace
ファイルを開いて Xcode でプロジェクトを確認します。pod install --repo-update
open
your-project .xcworkspace
プロダクト固有の考慮事項
Firebase プロダクトによっては、正しく機能するために追加の統合手順が必要になることがあります。
Crashlytics
Crashlytics ではデバッグ シンボルをアップロードする必要があります。
Xcode の実行スクリプトのビルド フェーズを使用して、ビルド後にデバッグ シンボルを自動的にアップロードできます。この実行スクリプトは次の場所にあります。
"${PODS_ROOT}/FirebaseCrashlytics/run"
Carthage
Carthage のサポートは試験運用です。Carthage 経由でアプリに Firebase を含める方法については、GitHub の手順をご覧ください。
手動での統合
依存関係マネージャーを使用せずに Firebase を統合したいユーザー向けに、Firebase は、ビルド済みのバイナリの XCFramework ディストリビューションを提供しています。Firebase をインストールするには:
framework SDK zip をダウンロードします。このファイルには、すべての Firebase SDK 用に利用できるすべてのターゲット アーキテクチャのスライスが含まれているため、ダウンロードに時間がかかる場合があります。
ファイルを解凍し、アプリに含めるフレームワークの
README
を確認します。ターゲットのビルド設定で
Other Linker Settings
に-ObjC
リンカーフラグを追加します。