feat: add expo support

Author: pinpong

.gitignore

@@ -94,3 +94,4 @@ android/.kotlin/
 android/.kotlinc/
 
 tsconfig.tsbuildinfo
+expoConfig/build

README.md

@@ -22,6 +22,27 @@ React-native wrapper for android & IOS google maps sdk
 yarn add react-native-google-maps-plus react-native-nitro-modules
 ```
 
+### Expo Projects
+
+Add your keys to the `app.json`.
+The config plugin automatically injects them into your native Android and iOS builds during `expo prebuild`.
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "react-native-google-maps-plus",
+        {
+          "googleMapsAndroidApiKey": "YOUR_ANDROID_MAPS_API_KEY",
+          "googleMapsIosApiKey": "YOUR_IOS_MAPS_API_KEY"
+        }
+      ]
+    ]
+  }
+}
+```
+
 # Dependencies
 
 This package builds on native libraries for SVG rendering and Google Maps integration:

app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./expoConfig/build');

eslint.config.mjs

@@ -24,6 +24,12 @@ export default defineConfig([
     },
   },
   {
-    ignores: ['node_modules/', 'lib/', '.yarn', 'eslint.config.mjs'],
+    ignores: [
+      'node_modules/',
+      'lib/',
+      'expoConfig/build',
+      '.yarn',
+      'eslint.config.mjs',
+    ],
   },
 ]);

expoConfig/src/android/withAndroidGoogleMapsPlus.ts

@@ -0,0 +1,43 @@
+import { withAndroidManifest } from '@expo/config-plugins';
+import type { ConfigPlugin } from '@expo/config-plugins';
+import {
+  addMetaDataItemToMainApplication,
+  getMainApplicationOrThrow,
+  removeMetaDataItemFromMainApplication,
+} from '@expo/config-plugins/build/android/Manifest';
+import type { RNGoogleMapsPlusExpoPluginProps } from '../types';
+
+const withMapsAndroid: ConfigPlugin<RNGoogleMapsPlusExpoPluginProps> = (
+  config,
+  props
+) => {
+  return withAndroidManifest(config, (conf) => {
+    const manifest = conf.modResults;
+    const mainApplication = getMainApplicationOrThrow(manifest);
+
+    const apiKey =
+      props.googleMapsAndroidApiKey ??
+      process.env.GOOGLE_MAPS_API_KEY_ANDROID ??
+      null;
+
+    if (apiKey) {
+      addMetaDataItemToMainApplication(
+        mainApplication,
+        'com.google.android.geo.API_KEY',
+        apiKey
+      );
+    } else {
+      removeMetaDataItemFromMainApplication(
+        mainApplication,
+        'com.google.android.geo.API_KEY'
+      );
+      console.warn(
+        '[react-native-google-maps-plus] No Android API key provided. Removed existing entry.'
+      );
+    }
+
+    return conf;
+  });
+};
+
+export default withMapsAndroid;

expoConfig/src/index.ts

@@ -0,0 +1,23 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+import type { RNGoogleMapsPlusExpoPluginProps } from './types';
+import fs from 'fs';
+import path from 'path';
+
+const pkg = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, '../../package.json'), 'utf8')
+);
+
+import { createRunOncePlugin } from '@expo/config-plugins';
+import withIosGoogleMapsPlus from './ios/withIosGoogleMapsPlus';
+import withAndroidGoogleMapsPlus from './android/withAndroidGoogleMapsPlus';
+
+const withGoogleMapsPlus: ConfigPlugin<RNGoogleMapsPlusExpoPluginProps> = (
+  config,
+  props
+) => {
+  config = withAndroidGoogleMapsPlus(config, props);
+  config = withIosGoogleMapsPlus(config, props);
+  return config;
+};
+
+module.exports = createRunOncePlugin(withGoogleMapsPlus, pkg.name, pkg.version);

expoConfig/src/ios/withIosGoogleMapsPlus.ts

