feat!: upgrade @googlemaps/react-native-navigation-sdk to v0.12.0 (#71)

* chore: upgrade dependencies to match the @googlemaps/react-native-navigation-sdk library
* feat: upgrade @googlemaps/react-native-navigation-sdk dependency version to ^0.12.0

BREAKING CHANGE: iOS header_dir changed to ReactNativeGoogleMapsDriver
BREAKING CHANGE: See navigation SDK v0.12.0 release notes: https://github.com/googlemaps/react-native-navigation-sdk/releases/tag/v0.12.0

Author: jokerttu

.eslintrc.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright 2025 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.
+ */
+
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  env: {
+    'es2021': true,
+    'node': true,
+    'react-native/react-native': true,
+  },
+  plugins: [
+    '@typescript-eslint',
+    'react',
+    'react-hooks',
+    'react-native',
+    'import',
+    'prettier',
+  ],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:react/recommended',
+    'plugin:react-hooks/recommended',
+    'plugin:react-native/all',
+    'plugin:import/errors',
+    'plugin:import/warnings',
+    'plugin:import/typescript',
+    'plugin:prettier/recommended',
+  ],
+  rules: {
+    'prettier/prettier': 'warn',
+    'react/react-in-jsx-scope': 'off',
+    'react-native/no-inline-styles': 'off',
+    'react-native/sort-styles': 'off',
+    'react-native/no-color-literals': 'off',
+    'react-hooks/rules-of-hooks': 'error',
+    'react-hooks/exhaustive-deps': 'warn',
+    '@typescript-eslint/explicit-module-boundary-types': 'warn',
+    '@typescript-eslint/no-explicit-any': 'error',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }], // Allow unused vars starting with _
+    'import/default': 'off', // Disable for now due to react-native-select-dropdown issues
+  },
+  settings: {
+    'react': {
+      version: 'detect',
+    },
+    'import/resolver': {
+      typescript: {},
+    },
+    'import/core-modules': ['@env'],
+    'import/ignore': ['react-native', '@env'],
+  },
+  overrides: [
+    // Configuration files can use require()
+    {
+      files: ['**/*.config.js', '**/babel.config.js'],
+      rules: {
+        '@typescript-eslint/no-require-imports': 'off',
+      },
+    },
+    // Test files
+    {
+      files: ['**/*.test.js', '**/*.test.ts', '**/e2e/**/*.js'],
+      env: {
+        jest: true,
+      },
+      rules: {
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+      },
+    },
+    // Example directory - less strict for demo code
+    {
+      files: ['example/**/*'],
+      rules: {
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+      },
+    },
+  ],
+};

.github/workflows/ci.yml

@@ -232,7 +232,8 @@ jobs:
           yarn turbo run build:android:odrd --cache-dir="${{ env.TURBO_CACHE_DIR }}"
 
   build-ios-lmfs:
-    runs-on: macos-14
+    runs-on:
+      labels: macos-latest-xlarge
     timeout-minutes: 45
     env:
       TURBO_CACHE_DIR: .turbo/ios
@@ -288,7 +289,8 @@ jobs:
           yarn turbo run build:ios:lmfs --cache-dir="${{ env.TURBO_CACHE_DIR }}"
 
   build-ios-odrd:
-    runs-on: macos-14
+    runs-on:
+      labels: macos-latest-xlarge
     timeout-minutes: 45
     env:
       TURBO_CACHE_DIR: .turbo/ios

.github/workflows/release-please.yml

@@ -12,12 +12,16 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-name: release-please
+## Runs the release-please action for all new pushes to the main branch.
+##   This will create new release-PRs, create GitHub releases,
+##   and update the CHANGELOG.md.
+
+name: Release Please
 
 on:
   push:
-    branches:
-      - main
+    branches: [main]
+  workflow_dispatch:
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -31,6 +35,8 @@ jobs:
   release-please:
     runs-on: ubuntu-latest
     steps:
-      - uses: googleapis/release-please-action@d1a8f221d7723166f48a584aebba00ef3f6febec
+      - id: release
+        name: Release Please
+        uses: googleapis/release-please-action@v4
         with:
           token: ${{ secrets.SYNCED_GITHUB_TOKEN_REPO }}

.gitignore

@@ -39,6 +39,7 @@ Keys.plist
 .idea
 .project
 .settings
+.kotlin
 local.properties
 android.iml
 
@@ -47,6 +48,10 @@ android.iml
 example/**/ios/Pods
 example/**/ios/Podfile.lock
 
+# Ruby
+example/**/vendor/
+Gemfile.lock
+
 # node.js
 #
 node_modules/

.nvmrc

@@ -1 +1 @@
-v18
+v22

.yarn/releases/yarn-3.6.4.cjs

@@ -21,4 +21,4 @@ plugins:
   - path: .yarn/plugins/@yarnpkg/plugin-workspace-tools.cjs
     spec: "@yarnpkg/plugin-workspace-tools"
 
-yarnPath: .yarn/releases/yarn-3.6.1.cjs
+yarnPath: .yarn/releases/yarn-3.6.4.cjs

.yarnrc.yml

@@ -8,19 +8,31 @@ If your billing address is in the European Economic Area, effective on 8 July 20
 
 This is the beta release of the Google Driver SDK package for React Native. It is an early look at the package and is intended for testing and feedback collection. The functionalities and APIs in this version are subject to change.
 
