Pular para o conteúdo principal
Nesta página

O pacote mantido está atualmente na versão 2.2.0. Implante a solução em produção e revise o histórico de alterações do código antes de cada atualização. Esta página resume as alterações que impactam a integração, verificadas em relação aos commits do repositório. 0737d90237abe3bf28a41047b74cf14bc4ffcc8b; utilize Histórico de alterações Para o registro completo e exemplos de migração.

Fluxo de atualização#

01 · classify
Identifique seu fluxo de trabalho atual.
Registre as versões do React Native e Expo, se você está usando a abordagem CLI ou gerenciada, adaptadores, carteiras, provedores de prevenção de fraude e as versões atuais dos SDKs nativos.
02 · regenerate
Instale as alterações nativas.
Atualize o pacote, execute os Pods para a CLI ou execute novamente o pré-build do Expo quando as configurações ou permissões forem alteradas.
03 · exercise
Teste ambas as plataformas
Execute o mesmo widget, redirecionamento, carteira, prevenção de fraude, ciclo de vida e matriz de acessibilidade tanto no Android quanto no iOS.
04 · release
Monitore o código JavaScript e as camadas nativas
Correlacione erros de JavaScript, falhas nativas, tratamento de ações externas e resultados de pagamento autoritativos.
Diagrama de fluxo
React Native CLIExpo prebuild1Update npm package2Project workflow3Install Pods andresolve nativebuilds4Rerun prebuild andinspect pluginoutput5Test Android and iOS6Pinned productionrelease

Lançamentos notáveis#

v2.2.0 · Fornecedores nativos de fraude unificadosVersão atualmente verificada
  • Adiciona DeunaFraudModule suporte para Android e iOS.
  • Adiciona a inicialização antecipada do Mercado Pago e suporte para o conjunto de provedores de fraude documentado.
  • Adiciona o plugin Expo. withFraudProviders config.
  • Atualiza as dependências do SDK DEUNA para Android e iOS.

Inicialize os provedores necessários antecipadamente, verifique a saída do plugin de configuração e teste o caminho de ausência/timeout para cada provedor. Não bloqueie todos os pagamentos unicamente porque os dados de dispositivo opcionais estão indisponíveis, a menos que isso seja a política de risco explicitamente aprovada.

v2.1.10–2.1.6 · Melhoria da confiabilidade do redirecionamento, popup e APMReforço de ações externas

Esta linha habilita cookies de terceiros necessários para o Android, adiciona proteção em nível de processo contra lançamentos duplicados de URLs externas, corrige o comportamento do popup, inclui tipos de TypeScript versionados, centraliza os logs e adiciona o errorApmMissingReference Caminho de erro.

Realize tentativas repetidas de 3DS/APM, transições de volta para o aplicativo, encerramento do cliente e uma nova sessão do widget após uma falha no redirecionamento. Não remova a proteção contra lançamentos duplicados em um adaptador de aplicativo.

v2.1.x · Apple Pay e Google Pay nativosConfiguração nativa necessária

A versão 2.1 adicionou a disponibilidade e o lançamento de carteiras nativas. Projetos React Native CLI devem instalar dependências nativas; projetos Expo devem executar novamente o prebuild para que os plugins de configuração apliquem a configuração nativa necessária. O Apple Pay também requer a permissão do aplicativo e o ID do comerciante, e a disponibilidade do Google Pay depende da ativação do comerciante.

Siga o guia atual de disponibilidade de carteiras e as notas da ferramenta do changelog upstream para suas versões exatas de React Native, Xcode, Android Gradle Plugin e Kotlin.

v2.0.0 · Adaptador de navegador embutidoMigração principal

O SDK parou de incluir expo-web-browser. Pagamentos que exigem uma aba personalizada ou Safari View Controller agora usam o InAppBrowserAdapter contrato. Fluxos compatíveis com WebView padrão podem manter o comportamento padrão; os fluxos de carteira externa e redirecionamento devem fornecer e testar o adaptador correto.

Veja Redirecionamentos externos para a interface mantida. A promessa do adaptador e o ciclo de vida do aplicativo devem representar com precisão o fluxo do navegador para que o SDK não abra ou feche a visualização errada.

Compatibilidade com o fluxo de trabalho#

AlteraçãoReagir CLI nativoPré-build do Expo
Correção apenas em JavaScriptInstalar o pacote e reconstruir o aplicativoInstalar o pacote e reconstruir o aplicativo
Dependência do SDK nativoInstalar Pods e resolver dependências do AndroidExecutar novamente o pré-build, inspecionar os projetos nativos gerados e, em seguida, reconstruir
Suporte para carteiraConfigurar as permissões e dependências nativas manualmenteConfigurar as configurações do aplicativo e executar novamente o plugin de configuração da carteira
Provedor de fraudeAdicionar as configurações nativas necessárias e Pods/subspecsConfigurar o provedor e executar novamente withFraudProviders
Adaptador de navegador embutidoInstalar e configurar o pacote de navegador nativo selecionadoInstalar o pacote compatível e regenerar quando as configurações nativas forem alteradas

Lista de verificação de regressão#

  • Compilação do TypeScript, juntamente com a reconstrução das versões nativas do Android e iOS.
  • Atualização a partir da versão atualmente em produção, não apenas uma instalação limpa.
  • Widget de pagamento, Elementos, Voucher e Próxima Ação em modos de modal e embutido.
  • 3DS e APM redirecionados, prevenção de duplicação, cancelamento, retorno e retentativa.
  • Apple Pay e Google Pay em dispositivos físicos com autenticação/configuração válida.
  • Cada provedor de prevenção de fraude habilitado após o período de inicialização e durante a inicialização tardia.
  • Fast Refresh, modo de fundo/frente, recriação de processo, desmontagem de tela e descarte de controlador.
  • Telas pequenas, ajuste de fonte, leitores de tela, navegação por teclado e redução de movimentos.
  • Reconciliação no backend após todas as chamadas de sucesso, erro e de encerramento.