@jacques_gordon/expo-mapbox-navigation 2.2.5 → 2.2.7

package/ExpoMapboxNavigation.podspec

@@ -2,6 +2,33 @@ require 'json'
 
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 
+# ── Detect whether xcframeworks have been built and bundled ────────────────────
+# The ios/Frameworks/ directory is populated by running ios/build-xcframeworks.sh
+# (requires macOS + Xcode + Mapbox .netrc credentials). Once built, the
+# xcframeworks are committed to the repository / included in the npm package.
+frameworks_dir = File.join(__dir__, 'ios', 'Frameworks')
+has_frameworks = Dir.exist?(frameworks_dir) &&
+                 Dir.glob(File.join(frameworks_dir, '*.xcframework')).length > 0
+
+if !has_frameworks
+  warn <<~MSG
+
+  ┌──────────────────────────────────────────────────────────────────────────┐
+  │  @jacques_gordon/expo-mapbox-navigation: iOS xcframeworks not found      │
+  │                                                                          │
+  │  The Mapbox Navigation SDK v3 is SPM-only (no CocoaPods distribution).  │
+  │  To build for iOS you must first compile the xcframeworks:               │
+  │                                                                          │
+  │    cd node_modules/@jacques_gordon/expo-mapbox-navigation/ios            │
+  │    ./build-xcframeworks.sh                                               │
+  │                                                                          │
+  │  Prerequisites: macOS + Xcode 16 + ~/.netrc with Mapbox Downloads token │
+  │  See ios/build-xcframeworks.sh for full instructions.                   │
+  └──────────────────────────────────────────────────────────────────────────┘
+
+  MSG
+end
+
 Pod::Spec.new do |s|
   s.name           = 'ExpoMapboxNavigation'
   s.version        = package['version']
@@ -10,40 +37,46 @@ Pod::Spec.new do |s|
   s.license        = package['license']
   s.author         = package['author']
   s.homepage       = package['homepage']
+
+  # iOS 14+ as required by Mapbox Navigation SDK v3
   s.platforms      = { :ios => '14.0' }
   s.swift_version  = '5.9'
   s.source         = { git: package['repository']['url'], tag: "v#{s.version}" }
 
   s.dependency 'ExpoModulesCore'
 
-  # ── iOS: Mapbox Navigation SDK v3 ───────────────────────────────────────────
+  # ── Vendored xcframeworks ──────────────────────────────────────────────────
+  # Mapbox Navigation SDK v3 for iOS is SPM-only — CocoaPods support is
+  # announced as "coming soon" by Mapbox but not yet available.
   #
-  # IMPORTANT — do NOT use spm_dependency() here.
+  # We vendor pre-compiled xcframeworks built from the official source using
+  # the Scipio build tool (see ios/build-xcframeworks.sh). This is the same
+  # approach used by @badatgil/expo-mapbox-navigation (the only community
+  # wrapper with confirmed production EAS Build success for iOS + Mapbox Nav v3).
   #
-  # spm_dependency() causes "43029 duplicate symbols" linker errors when used
-  # alongside @rnmapbox/maps in an Expo project (confirmed: React Native
-  # GitHub issue #47344, Expo GitHub issue #37813). The root cause is that
-  # spm_dependency() links the SPM framework into both the Pod target AND
-  # the main app target simultaneously, so the linker sees every symbol twice.
+  # The vendored frameworks are:
+  #   - MapboxNavigationCore     — routing engine, location matching, progress
+  #   - MapboxNavigationUIKit    — NavigationViewController drop-in UI
+  #   - MapboxNavigationNative   — binary (pre-compiled, from Mapbox Maven)
+  #   - MapboxDirections         — Waypoint, NavigationRouteOptions, etc.
+  #   - _MapboxNavigationHelpers — internal helpers
   #
