feat(analytics,ios): add support for FirebaseAnalyticsWithoutAdIdSupport with SPM (#18061)

Lyokone · web-flow · commit 65dbd4bd3995 · 2026-03-03T15:02:01.000+01:00
diff --git a/docs/analytics/_get-started.md b/docs/analytics/_get-started.md
@@ -83,6 +83,32 @@ await FirebaseAnalytics.instance
   );
 ```
 
+## Using Analytics without Ad ID support (iOS) {:#without-ad-id}
+
+If your app doesn't use IDFA, you can use `FirebaseAnalyticsWithoutAdIdSupport`
+instead of the default `FirebaseAnalytics` iOS dependency to avoid App Store
+review questions about advertising identifiers.
+
+### Swift Package Manager
+
+Set the `FIREBASE_ANALYTICS_WITHOUT_ADID` environment variable when building:
+
+```bash
+FIREBASE_ANALYTICS_WITHOUT_ADID=true flutter build ios
+```
+
+You can also add this variable to your Xcode scheme's environment variables
+for persistent configuration.
+
+### CocoaPods
+
+Add this to your app's `Podfile`:
+
+```ruby
+pod 'FirebaseAnalytics', :modular_headers => true
+pod 'FirebaseAnalyticsWithoutAdIdSupport', :modular_headers => true
+```
+
 ## Next steps
 
 * Use the [DebugView](/docs/analytics/debugview) to verify your events.
diff --git a/packages/firebase_analytics/firebase_analytics/ios/firebase_analytics/Package.swift b/packages/firebase_analytics/firebase_analytics/ios/firebase_analytics/Package.swift
@@ -79,6 +79,11 @@ guard let shared_spm_version = Version("\(firebase_core_version_string)\(shared_
   fatalError("Invalid firebase_core version: \(firebase_core_version_string)\(shared_spm_tag)")
 }
 
+// Set FIREBASE_ANALYTICS_WITHOUT_ADID=true to use FirebaseAnalyticsWithoutAdIdSupport
+// e.g. FIREBASE_ANALYTICS_WITHOUT_ADID=true flutter build ios
+let useWithoutAdId = ProcessInfo.processInfo.environment["FIREBASE_ANALYTICS_WITHOUT_ADID"] != nil
+let analyticsProduct = useWithoutAdId ? "FirebaseAnalyticsWithoutAdIdSupport" : "FirebaseAnalytics"
+
 let package = Package(
   name: "firebase_analytics",
   platforms: [
@@ -95,7 +100,7 @@ let package = Package(
     .target(
       name: "firebase_analytics",
       dependencies: [
-        .product(name: "FirebaseAnalytics", package: "firebase-ios-sdk"),
+        .product(name: analyticsProduct, package: "firebase-ios-sdk"),
         // Wrapper dependency
         .product(name: "firebase-core-shared", package: "flutterfire"),
       ],
