feat(analytics, web): add support for options on Web (#12914)

* feat(analytics, web): add support for options on Web

* licence

Author: Lyokone

packages/firebase_analytics/firebase_analytics/lib/src/firebase_analytics.dart

@@ -6,28 +6,35 @@ part of firebase_analytics;
 
 /// Firebase Analytics API.
 class FirebaseAnalytics extends FirebasePluginPlatform {
-  FirebaseAnalytics._({required this.app})
-      : super(app.name, 'plugins.flutter.io/firebase_analytics');
+  FirebaseAnalytics._({
+    required this.app,
+    this.webOptions,
+  }) : super(app.name, 'plugins.flutter.io/firebase_analytics');
 
   static Map<String, FirebaseAnalytics> _firebaseAnalyticsInstances = {};
 
+  final Map<String, dynamic>? webOptions;
+
   // Cached and lazily loaded instance of [FirebaseAnalyticsPlatform] to avoid
   // creating a [MethodChannelFirebaseAnalytics] when not needed or creating an
   // instance with the default app before a user specifies an app.
   FirebaseAnalyticsPlatform? _delegatePackingProperty;
 
   FirebaseAnalyticsPlatform get _delegate {
     return _delegatePackingProperty ??=
-        FirebaseAnalyticsPlatform.instanceFor(app: app);
+        FirebaseAnalyticsPlatform.instanceFor(app: app, webOptions: webOptions);
   }
 
   /// Returns an instance using a specified [FirebaseApp].
   ///
   /// Note; multi-app support is only supported on web.
-  factory FirebaseAnalytics.instanceFor({required FirebaseApp app}) {
+  factory FirebaseAnalytics.instanceFor({
+    required FirebaseApp app,
+    Map<String, dynamic>? webOptions,
+  }) {
     if (kIsWeb || app.name == defaultFirebaseAppName) {
       return _firebaseAnalyticsInstances.putIfAbsent(app.name, () {
-        return FirebaseAnalytics._(app: app);
+        return FirebaseAnalytics._(app: app, webOptions: webOptions);
       });
     }
 

packages/firebase_analytics/firebase_analytics_platform_interface/lib/src/method_channel/method_channel_firebase_analytics.dart

@@ -34,7 +34,10 @@ class MethodChannelFirebaseAnalytics extends FirebaseAnalyticsPlatform {
       MethodChannel('plugins.flutter.io/firebase_analytics');
 
   @override
-  FirebaseAnalyticsPlatform delegateFor({required FirebaseApp app}) {
+  FirebaseAnalyticsPlatform delegateFor({
+    required FirebaseApp app,
+    Map<String, dynamic>? webOptions,
+  }) {
     return MethodChannelFirebaseAnalytics(app: app);
   }
 

packages/firebase_analytics/firebase_analytics_platform_interface/lib/src/platform_interface/platform_interface_firebase_analytics.dart

@@ -40,8 +40,12 @@ abstract class FirebaseAnalyticsPlatform extends PlatformInterface {
   }
 
   /// Create an instance using [app] using the existing implementation
-  factory FirebaseAnalyticsPlatform.instanceFor({required FirebaseApp app}) {
-    return FirebaseAnalyticsPlatform.instance.delegateFor(app: app);
+  factory FirebaseAnalyticsPlatform.instanceFor({
+    required FirebaseApp app,
+    Map<String, dynamic>? webOptions,
+  }) {
+    return FirebaseAnalyticsPlatform.instance
+        .delegateFor(app: app, webOptions: webOptions);
   }
 
   /// The current default [FirebaseAnalyticsPlatform] instance.
@@ -59,7 +63,10 @@ abstract class FirebaseAnalyticsPlatform extends PlatformInterface {
   }
 
   /// Enables delegates to create new instances of themselves
-  FirebaseAnalyticsPlatform delegateFor({required FirebaseApp app}) {
+  FirebaseAnalyticsPlatform delegateFor({
+    required FirebaseApp app,
+    Map<String, dynamic>? webOptions,
+  }) {
     throw UnimplementedError('delegateFor() is not implemented');
   }
 

packages/firebase_analytics/firebase_analytics_web/lib/firebase_analytics_web.dart

@@ -17,15 +17,22 @@ class FirebaseAnalyticsWeb extends FirebaseAnalyticsPlatform {
   /// instance of Analytics from the web plugin
   analytics_interop.Analytics? _webAnalytics;
 
+  final Map<String, dynamic>? webOptions;
+
   /// Lazily initialize [_webAnalytics] on first method call
   analytics_interop.Analytics get _delegate {
-    return _webAnalytics ??=
-        analytics_interop.getAnalyticsInstance(core_interop.app(app.name));
+    return _webAnalytics ??= analytics_interop.getAnalyticsInstance(
+      core_interop.app(app.name),
+      webOptions,
+    );
   }
 
   /// Builds an instance of [FirebaseAnalyticsWeb] with an optional [FirebaseApp] instance
   /// If [app] is null then the created instance will use the default [FirebaseApp]
-  FirebaseAnalyticsWeb({FirebaseApp? app}) : super(appInstance: app);
+  FirebaseAnalyticsWeb({
+    FirebaseApp? app,
+    this.webOptions,
+  }) : super(appInstance: app);
 
   /// Called by PluginRegistry to register this plugin for Flutter Web
   static void registerWith(Registrar registrar) {
@@ -34,8 +41,11 @@ class FirebaseAnalyticsWeb extends FirebaseAnalyticsPlatform {
   }
 
   @override
-  FirebaseAnalyticsPlatform delegateFor({FirebaseApp? app}) {
-    return FirebaseAnalyticsWeb(app: app);
+  FirebaseAnalyticsPlatform delegateFor({
+    FirebaseApp? app,
+    Map<String, dynamic>? webOptions,
+  }) {
+    return FirebaseAnalyticsWeb(app: app, webOptions: webOptions);
   }
 
   @override

packages/firebase_analytics/firebase_analytics_web/lib/interop/analytics.dart

@@ -14,10 +14,13 @@ import 'analytics_interop.dart' as analytics_interop;
 export 'analytics_interop.dart';
 
 /// Given an AppJSImp, return the Analytics instance.
-Analytics getAnalyticsInstance([App? app]) {
+Analytics getAnalyticsInstance([
+  App? app,
+  Map<String, dynamic>? options = const {},
+]) {
   return Analytics.getInstance(
     app != null
-        ? analytics_interop.getAnalytics(app.jsObject)
+        ? analytics_interop.initializeAnalytics(app.jsObject, options.jsify())
         : analytics_interop.getAnalytics(),
   );
 }

packages/firebase_analytics/firebase_analytics_web/lib/interop/analytics_interop.dart

@@ -17,7 +17,10 @@ external AnalyticsJsImpl getAnalytics([AppJsImpl? app]);
 
 @JS()
 @staticInterop
-external AnalyticsJsImpl initializeAnalytics([AppJsImpl app]);
+external AnalyticsJsImpl initializeAnalytics(
+  AppJsImpl app, [
+  JSAny? options,
+]);
 
 @JS()
 @staticInterop

packages/firebase_analytics/firebase_analytics_web/test/firebase_analytics_web_test.mocks.dart

@@ -77,27 +77,39 @@ class MockFirebaseAnalyticsWeb extends _i1.Mock
       ) as _i2.FirebaseApp);
 
   @override
-  _i3.FirebaseAnalyticsPlatform delegateFor({_i2.FirebaseApp? app}) =>
+  _i3.FirebaseAnalyticsPlatform delegateFor({
+    _i2.FirebaseApp? app,
+    Map<String, dynamic>? webOptions,
+  }) =>
       (super.noSuchMethod(
         Invocation.method(
           #delegateFor,
           [],
-          {#app: app},
+          {
+            #app: app,
+            #webOptions: webOptions,
+          },
         ),
         returnValue: _FakeFirebaseAnalyticsPlatform_1(
           this,
           Invocation.method(
             #delegateFor,
             [],
-            {#app: app},
+            {
+              #app: app,
+              #webOptions: webOptions,
+            },
           ),
         ),
         returnValueForMissingStub: _FakeFirebaseAnalyticsPlatform_1(
           this,
           Invocation.method(
             #delegateFor,
             [],
-            {#app: app},
+            {
+              #app: app,
+              #webOptions: webOptions,
+            },
           ),
         ),
       ) as _i3.FirebaseAnalyticsPlatform);