Pular para o conteúdo principal
Nesta página

O repositório e o podspec do iOS estão atualmente com a versão mais recente. v2.12.6Defina uma versão específica para produção e revise o artefato original antes de cada atualização. Esta página resume as alterações que impactam a integração, verificadas em relação ao commit do repositório. 96501079d01ce15ecaf43d486dd0b2e8c86ab8df; Não substitui a documentação completa Histórico de lançamentos do repositório.

Fluxo de atualização#

01 · inventory
Registre a versão atual.
Capture a origem do pacote, sub-pacotes do CocoaPods, entitlements, frameworks de prevenção de fraude, callbacks e modos de apresentação.
02 · resolve
Atualize as dependências.
Altere a versão, resolva pacotes ou pods e inspecione o grafo e os manifestos de privacidade resultantes.
03 · exercise
Teste em dispositivos reais.
Teste widgets, carteiras, provedores de fraude, redirecionamentos, 3DS, APMs, transições de ciclo de vida e acessibilidade.
04 · release
Monitore os resultados.
Compare os erros, a cobertura de callbacks, a inicialização do provedor e os resultados de pagamento no backend com a versão anterior.

Principais lançamentos#

v2.12.x · Provedores de fraude e APM modularizadosVersão atualmente verificada
  • v2.12.6 Adiciona suporte nativo de impressão digital de fraude do Mercado Pago e uma sub-especificação dedicada do CocoaPods.
  • Anteriormente v2.12.x Implementa provedores de fraude suportados de forma modular, adiciona o gerenciamento de dependências em tempo de execução e inclui atualizações nos manifestos de privacidade para frameworks de fornecedores aplicáveis.
  • v2.12.4 Adiciona tratamento explícito para uma referência de APM que não pode ser gerada ou exibida.
  • v2.12.2 Adiciona eventos de ciclo de vida do Elements, configuração de domínio e consistência userInfo forwarding.

Reverifique cada provedor de prevenção de fraude habilitado com a mesma subespecificação e configuração de aplicação. A ausência de frameworks de tempo de execução pode aparecer como dados de dispositivo vazios, em vez de um erro de compilação.

v2.11.x · Carteira nativa e funcionalidade de apresentaçãoCiclo de vida da carteira e widget

Esta linha introduziu e refinou a disponibilidade da carteira nativa e o comportamento de lançamento, a configuração do Apple Pay, o trabalho de auto-redimensionamento do widget, a execução de conclusão na thread principal e a desativação mais segura do controlador.

Verifique as permissões, identificadores do comerciante, redes suportadas, disponibilidade de dispositivos físicos, cancelamento, comportamento em segundo plano/primeiro plano e reconciliação no backend.

v2.4.0 · Alterações na resposta e apresentaçãoTipos de payload
  • Dados de resposta tipados, como ElementsResponseData, CheckoutResponseData, CardBinMetadatae InstallmentMetadata mudados para [String: Any] payloads.
  • PaymentsError tornou-se o tipo de erro público.
  • Descontinuado presentInModal e showCloseButton Os parâmetros foram removidos dos pontos de entrada mais antigos de Checkout e Elements.

Recomenda-se o uso das APIs de controle e apresentação atuais no guia para iOS,e evite comparações de igualdade estritas para dados de eventos adicionais.

v2.0.0 · Migração de símbolos públicosMigração principal

A principal linha renomeou os símbolos de callback, resposta e evento, incluindo Callbacks para CheckoutCallbacks e CheckoutEventType para CheckoutEventCompile todas as integrações e adaptadores de análise após atualizar as importações.

Matriz de compatibilidade#

SuperfícieVerificação de atualização
Gerenciador de dependênciasVersão exata do SPM ou versão do CocoaPods e subespecificações necessárias para resolução reprodutível
Ferramenta da ApplePonto de destino de implantação do aplicativo, Xcode, Swift, configurações do linker e manifestos de privacidade
ApresentaçãoPropriedade do UIKit e SwiftUI, modos modais e incorporados, redimensionamento automático, teclado e descarte
Ações externas3DS, ASWebAuthenticationSession ou fluxo de navegador aprovado, links profundos, cancelamento e devolução
Carteiras nativasEntitlements, ID do comerciante, capacidade do dispositivo físico, redes, tokenização e cancelamento
Provedores de fraudeFramework do fornecedor necessário, tempo de inicialização, timeout, dados ausentes e declarações de privacidade
CallbacksTrabalho da interface do usuário na thread principal, manipuladores dedicados, dados de eventos adicionais e fallback para eventos desconhecidos

Lista de verificação de regressão#

  • Instalação e atualização limpas da versão atualmente implantada usando o gerenciador de dependências de produção.
  • Crie builds de depuração e arquivamento nas versões mais antigas e mais recentes do sistema operacional suportado.
  • Widget de pagamento, elementos, voucher e próxima ação em todos os modos de apresentação suportados.
  • Rotação, Dynamic Type, VoiceOver, teclado, descarte de sheet, background/foreground e liberação de memória.
  • Disponibilidade do Apple Pay e autorização de pagamento em dispositivos físicos.
  • Verificação de todos os provedores de fraude nativos habilitados, com dados permitidos e tratamento de erros.
  • Recuperação no backend ou confirmação de webhook após cada resultado do cliente.