-  # The correct approach for Expo modules that need SPM-only packages:
-  # add the SPM dependency directly to the Xcode project's main target via
-  # the config plugin (withXcodeProject + withDangerousMod), which is exactly
-  # what our plugin/src/index.js does via the addMapboxNavigationSPM function.
-  # That way there is only ONE copy of each framework in the final binary.
-  #
-  # MapboxNavigationCore and MapboxNavigationUIKit are therefore listed as
-  # weak framework references here so the module compiles against them, while
-  # the actual linking happens at the app level from the SPM dependency added
-  # by the config plugin.
-  s.pod_target_xcconfig = {
-    'DEFINES_MODULE'                          => 'YES',
-    'SWIFT_COMPILATION_MODE'                  => 'wholemodule',
-    'OTHER_SWIFT_FLAGS'                       => '$(inherited) -Xfrontend -disable-reflection-metadata',
-    'FRAMEWORK_SEARCH_PATHS'                  => '$(inherited) $(PLATFORM_DIR)/Developer/Library/Frameworks',
-    'OTHER_LDFLAGS'                           => '$(inherited)',
-    'IPHONEOS_DEPLOYMENT_TARGET'              => '14.0',
-  }
+  # MapboxMaps, MapboxCommon, Turf are NOT vendored here — they come from
+  # @rnmapbox/maps which is a required peer dependency. Vendoring them again
+  # would cause "duplicate symbols" (the exact error we hit with spm_dependency).
+  if has_frameworks
+    vendored = Dir.glob(File.join(frameworks_dir, '*.xcframework'))
+                  .map { |f| "ios/Frameworks/#{File.basename(f)}" }
+    s.vendored_frameworks = vendored
+  end
 
   s.source_files = 'ios/**/*.{swift,h,m,mm}'
+  # Exclude Package.swift and build script from compilation
+  s.exclude_files = 'ios/Package.swift', 'ios/build-xcframeworks.sh'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE'             => 'YES',
+    'SWIFT_COMPILATION_MODE'     => 'wholemodule',
+    'IPHONEOS_DEPLOYMENT_TARGET' => '14.0',
+  }
 end

package/android/src/main/java/expo/modules/mapboxnavigation/ExpoMapboxNavigationView.kt

@@ -933,12 +933,54 @@ class ExpoMapboxNavigationView(context: Context, appContext: AppContext) :
     fun setUseMapMatching(u: Boolean) { useMapMatching = u }
     fun setCustomRasterTileUrl(u: String?) { customRasterTileUrl = u }
     fun setCustomRasterAboveLayerId(l: String?) { customRasterAboveLayerId = l }
-    fun setManeuverBackgroundColorDay(c: String?) { maneuverBackgroundColorDay = c }
+
+    fun setManeuverBackgroundColorDay(c: String?) {
+        maneuverBackgroundColorDay = c
+        // ManeuverView is constructed with options in buildUI() which runs before
+        // props are received — we cannot rebuild it, but the color can be applied
+        // by updating the ManeuverView background tint directly on the view itself.
+        c?.let { hex ->
+            try { maneuverView?.setBackgroundColor(Color.parseColor(hex)) } catch (e: Exception) {}
+        }
+    }
+
     fun setManeuverTurnIconColor(c: String?) { maneuverTurnIconColor = c }