@@ -0,0 +1,154 @@
+import {
+  withInfoPlist,
+  withPodfile,
+  withAppDelegate,
+  type ConfigPlugin,
+} from '@expo/config-plugins';
+import { mergeContents } from '@expo/config-plugins/build/utils/generateCode';
+import type { RNGoogleMapsPlusExpoPluginProps } from '../types';
+
+const withIosGoogleMapsPlus: ConfigPlugin<RNGoogleMapsPlusExpoPluginProps> = (
+  config,
+  props
+) => {
+  config = withInfoPlist(config, (conf) => {
+    const apiKey =
+      props.googleMapsIosApiKey ?? process.env.GOOGLE_MAPS_API_KEY_IOS ?? null;
+
+    if (!apiKey) {
+      console.warn(
+        '[react-native-google-maps-plus] No iOS API key provided. Google Maps may fail to initialize.'
+      );
+    }
+    if (apiKey) {
+      conf.modResults.MAPS_API_KEY = apiKey;
+    }
+    return conf;
+  });
+
+  config = withPodfile(config, (conf) => {
+    let src = conf.modResults.contents;
+    if (!src.includes('use_modular_headers!')) {
+      src = mergeContents({
+        tag: 'react-native-google-maps-modular-headers',
+        src,
+        newSrc: 'use_modular_headers!',
+        anchor: /use_frameworks!|platform\s+:ios.*/,
+        offset: 1,
+        comment: '#',
+      }).contents;
+    }
+
+    const patchSnippet = `
+  # Force iOS 16+ to avoid deployment target warnings
+  installer.pods_project.targets.each do |target|
+    target.build_configurations.each do |config|
+      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '16.0'
+    end
+  end
+
+  # --- SVGKit Patch ---
+  require 'fileutils'
+  svgkit_path = File.join(installer.sandbox.pod_dir('SVGKit'), 'Source')
+
+  # --- Patch Node.h imports ---
+  Dir.glob(File.join(svgkit_path, '**', '*.{h,m}')).each do |file|
+    FileUtils.chmod("u+w", file)
+    text = File.read(file)
+    new_contents = text.gsub('#import "Node.h"', '#import "SVGKit/Node.h"')
+    File.open(file, 'w') { |f| f.write(new_contents) }
+  end
+
+  # --- Patch CSSValue.h imports ---
+  Dir.glob(File.join(svgkit_path, '**', '*.{h,m}')).each do |file|
+    FileUtils.chmod("u+w", file)
+    text = File.read(file)
+    new_contents = text.gsub('#import "CSSValue.h"', '#import "SVGKit/CSSValue.h"')
+    File.open(file, 'w') { |f| f.write(new_contents) }
+  end
+
+  # --- Patch SVGLength.h imports ---
+  Dir.glob(File.join(svgkit_path, '**', '*.{h,m}')).each do |file|
+    FileUtils.chmod("u+w", file)
+    text = File.read(file)
+    new_contents = text.gsub('#import "SVGLength.h"', '#import "SVGKit/SVGLength.h"')
+    File.open(file, 'w') { |f| f.write(new_contents) }
+  end
+  `;
+
+    if (src.includes('post_install do |installer|')) {
+      src = src.replace(
+        /post_install do \|installer\|([\s\S]*?)end/,
+        (match, inner) => {
+          if (inner.includes('SVGKit Patch')) return match; // idempotent
+          return `post_install do |installer|${inner}\n${patchSnippet}\nend`;
+        }
+      );
+    } else {
+      src += `\npost_install do |installer|\n${patchSnippet}\nend\n`;
+    }
+
+    conf.modResults.contents = src;
+    return conf;
+  });
+
+  config = withAppDelegate(config, (conf) => {
+    const { language } = conf.modResults;
+    if (language !== 'swift') {
+      console.warn(
+        '[react-native-google-maps-plus] AppDelegate is not Swift; skipping GMSServices injection.'
+      );
+      return conf;
+    }
+
+    let src = conf.modResults.contents;
+
+    if (!src.includes('import GoogleMaps')) {
+      src = mergeContents({
+        tag: 'react-native-google-maps-import',
+        src,
+        newSrc: 'import GoogleMaps',
+        anchor: /^import React/m,
+        offset: 1,
+        comment: '//',
+      }).contents;
+    }
+
+    const initSnippet = `
+    if let apiKey = Bundle.main.object(forInfoDictionaryKey: "MAPS_API_KEY") as? String {
+      GMSServices.provideAPIKey(apiKey)
+    }`;
+
+    try {
+      src = mergeContents({
+        tag: 'react-native-google-maps-init',
+        src,
+        newSrc: initSnippet,
+        anchor:
+          /return\s+super\.application\s*\(\s*application\s*,\s*didFinishLaunchingWithOptions:\s*launchOptions\s*\)/,
+        offset: -1,
+        comment: '//',
+      }).contents;
+    } catch (error: any) {
+      if (error.code === 'ERR_NO_MATCH') {
+        src = mergeContents({
+          tag: 'react-native-google-maps-init',
+          src,
+          newSrc: initSnippet,
+          anchor: /didFinishLaunchingWithOptions[^{]*\{/,
+          offset: 1,
+          comment: '//',
+        }).contents;
+      } else {
+        throw error;
+      }
+    }
+
+    conf.modResults.contents = src;
+    return conf;
+  });
+
+  return config;
+};
+
+export default withIosGoogleMapsPlus;

expoConfig/src/types.ts

@@ -0,0 +1,4 @@
+export type RNGoogleMapsPlusExpoPluginProps = {
+  googleMapsAndroidApiKey: string;
+  googleMapsIosApiKey: string;
+};

expoConfig/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "build",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src"]
+}

package.json

@@ -21,7 +21,8 @@
     "test": "jest",
     "git:clean": "git clean -dfX",
     "release": "semantic-release",
-    "build": "yarn nitrogen && bob build",
+    "build": "yarn nitrogen && bob build && yarn build:plugin",
+    "build:plugin": "tsc -p expoConfig/tsconfig.json",
     "nitrogen": "nitrogen --logLevel=\"debug\" && node scripts/nitrogen-patch.js",
     "prepare": "bob build"
   },
@@ -33,11 +34,13 @@
     "google-maps-sdk",
     "android",
     "ios",
-    "maps"
+    "maps",
+    "expo"
   ],
   "files": [
     "src",
     "lib",
+    "expoConfig/build",
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",
@@ -108,10 +111,16 @@
     "semantic-release": "25.0.0-beta.6"
   },
   "peerDependencies": {
+    "expo": "*",
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "*"
   },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
   "eslintConfig": {
     "root": true,
     "extends": [