Usando Bibliotecas Nativas de Terceiros

# 1. Avalie ANTES de instalar (veja a lista de verificação abaixo)
# 2. Instale com o resolvedor do Expo - não npm puro
npx expo install react-native-maps
 
# 3. Registre o plugin de configuração em app.config.ts (se a biblioteca fornecer um)
# 4. Regenerar projetos nativos e verificar
npx expo prebuild --clean
npx expo-doctor
 
# 5. Construir um cliente de desenvolvimento - código nativo de terceiros NÃO está no Expo Go
npx expo install expo-dev-client
npx expo run:ios
# ou: eas build --profile development --platform all

// app.config.ts - registro típico de plugin de terceiros
import type { ExpoConfig } from "expo/config";
 
export default ({ config }: { config: ExpoConfig }): ExpoConfig => ({
  ...config,
  plugins: [
    [
      "react-native-maps",
      {
        iosGoogleMapsApiKey: process.env.GOOGLE_MAPS_IOS_KEY,
        androidGoogleMapsApiKey: process.env.GOOGLE_MAPS_ANDROID_KEY,
      },
    ],
  ],
});

#!/usr/bin/env bash
# scripts/verify-native-dep.sh - execute após adicionar uma biblioteca nativa
set -euo pipefail
 
PKG="${1:?Uso: ./verify-native-dep.sh <nome-do-pacote>}"
 
echo "▶ Instalando $PKG via expo install..."
npx expo install "$PKG"
 
echo "▶ Executando expo-doctor..."
npx expo-doctor
 
echo "▶ Resolvendo autolinking (iOS)..."
npx expo-modules-autolinking resolve --platform ios | grep -i "${PKG##*/}" || true
 
echo "▶ Execução de teste de prebuild limpo..."
npx expo prebuild --clean --no-install
 
echo "✅ $PKG passou na verificação local - ainda assim, construa no dispositivo"

npx create-expo-app@latest MapsCookbook --template blank-typescript@sdk-57 --yes
cd MapsCookbook
npx expo install expo-dev-client react-native-maps

// app.config.ts
import type { ExpoConfig } from "expo/config";
 
const defineConfig = ({ config }: { config: ExpoConfig }): ExpoConfig => ({
  ...config,
  name: "MapsCookbook",
  slug: "maps-cookbook",
  plugins: [
    [
      "react-native-maps",
      {
        iosGoogleMapsApiKey: process.env.GOOGLE_MAPS_IOS_KEY ?? "",
        androidGoogleMapsApiKey: process.env.GOOGLE_MAPS_ANDROID_KEY ?? "",
      },
    ],
  ],
});
 
export default defineConfig;

// App.tsx
import MapView, { Marker } from "react-native-maps";
import { StyleSheet, View } from "react-native";
 
export default function App() {
  return (
    <View style={styles.container}>
      <MapView
        style={styles.map}
        initialRegion={{
          latitude: 37.78825,
          longitude: -122.4324,
          latitudeDelta: 0.0922,
          longitudeDelta: 0.0421,
        }}
      >
        <Marker
          coordinate={{ latitude: 37.78825, longitude: -122.4324 }}
          title="San Francisco"
        />
      </MapView>
    </View>
  );
}
 
const styles = StyleSheet.create({
  container: { flex: 1 },
  map: { flex: 1 },
});

# Regenerar diretórios nativos e executar no simulador
npx expo prebuild
npx expo run:ios
 
# Iniciar Metro para o cliente de desenvolvimento (não Expo Go)
npx expo start --dev-client

# Confirmar Nova Arquitetura no projeto gerado
grep -r "newArchEnabled" android/ ios/ 2>/dev/null || true
 
# Forçar verificação com um build de release em dispositivo (não apenas debug Metro)
npx expo run:ios --configuration Release

# Listar módulos que serão compilados no binário
npx expo-modules-autolinking resolve --platform ios
npx expo-modules-autolinking resolve --platform android
 
# Autolinking da comunidade React Native (pacotes não-Expo)
npx react-native config