-    fun setEtaBarBackgroundColor(c: String?) { etaBarBackgroundColor = c }
-    fun setEtaTextColor(c: String?) { etaTextColor = c }
-    fun setIconButtonColor(c: String?) { iconButtonColor = c }
-    fun setIconButtonMutedColor(c: String?) { iconButtonMutedColor = c }
+
+    fun setEtaBarBackgroundColor(c: String?) {
+        etaBarBackgroundColor = c
+        c?.let { hex ->
+            try { etaBar?.setBackgroundColor(Color.parseColor(hex)) } catch (e: Exception) {}
+        }
+    }
+
+    fun setEtaTextColor(c: String?) {
+        etaTextColor = c
+        c?.let { hex ->
+            try {
+                val color = Color.parseColor(hex)
+                tvEtaTime?.setTextColor(color)
+                tvDuration?.setTextColor(color)
+            } catch (e: Exception) {}
+        }
+    }
+
+    fun setIconButtonColor(c: String?) {
+        iconButtonColor = c
+        // Redraw overview and recenter icons with new color
+        btnOverviewView?.setImageBitmap(drawRouteOverviewIcon())
+        // Recenter keeps its current alpha (0.4 following / 1.0 overview)
+        val currentAlpha = btnRecenterView?.alpha ?: 0.4f
+        btnRecenterView?.setImageBitmap(drawNavigationArrowIcon())
+        btnRecenterView?.alpha = currentAlpha
+        // Redraw mute icon only if not currently muted (muted uses iconButtonMutedColor)
+        if (!isMuted) btnMuteView?.setImageBitmap(drawSpeakerIcon(false))
+    }
+
+    fun setIconButtonMutedColor(c: String?) {
+        iconButtonMutedColor = c
+        // Redraw mute icon only if currently muted
+        if (isMuted) btnMuteView?.setImageBitmap(drawSpeakerIcon(true))
+    }
 
     override fun onDetachedFromWindow() {
         super.onDetachedFromWindow()

package/app.plugin.js

@@ -1,201 +1,54 @@
-const { withAppBuildGradle, withProjectBuildGradle, withAndroidManifest, withInfoPlist, withDangerousMod, withXcodeProject } = require('@expo/config-plugins');
+const {
+  withAppBuildGradle,
+  withAndroidManifest,
+  withInfoPlist,
+  withDangerousMod,
+} = require('@expo/config-plugins');
 const fs = require('fs');
 const path = require('path');
 
-const NDK_VERSION = '27.0.12077973';
-const MAPBOX_MAPS_MIN_VERSION = '11.11.0';
-
 const withMapboxNavigation = (config, options = {}) => {
   const {
     accessToken,
     downloadsToken,
-    mapboxMapsVersion = MAPBOX_MAPS_MIN_VERSION,
+    mapboxMapsVersion = '11.11.0',
     androidColorOverrides = {},
   } = options;
 
   if (!accessToken) {
     throw new Error(
-      '[@jacques_gordon/expo-mapbox-navigation] `accessToken` is required in the plugin config.\n' +
-      'Add it to your app.json plugins array:\n' +
-      '  ["@jacques_gordon/expo-mapbox-navigation", { "accessToken": "pk.your_token" }]'
+      '[@jacques_gordon/expo-mapbox-navigation] `accessToken` is required.\n' +
+      '  ["@jacques_gordon/expo-mapbox-navigation", { "accessToken": "pk.xxx" }]'
     );
   }
 
-  // downloadsToken (a secret sk.* token with the Downloads:Read scope) is
-  // required on iOS to authenticate Swift Package Manager's fetch of the
-  // Mapbox Navigation SDK package — without it, `pod install`/`expo
-  // prebuild` will fail to resolve the SPM dependency declared in
-  // ExpoMapboxNavigation.podspec.
   if (!downloadsToken) {
     throw new Error(
-      '[@jacques_gordon/expo-mapbox-navigation] `downloadsToken` is required for iOS builds.\n' +
-      'This must be a SECRET Mapbox token (starts with "sk.") with the "Downloads:Read" scope,\n' +
-      'used to authenticate Swift Package Manager when fetching the Mapbox Navigation SDK.\n' +
-      'Add it to your app.json plugins array:\n' +
+      '[@jacques_gordon/expo-mapbox-navigation] `downloadsToken` (secret sk.* token) is required for iOS.\n' +
       '  ["@jacques_gordon/expo-mapbox-navigation", { "accessToken": "pk.xxx", "downloadsToken": "sk.xxx" }]'
     );
   }
 
-  const [major, minor] = mapboxMapsVersion.split('.').map(Number);
-  if (major < 11 || (major === 11 && minor < 11)) {
-    throw new Error(
-      `[@jacques_gordon/expo-mapbox-navigation] mapboxMapsVersion must be >= 11.11.0.\n` +
-      `Provided: ${mapboxMapsVersion}`
-    );
-  }
-
-  // ── Android: project-level build.gradle ─────────────────────────────────
-  config = withProjectBuildGradle(config, (mod) => {
-    let contents = mod.modResults.contents;
-
-    if (!contents.includes('api.mapbox.com/downloads/v2/releases/maven')) {
-      const mavenBlock = `
-        maven {
-            url 'https://api.mapbox.com/downloads/v2/releases/maven'
-            authentication { basic(BasicAuthentication) }
-            credentials {
-                username = 'mapbox'
-                password = project.hasProperty('MAPBOX_DOWNLOADS_TOKEN')
-                    ? project.property('MAPBOX_DOWNLOADS_TOKEN')
-                    : System.getenv('MAPBOX_DOWNLOADS_TOKEN') ?: ""
-            }
-        }`;
-      if (contents.includes('allprojects') && contents.includes('repositories')) {
-        contents = contents.replace(
-          /allprojects\s*\{[\s\S]*?repositories\s*\{/,
-          (match) => match + mavenBlock
-        );
-      }
-    }
-
-    mod.modResults.contents = contents;
-    return mod;
-  });
-
-  // ── Android: app-level build.gradle ─────────────────────────────────────
+  // ── Android ───────────────────────────────────────────────────────────────
   config = withAppBuildGradle(config, (mod) => {
-    let contents = mod.modResults.contents;
-
-    if (!contents.includes('ndkVersion')) {
-      contents = contents.replace(
-        /android\s*\{/,
-        `android {\n    ndkVersion "${NDK_VERSION}"`
-      );
-    } else if (!contents.includes(NDK_VERSION)) {
-      contents = contents.replace(
-        /ndkVersion\s+["'][^"']*["']/,
-        `ndkVersion "${NDK_VERSION}"`
-      );
-    }
-
-    if (!contents.includes('useLegacyPackaging')) {
-      contents = contents.replace(
-        /android\s*\{/,
-        `android {\n    packagingOptions {\n        jniLibs {\n            useLegacyPackaging = false\n        }\n    }`
-      );
-    }
-
-    const resolutionBlock = `
-configurations.all {
-    resolutionStrategy {
-        force "com.mapbox.maps:android:${mapboxMapsVersion}"
-        force "com.mapbox.maps:android-ndk27:${mapboxMapsVersion}"
-    }
-}`;
-    if (!contents.includes('com.mapbox.maps:android:')) {
-      contents = contents + '\n' + resolutionBlock;
-    }
-
-    mod.modResults.contents = contents;
+    addAndroidConfig(mod, mapboxMapsVersion, androidColorOverrides);
     return mod;
   });
 
-  // ── Android: AndroidManifest ─────────────────────────────────────────────
   config = withAndroidManifest(config, (mod) => {
-    const manifest = mod.modResults.manifest;
-
-    // ── Permissions required by Mapbox Navigation SDK (targetSdk 35) ────────
-    //
-    // SecurityException: Starting FGS with type location requires:
-    //   - android.permission.FOREGROUND_SERVICE_LOCATION   (mandatory API 34+)
-    //   - android.permission.FOREGROUND_SERVICE             (mandatory)
-    //   - android.permission.ACCESS_FINE_LOCATION           (at least one of coarse/fine)
-    //   - android.permission.ACCESS_COARSE_LOCATION
-    //
-    const requiredPermissions = [
-      'android.permission.ACCESS_FINE_LOCATION',
-      'android.permission.ACCESS_COARSE_LOCATION',
-      'android.permission.FOREGROUND_SERVICE',
-      'android.permission.FOREGROUND_SERVICE_LOCATION',  // ← fixes the crash
-      'android.permission.POST_NOTIFICATIONS',            // needed for nav notification (API 33+)
-    ];
-
-    if (!manifest['uses-permission']) {
-      manifest['uses-permission'] = [];
-    }
-
-    for (const permission of requiredPermissions) {
-      const already = manifest['uses-permission'].some(
-        (p) => p.$?.['android:name'] === permission
-      );
-      if (!already) {
-        manifest['uses-permission'].push({ $: { 'android:name': permission } });
-      }
-    }
-
-    // ── Mapbox access token meta-data ────────────────────────────────────────
-    const mainApp = manifest.application?.[0];
-    if (mainApp) {
-      if (!mainApp['meta-data']) mainApp['meta-data'] = [];
-      const tokenMeta = mainApp['meta-data'].find(
-        (m) => m.$?.['android:name'] === 'com.mapbox.token'
-      );
-      if (!tokenMeta) {
-        mainApp['meta-data'].push({
-          $: { 'android:name': 'com.mapbox.token', 'android:value': accessToken },
-        });
-      }
-    }
-
+    addAndroidPermissions(mod, accessToken);
     return mod;
   });
 
-  // ── Android: color overrides ─────────────────────────────────────────────
-  if (Object.keys(androidColorOverrides).length > 0) {
-    config = withDangerousMod(config, [
-      'android',
-      async (mod) => {
-        const colorsDir = path.join(
-          mod.modRequest.platformProjectRoot,
-          'app/src/main/res/values'
-        );
-        if (!fs.existsSync(colorsDir)) fs.mkdirSync(colorsDir, { recursive: true });
-
-        const colorEntries = Object.entries(androidColorOverrides)
-          .map(([name, value]) => `    <color name="${name}">${value}</color>`)
-          .join('\n');
-
-        fs.writeFileSync(
-          path.join(colorsDir, 'mapbox_navigation_colors.xml'),
-          `<?xml version="1.0" encoding="utf-8"?>\n<resources>\n${colorEntries}\n</resources>\n`
-        );
-        return mod;
-      },
-    ]);
-  }
-
-  // ── iOS: Info.plist ──────────────────────────────────────────────────────
+  // ── iOS: Info.plist — MBXAccessToken + permissions ────────────────────────
   config = withInfoPlist(config, (mod) => {
     mod.modResults.MBXAccessToken = accessToken;
-
-    if (!mod.modResults.NSLocationWhenInUseUsageDescription) {
-      mod.modResults.NSLocationWhenInUseUsageDescription =
-        'Your location is used for turn-by-turn navigation.';
-    }
-    if (!mod.modResults.NSLocationAlwaysAndWhenInUseUsageDescription) {
-      mod.modResults.NSLocationAlwaysAndWhenInUseUsageDescription =
-        'Your location is used for turn-by-turn navigation even when the app is in the background.';
-    }
+    mod.modResults.NSLocationWhenInUseUsageDescription =
+      mod.modResults.NSLocationWhenInUseUsageDescription ||
+      'Your location is used for navigation.';
+    mod.modResults.NSLocationAlwaysAndWhenInUseUsageDescription =
+      mod.modResults.NSLocationAlwaysAndWhenInUseUsageDescription ||
+      'Your location is used for navigation.';
     if (!mod.modResults.UIBackgroundModes) mod.modResults.UIBackgroundModes = [];
     for (const mode of ['audio', 'location']) {
       if (!mod.modResults.UIBackgroundModes.includes(mode)) {
@@ -205,82 +58,145 @@ configurations.all {
     return mod;
   });
 
-  // ── iOS: .netrc for SPM authentication ───────────────────────────────────
-  // Swift Package Manager (used by ExpoMapboxNavigation.podspec's
-  // spm_dependency() to fetch the Mapbox Navigation SDK) authenticates
-  // against api.mapbox.com using a machine entry in the user's ~/.netrc
-  // file — this is Mapbox's documented mechanism for private SPM package
-  // access, identical in spirit to the MAPBOX_DOWNLOADS_TOKEN gradle
-  // property used on Android.
+  // ── iOS: .netrc for SPM authentication ────────────────────────────────────
+  // The Mapbox Navigation SDK v3 is distributed as source code via SPM only.
+  // Our podspec uses spm_dependency() to declare the dependency, and SPM
+  // authenticates against api.mapbox.com using ~/.netrc credentials.
+  // This is the official Mapbox-documented authentication mechanism.
   config = withDangerousMod(config, [
     'ios',
     (mod) => {
       const homeDir = require('os').homedir();
       const netrcPath = path.join(homeDir, '.netrc');
       const netrcEntry = `machine api.mapbox.com\nlogin mapbox\npassword ${downloadsToken}\n`;
-
       let existingContent = '';
       if (fs.existsSync(netrcPath)) {
         existingContent = fs.readFileSync(netrcPath, 'utf8');
       }
-
       if (!existingContent.includes('machine api.mapbox.com')) {
         fs.writeFileSync(netrcPath, existingContent + netrcEntry, { mode: 0o600 });
+        console.log('[@jacques_gordon/expo-mapbox-navigation] ✅ Wrote Mapbox credentials to ~/.netrc');
       }
-
       return mod;
     },
   ]);
 
-  // ── iOS: Add Mapbox Navigation SPM to Xcode project main target ───────────
-  //
-  // WHY NOT spm_dependency() IN THE PODSPEC:
-  // Using spm_dependency() in ExpoMapboxNavigation.podspec causes
-  // "43029 duplicate symbols" linker errors (React Native GitHub #47344,
-  // Expo GitHub #37813). The framework ends up linked in both the Pod target
-  // AND the main app target, so the linker sees every symbol twice.
-  //
-  // THE CORRECT APPROACH:
-  // Add MapboxNavigation as a Swift Package directly to the Xcode project's
-  // main target via withXcodeProject. This ensures only ONE copy of each
-  // framework is linked in the final binary — exactly the same technique
-  // used by rnmapbox/maps itself for MapboxMaps.
-  config = withXcodeProject(config, (mod) => {
-    const xcodeProject = mod.modResults;
-    const MAPBOX_NAV_REPO = 'https://github.com/mapbox/mapbox-navigation-ios.git';
-    const MAPBOX_NAV_VERSION = '3.25.0';
+  return config;
+};
+
+// ── Android helpers ───────────────────────────────────────────────────────────
 
-    // Check if already added to avoid duplicates on repeated prebuild
-    const existingPackages = xcodeProject.pbxXCRemoteSwiftPackageReferenceSection
-      ? Object.values(xcodeProject.pbxXCRemoteSwiftPackageReferenceSection())
-      : [];
-    const alreadyAdded = existingPackages.some(
-      (pkg) => pkg && pkg.repositoryURL && pkg.repositoryURL.includes('mapbox-navigation-ios')
+function addAndroidConfig(mod, mapboxMapsVersion, androidColorOverrides) {
+  if (!mod.modResults.contents.includes('abiFilters')) {
+    mod.modResults.contents = mod.modResults.contents.replace(
+      /defaultConfig {([\s\S]*?)}/,
+      `defaultConfig {\n          ndk {\n              abiFilters "arm64-v8a", "x86_64"\n          }\n          $1\n      }`
     );
+  }
 
-    if (!alreadyAdded) {
-      // Add the SPM package reference to the project
-      const packageRef = xcodeProject.addSwiftPackage(
-        MAPBOX_NAV_REPO,
-        {
-          repositoryURL: MAPBOX_NAV_REPO,
-          requirement: {
-            kind: 'upToNextMajorVersion',
-            minimumVersion: MAPBOX_NAV_VERSION,
-          },
-        },
-        [
-          // Products from MapboxNavigation SPM package that our Swift files import
-          { product: 'MapboxNavigationCore' },
-          { product: 'MapboxNavigationUIKit' },
-        ]
-      );
+  const workVersion = '2.8.0';
+  mod.modResults.contents = mod.modResults.contents.replace(
+    /implementation ['"]androidx.work:work-runtime-ktx:[\d.]+['"]/,
+    ''
+  );
+  if (!mod.modResults.contents.includes('work-runtime')) {
+    mod.modResults.contents += `
+    dependencies {
+        implementation 'androidx.work:work-runtime:${workVersion}'
+        implementation 'androidx.work:work-runtime-ktx:${workVersion}'
     }
+  `;
+  }
 
-    return mod;
-  });
+  if (!mod.modResults.contents.includes('dependencySubstitution')) {
+    const MAPS_VER = mapboxMapsVersion || '11.11.0';
+    const COMMON_VER = '24.11.3';
+    mod.modResults.contents += `
+      configurations.all {
+        resolutionStrategy {
+          dependencySubstitution {
+            substitute module('com.mapbox.maps:android') using module('com.mapbox.maps:android-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.maps:android-core') using module('com.mapbox.maps:android-core-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.maps:base') using module('com.mapbox.maps:base-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.common:common') using module('com.mapbox.common:common-ndk27:${COMMON_VER}')
+            substitute module('com.mapbox.module:maps-telemetry') using module('com.mapbox.module:maps-telemetry-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-attribution') using module('com.mapbox.plugin:maps-attribution-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-scalebar') using module('com.mapbox.plugin:maps-scalebar-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-gestures') using module('com.mapbox.plugin:maps-gestures-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-logo') using module('com.mapbox.plugin:maps-logo-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-compass') using module('com.mapbox.plugin:maps-compass-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-lifecycle') using module('com.mapbox.plugin:maps-lifecycle-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-animation') using module('com.mapbox.plugin:maps-animation-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-overlay') using module('com.mapbox.plugin:maps-overlay-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-annotation') using module('com.mapbox.plugin:maps-annotation-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-locationcomponent') using module('com.mapbox.plugin:maps-locationcomponent-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.plugin:maps-viewport') using module('com.mapbox.plugin:maps-viewport-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.extension:maps-localization') using module('com.mapbox.extension:maps-localization-ndk27:${MAPS_VER}')
+            substitute module('com.mapbox.extension:maps-style') using module('com.mapbox.extension:maps-style-ndk27:${MAPS_VER}')
+          }
+        }
+      }
+    `;
+  }
 
-  return config;
-};
+  // Android color overrides for Mapbox resource colors (route line, banner, etc.)
+  if (Object.keys(androidColorOverrides).length > 0) {
+    const resDir = path.join(
+      mod.modRequest?.platformProjectRoot || '',
+      'app', 'src', 'main', 'res', 'values'
+    );
+    try {
+      fs.mkdirSync(resDir, { recursive: true });
+      const colorEntries = Object.entries(androidColorOverrides)
+        .map(([name, value]) => `    <color name="${name}">${value}</color>`)
+        .join('\n');
+      const xmlContent = `<?xml version="1.0" encoding="utf-8"?>\n<resources>\n${colorEntries}\n</resources>\n`;
+      fs.writeFileSync(path.join(resDir, 'mapbox_color_overrides.xml'), xmlContent);
+    } catch (e) {
+      // Ignore — resDir may not exist at plugin resolution time
+    }
+  }
+}
+
+function addAndroidPermissions(mod, accessToken) {
+  const manifest = mod.modResults.manifest;
+  const application = manifest.application[0];
+
+  if (!application['meta-data']) application['meta-data'] = [];
+  const existingToken = application['meta-data'].find(
+    (item) => item['$']['android:name'] === 'com.mapbox.token'
+  );
+  if (!existingToken) {
+    application['meta-data'].push({
+      $: { 'android:name': 'com.mapbox.token', 'android:value': accessToken },
+    });
+  }
+
+  const requiredPermissions = [
+    'android.permission.ACCESS_FINE_LOCATION',
+    'android.permission.ACCESS_COARSE_LOCATION',
+    'android.permission.FOREGROUND_SERVICE',
+    'android.permission.FOREGROUND_SERVICE_LOCATION',
+    'android.permission.POST_NOTIFICATIONS',
+  ];
+  if (!manifest['uses-permission']) manifest['uses-permission'] = [];
+  for (const perm of requiredPermissions) {
+    if (!manifest['uses-permission'].find((p) => p['$']['android:name'] === perm)) {
+      manifest['uses-permission'].push({ $: { 'android:name': perm } });
+    }
+  }
+
+  if (!manifest.service) manifest.service = [];
+  const svcName = 'com.mapbox.navigation.core.trip.service.NavigationNotificationService';
+  if (!manifest.service.find((s) => s['$']['android:name'] === svcName)) {
+    manifest.service.push({
+      $: {
+        'android:name': svcName,
+        'android:foregroundServiceType': 'location',
+        'android:exported': 'false',
+      },
+    });
+  }
+}
 
 module.exports = withMapboxNavigation;