Como atualizar Mobile SDK
Este guia cobre o Oz Mobile SDK para Android, iOS e Flutter.
Antes de atualizar
Verifique qual versão está em uso. Toda plataforma expõe a versão do SDK em tempo de execução:
Android
OzLivenessSDK.version
iOS
OZSDK.version
Flutter
await OZSDK.getSDKVersion()
A versão também é exibida na tela de captura quando o version-on-screen recurso de licença está ativado.
Leia o changelog de todas as versões entre a sua e a de destino, não apenas a mais recente. As atualizações são cumulativas: ao migrar para uma nova versão, você também recebe todas as alterações lançadas desde a sua versão atual.
No changelog, preste atenção em:
versões marcadas Crítico: elas contêm proteção contra ataques ativos e definem o prazo de atualização sob esta política;
versões principais (o primeiro número muda, por exemplo, 9.x → 10.0): elas podem conter mudanças de API incompatíveis;
versão mínima do Oz API: alguns recursos do SDK exigem uma versão mínima da API. Por exemplo, o fluxo completo do OzCapsula exige Native SDK 10.0.0 e Oz API 6.6.1. Se você executa Oz API on-premise, atualize a API primeiro.
Atualizar
Android
No módulo
build.gradle, altere a versão do artefato que você já usa. Mantenha o mesmo artefato::sdk(baseado em servidor) ou:full(baseado em servidor + no dispositivo).Certifique-se de que o repositório Maven da Oz
https://ozforensics.jfrog.io/artifactory/mainainda esteja em seus repositórios.Sincronize o Gradle, reconstrua e execute as verificações da Depois de atualizar seção.
iOS
CocoaPods
No
Podfile, defina a nova versão:Execute
pod update OZLivenessSDK.
Swift Package Manager
No Xcode, abra Package Dependencies, selecione
OzLivenessSDK, defina a nova versão e atualize o pacote.
Instalação manual
Substitua
OZLivenessSDK.xcframeworkeOZLivenessSDKResources.bundlepelos arquivos da nova versão. Não misture arquivos de versões diferentes.
Em seguida, reconstrua e execute as verificações da Depois de atualizar seção.
Flutter
Em
pubspec.yaml, defina a nova versão:Execute
flutter pub upgrade ozsdkdepoispod installnaios/pasta.Reconstrua e execute as verificações da seção "Depois de atualizar".
O plugin do Flutter envolve os SDKs nativos e é lançado separadamente, portanto sua versão mais recente pode ficar atrás dos SDKs nativos. Verifique a versão mais recente do plugin em nosso changelog do Flutter. Para apps Flutter, os prazos de atualização são contados a partir da data de lançamento da versão do plugin que contém a correção.
Depois de atualizar
Verifique a versão em tempo de execução (veja Antes de atualizar) em uma build que será lançada.
Execute seus cenários de regressão: inicialização da licença, conexão com o Oz API, uma captura completa com análise, cancelamento da captura pelo usuário e o caminho de erro (sem permissão de câmera, sem rede).
Verifique a build de release, não apenas a build de debug. Algumas alterações afetam apenas builds de release.
Publique o app na App Store / Google Play.
Alcançando seus usuários mais rapidamente
Publicar uma atualização do app não atualiza os apps já instalados nos dispositivos dos seus usuários. Os usuários mantêm a versão antiga do SDK até atualizarem o app, e no mobile isso normalmente leva meses. Para tornar atualizações críticas eficazes, recomendamos:
usar uma verificação da versão mínima suportada do app no seu backend ou app, para que você possa exigir que os usuários atualizem após um lançamento crítico;
no Android, usar Google Play In-App Updates (fluxo imediato para atualizações críticas);
acompanhar a versão do SDK que vem com cada solicitação ao Oz API para ver com que rapidez seus usuários migram para a nova versão.
Atualizado
Isto foi útil?