+> [!NOTE]
+> This package is in Beta until it reaches version 1.0. According to [semantic versioning](https://semver.org/#spec-item-4), breaking changes may be introduced before 1.0.
+
 ## Requirements
 
 |                                 | Android | iOS       |
 | ------------------------------- | ------- | --------- |
-| **Minimum mobile OS supported** | SDK 23+ | iOS 16.0+ |
+| **Minimum mobile OS supported** | SDK 24+ | iOS 16.0+ |
 
 * A React Native project
-* A Google Cloud project with the [Navigation SDK enabled](https://developers.google.com/maps/documentation/navigation/android-sdk/set-up-project) and the [Maps SDK for iOS enabled](https://developers.google.com/maps/documentation/navigation/ios-sdk/config)
-* An API key from the project above
+* A Google Cloud project
+  *  If you are a Mobility Services developer, you must contact Sales as described in [Mobility services documentation](https://developers.google.com/maps/documentation/transportation-logistics/mobility).
+  *  If you are not a Mobility Services developer, refer to [Setup Google Cloud Project](https://developers.google.com/maps/documentation/navigation/android-sdk/cloud-setup) for instructions.
+* An [API key](https://console.cloud.google.com/google/maps-apis/credentials) from the project above
+  * The API key must be configured for both Android and iOS. Refer to [Android Using Api Keys](https://developers.google.com/maps/documentation/navigation/android-sdk/get-api-key) and [iOS Using Api Keys](https://developers.google.com/maps/documentation/navigation/ios-sdk/get-api-key) respectively for instructions.
 * If targeting Android, [Google Play Services](https://developers.google.com/android/guides/overview) installed and enabled
-* [Attributions and licensing text](https://developers.google.com/maps/documentation/navigation/android-sdk/set-up-project#include_the_required_attributions_in_your_app) added to your app.
-* Install the [react-native-navigation-sdk](https://github.com/googlemaps/react-native-navigation-sdk) library on your application and set up a `NavigationView`.
+* [Attributions and licensing text](https://developers.google.com/maps/documentation/navigation/android-sdk/set-up-project#include_the_required_attributions_in_your_app) added to your app
+
+> [!IMPORTANT]
+> [Apply API restrictions](https://developers.google.com/maps/api-security-best-practices#api-restriction) to the API key to limit usage to "Navigation SDK, "Maps SDK for Android", and "Maps SDK for iOS" for enhanced security and cost management. This helps guard against unauthorized use of your API key.
 
+## React Native Compatibility
+
+> [!IMPORTANT]
+> This package does not yet support React Native's new architecture. Make sure the new architecture is disabled in your project configuration as shown in the [Installation](#installation) section.
 
 ## Installation
 
@@ -48,41 +60,88 @@ This is the beta release of the Google Driver SDK package for React Native. It i
 
 ### Android
 
-1. Set the `minSdkVersion` in `android/app/build.gradle`:
+
+#### Disable new architecture
+
+This package does not yet support new architecture. Make sure new architecture is disabled in your `android/gradle.properties` file:
+
+```groovy
+newArchEnabled=false
+```
+
+#### Enable Jetifier
+
+To ensure compatibility with AndroidX, enable Jetifier in your `android/gradle.properties` file:
+
+```groovy
+# Automatically convert third-party libraries to use AndroidX
+android.enableJetifier=true
+```
+
+#### Enable Core Library Desugaring
+
+Core library desugaring **must be enabled** for your Android project, regardless of your minSdkVersion.
+
+To enable desugaring, update your `android/app/build.gradle` file:
 
 ```groovy
 android {
-    defaultConfig {
-        minSdkVersion 23
+    ...
+    compileOptions {
+        coreLibraryDesugaringEnabled true
+        ...
     }
 }
+
+dependencies {
+    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.4'
+}
 ```
 
-2. **Enable Core Library Desugaring**
+#### Minimum SDK Requirements for Android
 
-   Core library desugaring **must be enabled** for your Android project, regardless of your minSdkVersion.
+The `minSdkVersion` for your Android project must be set to 24 or higher in `android/app/build.gradle`:
 
-   To enable desugaring, update your `android/app/build.gradle` file:
+```groovy
+android {
+    defaultConfig {
+        minSdkVersion 24
+    }
+}
+```
 
-   ```groovy
-   android {
-       ...
-       compileOptions {
-           coreLibraryDesugaringEnabled true
-           ...
-       }
-   }
+#### Set Google Maps API Key
 
-   dependencies {
-       coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.4'
-   }
-   ```
+To securely store your API key, it is recommended to use the [Google Maps Secrets Gradle Plugin](https://developers.google.com/maps/documentation/android-sdk/secrets-gradle-plugin). This plugin helps manage API keys without exposing them in your app's source code.
+
+See example configuration for secrets plugin at example applications [build.gradle](./example/android/app/build.gradle) file.
 
 ### iOS
 
-1. Set the iOS version in your application PodFile.
+#### Disable new architecture
+
+This package does not yet support new architecture. Make sure new architecture is disabled in your `ios/Podfile`:
 
-   `platform: ios, '16.0'`
+```ruby
+ENV['RCT_NEW_ARCH_ENABLED'] = '0'
+```
+
+#### Set Google Maps API Key
+
+To set up, specify your API key in the application delegate `ios/Runner/AppDelegate.m`:
+
+```objective-c
+#import <GoogleMaps/GoogleMaps.h>
+
+@implementation AppDelegate
+
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+  [GMSServices provideAPIKey:@"API_KEY"];
+  return [super application:application didFinishLaunchingWithOptions:launchOptions];
+}
+
+```
 
 ## Usage
 
@@ -274,9 +333,9 @@ See the [Contributing guide](./CONTRIBUTING.md).
 
 ## Terms of Service
 
-This package uses Google Maps Platform services, and any use of Google Maps Platform is subject to the [Terms of Service](https://cloud.google.com/maps-platform/terms).
+This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).
 
-For clarity, this package, and each underlying component, is not a Google Maps Platform Core Service.
+This library is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this library.
 
 ## Support