Swift パッケージ マネージャー
Firebase Apple SDK の v8.0.0 以降、Firebase のSwift Package Managerサポートはベータ版ではなくなり、一般に使用できるようになりました。 CocoaPods は、Swift Package Manager ユーザーには必要ありません。
Firebase バージョン 8 以降では、Swift Package Manager が推奨されるインストール方法です。
Xcode経由
Swift Package Manager のサポートには、13.3.1 以降が必要です。
CocoaPods ベースのプロジェクトから移行する場合は、
pod deintegrate
を実行して Xcode プロジェクトから CocoaPods を削除します。 CocoaPods で生成された.xcworkspace
ファイルは、後で安全に削除できます。プロジェクトに初めて Firebase を追加する場合、この手順は無視できます。Xcode で、 [ファイル] > [パッケージの追加] に移動して、Firebase ライブラリをインストールします。
表示されるプロンプトで、Firebase GitHub リポジトリを選択します。
https://github.com/firebase/firebase-ios-sdk.git
使用する Firebase のバージョンを選択します。新しいプロジェクトでは、最新バージョンの Firebase を使用することをお勧めします。
アプリに含める Firebase ライブラリを選択します。
完了すると、Xcode はパッケージの依存関係の解決とバックグラウンドでのダウンロードを開始します。
Package.swift
経由
Package.swift
マニフェストを介して Firebase を Swift パッケージに統合するには、パッケージのdependencies
配列に Firebase を追加します。詳細については、 Swift Package Manager のドキュメントを参照してください。
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
次に、Firebase プロダクトに依存する任意のターゲットで、そのターゲットのdependencies
配列に追加します。
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
製品固有の考慮事項
一部の Firebase プロダクトは、正しく機能するために追加の統合手順が必要です。
グーグルアナリティクス
Google アナリティクスでは、推移的に含まれる場合、ターゲットのビルド設定に-ObjC
リンカー フラグを追加する必要があります。
クラッシュリティクス
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
を実行してください。
ココアポッド
Firebase は、Swift Package Manager に加えてCocoaPodsを使用したインストールをサポートしています。
Firebase の CocoaPods ディストリビューションには、Xcode 13.3.1 および CocoaPods 1.10.0 以降が必要です。CocoaPods を使用して Firebase をインストールする方法は次のとおりです。
まだ Podfile がない場合は作成します。プロジェクト ディレクトリのルートから、次のコマンドを実行します。
pod init
Podfile に、アプリで使用する Firebase ポッドを追加します。
サポートされている任意の 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 のユーザー プライバシーとデータ使用およびアプリ トラッキングの透明性に関するドキュメントをご覧ください。
分析が有効になっていません
# 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 では、デバッグ シンボルをアップロードする必要があります。
Xcode の実行スクリプト ビルド フェーズを使用して、ビルド後にデバッグ シンボルを自動的にアップロードできます。実行スクリプトは次の場所にあります。
"${PODS_ROOT}/FirebaseCrashlytics/run"
カルタゴ
Carthage のサポートは実験的なものです。 Carthage を介してアプリに Firebase を含める方法については、GitHub の手順を参照してください。
手動で統合する
Firebase は、依存関係マネージャーを使用せずに Firebase を統合したいユーザー向けに、ビルド済みのバイナリ XCFramework ディストリビューションを提供します。 Firebase をインストールするには:
フレームワーク SDK zipをダウンロードします。このファイルには、すべての Firebase SDK で使用可能なすべてのターゲット アーキテクチャのアーキテクチャ スライスが含まれているため、ダウンロードに時間がかかる場合があります。
ファイルを解凍し、アプリに含めるフレームワークの
README
を確認します。ターゲットのビルド設定の
Other Linker Settings
に-ObjC
リンカー フラグを追加します。