feat: internal usage attribution ID (#581)

Author: jokerttu

android/build.gradle

@@ -55,6 +55,7 @@ android {
 
 dependencies {
   implementation 'com.facebook.react:react-native:+'
+  implementation 'androidx.startup:startup-runtime:1.2.0'
   implementation "androidx.car.app:app:1.4.0"
   implementation "androidx.car.app:app-projected:1.4.0"
   implementation 'androidx.constraintlayout:constraintlayout:2.1.4'

android/src/main/AndroidManifest.xml

@@ -14,12 +14,22 @@
  See the License for the specific language governing permissions and
  limitations under the License.
 -->
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
     <application>
+        <provider
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+            <meta-data
+                android:name="com.google.android.react.navsdk.NavSdkInitializer"
+                android:value="androidx.startup" />
+        </provider>
         <service
             android:name="com.google.android.react.navsdk.NavInfoReceivingService"
             android:exported="false" />

android/src/main/java/com/google/android/react/navsdk/MapViewControllerReadyListener.java

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.react.navsdk;
+
+interface MapViewControllerReadyListener {
+  void onMapViewControllerReady(int viewId);
+}

android/src/main/java/com/google/android/react/navsdk/NavSdkInitializer.java

@@ -0,0 +1,39 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * <p>Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of the License at
+ *
+ * <p>http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * <p>Unless required by applicable law or agreed to in writing, software distributed under the
+ * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.google.android.react.navsdk;
+
+import android.content.Context;
+import androidx.annotation.NonNull;
+import androidx.startup.Initializer;
+import com.google.android.gms.maps.MapsApiSettings;
+import java.util.Collections;
+import java.util.List;
+
+/** Registers the Navigation SDK internal usage attribution ID at application startup. */
+public final class NavSdkInitializer implements Initializer<Void> {
+
+  @NonNull
+  @Override
+  public Void create(@NonNull Context context) {
+    MapsApiSettings.addInternalUsageAttributionId(
+        context.getApplicationContext(), SdkVersion.ATTRIBUTION_ID);
+    return null;
+  }
+
+  @NonNull
+  @Override
+  public List<Class<? extends Initializer<?>>> dependencies() {
+    return Collections.emptyList();
+  }
+}

android/src/main/java/com/google/android/react/navsdk/SdkVersion.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.android.react.navsdk;
+
+/** SDK version constants for internal usage attribution. */
+public final class SdkVersion {
+  public static final String VERSION = "0.15.1"; // {x-release-please-version}
+
+  public static final String ATTRIBUTION_ID =
+      "gmp_git_reactnativenavigationsdk_v" + VERSION + "_android";
+
+  private SdkVersion() {}
+}

ios/react-native-navigation-sdk/NavModule.mm

@@ -15,9 +15,11 @@
  */
 
 #import "NavModule.h"
+#import <GoogleMaps/GoogleMaps.h>
 #import "NavAutoModule.h"
 #import "NavViewModule.h"
 #import "ObjectTranslationUtil.h"
+#import "SdkVersion.h"
 
 using namespace JS::NativeNavModule;
 

ios/react-native-navigation-sdk/RNNavSdkAttribution.m

@@ -0,0 +1,29 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#import <GoogleMaps/GoogleMaps.h>
+#import "SdkVersion.h"
+
+@interface RNNavSdkAttribution : NSObject
+@end
+
+@implementation RNNavSdkAttribution
+
++ (void)load {
+  NSString *attributionId =
+      [NSString stringWithFormat:@"gmp_git_reactnativenavigationsdk_v%@_ios", kRNNavSdkVersion];
+  [GMSServices addInternalUsageAttributionID:attributionId];
+}
+
+@end

ios/react-native-navigation-sdk/SdkVersion.h

@@ -0,0 +1,19 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#import <Foundation/Foundation.h>
+
+static NSString *const kRNNavSdkVersion = @"0.15.1";  // x-release-please-version

release-please-config.json

@@ -8,7 +8,11 @@
   "packages": {
     ".": {
       "package-name": "@googlemaps/react-native-navigation-sdk",
-      "changelog-path": "CHANGELOG.md"
+      "changelog-path": "CHANGELOG.md",
+      "extra-files": [
+        "android/src/main/java/com/google/android/react/navsdk/SdkVersion.java",
+        "ios/react-native-navigation-sdk/SdkVersion.h"
+      ]
     }
   }
 }