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