Expo Brownfield

Quando Usar

Use esta habilidade quando precisar integrar Expo e React Native em um aplicativo nativo iOS ou Android existente. Use quando o usuário mencionar brownfield, incorporar React Native em um aplicativo nativo, AAR/XCFramework, ou adicionar Expo a um projeto Kotlin/Swift existente. Abrange tanto a abordagem isolada quanto a abordagem integrada.

Um aplicativo brownfield é um aplicativo nativo iOS ou Android existente que adota o React Native incrementalmente, em oposição a um aplicativo greenfield, que é React Native desde o primeiro dia.

O Expo suporta duas maneiras distintas de adicionar React Native a um projeto brownfield:

Para a matriz de decisão completa, consulte ./references/comparison.md.

Escolha uma abordagem

Use estas regras rápidas — caia para comparison.md para qualquer coisa ambígua.

• Escolha isolada se a equipe iOS/Android precisar consumir RN como uma dependência de biblioteca regular (AAR ou XCFramework), sem instalar Node, Yarn ou a cadeia de ferramentas de compilação do React Native.
• Escolha isolada se o código RN e o código nativo residirem em repositórios separados ou forem lançados em cadências independentes.
• Escolha integrada se uma única equipe for responsável pelo código nativo e RN e estiver disposta a adicionar React Native + Expo à configuração do Gradle e CocoaPods do projeto nativo.
• Escolha integrada se você quiser que o hot reload e os mapas de origem JS funcionem perfeitamente dentro do processo de compilação nativo existente.

Referências

• ./references/brownfield-isolated.md -- Compile RN como AAR/XCFramework e consuma do aplicativo nativo (BrownfieldActivity, ReactNativeViewController, ReactNativeView)
• ./references/brownfield-integrated.md -- Adicione RN e Expo diretamente às compilações Gradle e CocoaPods existentes (ReactActivity, RCTRootView, Podfile)
• ./references/comparison.md -- Critérios de decisão, prós e contras, e mapeamento de cenários para escolher uma abordagem
• ./references/troubleshooting.md -- Conexão Metro, compilação, assinatura e problemas de resolução de módulos comuns a ambas as abordagens

Mais informações disponíveis em https://docs.expo.dev/brownfield/overview/

Pré-requisitos compartilhados

Ambas as abordagens exigem, no ambiente que compila o lado do React Native:

• Node.js (LTS) — executa o Expo CLI e o código JavaScript.
• Yarn — gerencia dependências JavaScript.

A abordagem integrada requer adicionalmente CocoaPods no iOS (sudo gem install cocoapods). A abordagem isolada não requer CocoaPods ou qualquer ferramenta RN no aplicativo nativo consumidor.

Nota de versionamento

Expo SDK 55 é a versão mínima suportada para integração brownfield. SDKs anteriores não possuem expo-brownfield, os pontos de entrada ExpoReactHostFactory / ExpoReactNativeFactory necessários e a superfície de autolinking atual. Ao criar o projeto Expo, sempre fixe o SDK explicitamente:

npx create-expo-app@latest my-project --template default@sdk-55

Fixe o mesmo Expo SDK tanto no projeto RN quanto em quaisquer dependências incorporadas.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao seu escopo de produto ou API upstream.
• Verifique comandos, comportamento da API, preços, cotas, credenciais e efeitos de implantação contra a documentação oficial atual antes de fazer alterações.
• Não trate exemplos gerados como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.