iOSアプリにFirebaseを組み込む話

概要

FirebaseのiOS向けSDKをSPMを使って導入した前提で書いています。

まず、デバッグモードを有効にしてログの詳細が見れるようにします。

Run > Arguments > Arguments Passed On Launchから-FIRDebugEnabledを設定します。

詳しいことは公式ドキュメントのイベントをデバッグするに書いてあります。

-FIRAnalyticsDebugEnabledこれも追加しておいても良いかもしれません。

あと、これも必要かどうかわからないのですが、アプリのビルド設定からリンカーの設定をします。

これも公式ドキュメントのアプリに Analytics SDK を追加するに載っています。最初は何もデータが送られてこなかったのですが、これらの設定をつけてアップデートしたらデータがくるようになったので多分必要なのだと思います。

Firebase Analysis

どのくらいアプリが利用されているか調査するときに使います。

1
import Firebase
2

3
class AppDelegate: NSObject, UIApplicationDelegate {
4
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
5
        FirebaseApp.configure()
6
        return true
7
    }
8
}

AppDelegateでFirebaseApp.configure()を実行するだけです。

このときユーザーを識別する情報を取ってくるかどうかでまた変わってきます。

IDFAを利用する場合

1
@main
2
struct Main: App {
3
    @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
4
    @Environment(\.scenePhase) private var scenePhase
5

6
    var body: some Scene {
7
        WindowGroup {
8
            ContentView()
9
                .environmentIsFirstLaunch()
10
                .onChange(of: scenePhase, perform: { newPhase in
11
                    if newPhase == .active {
12
                        guard ATTrackingManager.trackingAuthorizationStatus == .notDetermined else { return }
13
                        DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
14
                            ATTrackingManager.requestTrackingAuthorization(completionHandler: { _ in
15
                            })
16
                        }
17
                    }
18
                })
19
        }
20
    }
21
}

IDFAを利用する場合にはシーンがアクティブになって、かつ一度もダイアログを出したことがない場合にダイアログを出すようにします。いきなり表示させようとするとシーンの切り替わりと被ってしまうためか、ダイアログが出てこない場合があるので一秒遅延実行するようにしています。

Info.plistにPrivacy - Tracking Usage Descriptionを追加して値にNSUserTrackingUsageDescriptionを設定します。

ここに直接メッセージを書くこともできるのですが、その場合多言語化がめんどくさくなるのでキー名を書きます。

翻訳を反映させるためにInfoPlist.stringsを作成し、

1
/*
2
  InfoPlist.strings
3
  ThunderApp
4

5
  Created by devonly on 2025/07/08.
6
  Copyright © 2025 QuantumLeap. All rights reserved.
7

8
*/
9

10
"NSCameraUsageDescription" = "QRコードを読み取るためにカメラを使います。";
11
"NSUserTrackingUsageDescription" = "「許可」すると、アプリの利用状況を解析して体験を改善します。";

このような感じで書いておきます。

1
ATTrackingManager.requestTrackingAuthorization(completionHandler: { _ in
2
})

を呼び出すときにNSUserTrackingUsageDescriptionが定義されていないとアプリがクラッシュするので、書き忘れるということはないと思います。

Firebase Cloud Messaging

プッシュ通知を送ることができる仕組みです。

FCMを有効にしていると、アプリが立ち上がったときにFCMのトークンを取得するのでそれを自分で管理するサーバーに送信して、ユーザーに対してプッシュ通知を送る感じです。

1
import Firebase
2
import FirebaseMessaging
3

4
class AppDelegate: NSObject, UIApplicationDelegate {
5
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
6
        FirebaseApp.configure()
7

8
        UNUserNotificationCenter.current().delegate = self
9
        UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound, .badge], completionHandler: { granted, _ in
10
            if granted {
11
                DispatchQueue.main.async {
12
                    application.registerForRemoteNotifications()
13
                }
14
            }
15
        })
16
        Messaging.messaging().delegate = self
17
        return true
18
    }
19

20
    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
21
        Messaging.messaging().apnsToken = deviceToken
22
    }
23
}
24

25
extension AppDelegate: MessagingDelegate {
26
    func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
27
        #if DEBUG || targetEnvironment(simulator)
28
        if let fcmToken {
29
            Logger.debug("FCM Token: \(fcmToken)")
30
        }
31
        #endif
32
    }
33
}
34

35
extension AppDelegate: UNUserNotificationCenterDelegate {
36
    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
37
        completionHandler([.banner, .sound])
38
    }
39
}

今回の場合にはアプリが起動した直後に通知を許可するかどうかのダイアログを出していますが、ユーザーインタラクティブにしてもいいと思います。

プッシュ通知をする場合にはSigning & Capabilities > Push Notificationsを有効にする必要があります。

また、実際にプッシュ通知を送る場合にはAPNsをApple Developerから発行する必要もあります。

これらについても公式ドキュメントのApple プラットフォームで Firebase Cloud Messaging クライアントアプリを設定するに書いてあるので、この通りにやれば問題ないと思います。

Firebase AppCheck

よくわかっていないのですが、公式ドキュメントFirebase App Checkによると、

App Check は、未承認のクライアントがバックエンドリソースにアクセスするのを防ぐことで、アプリのバックエンドを不正使用から保護します。Google サービス（Firebase や Google Cloud サービスを含む）と独自のカスタムバックエンドの両方と連携して、リソースを安全に保ちます。

ということなので、実装して損はないと思います。

1
import FirebaseAppCheck
2

3
class AppCheckReleaseProviderFactory: NSObject, AppCheckProviderFactory {
4
    func createProvider(with app: FirebaseApp) -> (any AppCheckProvider)? {
5
        if #available(iOS 14.0, *) {
6
            return AppAttestProvider(app: app)
7
        } else {
8
            return DeviceCheckProvider(app: app)
9
        }
10
    }
11
}
12

13
class AppDelegate: NSObject, UIApplicationDelegate {
14
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
15
        #if DEBUG || targetEnvironment(simulator)
16
        AppCheck.setAppCheckProviderFactory(AppCheckDebugProviderFactory())
17
        #else
18
        AppCheck.setAppCheckProviderFactory(AppCheckReleaseProviderFactory())
19
        #endif
20
        FirebaseApp.configure()
21
        return true
22
    }
23
}

これで、開発機でもAppCheckをパスできるようになります。

まとめ

まだまだ、使ってみたいサービスとかがあるので続きを書くことになると思います。