Partilhar via

In-App Atualizações

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Permitir que os testadores fiquem atualizados com facilidade com as versões mais recentes. Integre o SDK do App Center (e o Módulo de Distribuição) para iOS, Android ou MAUI/Xamarin para habilitar automaticamente a notificação no aplicativo para novas versões. Após a conclusão, todas as versões futuras por meio do App Center dispararão uma notificação no aplicativo para cada testador, permitindo uma atualização rápida para a versão mais recente.

Importante

Neste momento, há algumas limitações para In-App Atualizações:

  1. Os dispositivos Android não serão solicitados a atualizar se não houver nenhuma alteração em versionCode ou versionName.
  2. Para atualizações públicas no aplicativo do iOS, se você usar a faixa privada, a Apple terá uma caixa de diálogo padrão que deve ser descartada. O logon não é necessário para o fluxo público.
  3. In-App Atualizações não funcionam em aplicativos Windows/UWP.

In-App Atualizações público

Para habilitar atualizações públicas no aplicativo, crie um grupo de distribuição pública e distribua uma versão com o SDK do App Center. Depois que os testadores instalarem o aplicativo, eles serão alertados quando novas versões estiverem disponíveis publicamente.

Compatibilidade com repositórios de aplicativos

Android

Se o aplicativo estiver instalado do Google Play ou de outras lojas em vez do App Center, a verificação de novas versões será desabilitada.

O Google pode considerar o código de atualização no aplicativo como um comportamento mal-intencionado, mesmo que ele não seja usado em runtime. Recomendamos que você remova esse código do aplicativo antes de enviá-lo ao Google Play. Para facilitar, fornecemos a versão do SDK de Distribuição do App Center com APIs com stubbed, portanto, a única alteração para você é uma troca de dependência. Você pode encontrar as instruções detalhadas nas páginas Android, MAUI/Xamarin ou Unity .

iOS

Se o aplicativo estiver instalado do App Store ou do TestFlight, as atualizações no aplicativo não estarão disponíveis e a verificação de novas versões será desabilitada.

Perguntas frequentes

  1. Por que os testadores são solicitados a se autenticar repetidamente?
  • O SDK do App Center usa o navegador padrão de um dispositivo para armazenar cookies. Nos seguintes casos, o SDK solicitará a reautenticação:
    • O testador limpou cookies do navegador padrão do dispositivo.
    • O testador desabilitou cookies para o navegador padrão do dispositivo.
    • O testador fechou a primeira janela de autenticação depois de abrir o aplicativo.
    • O Segredo do Aplicativo usado para inicializar o SDK não é o mesmo listado no portal da Web do App Center.
  1. Por que os testadores não veem uma mensagem de atualização no aplicativo quando uma nova versão do aplicativo é lançada?
  • Vários cenários podem fazer com que os testadores não obtenham notificações de atualização no aplicativo:
    • O recurso de distribuição do SDK do App Center está desabilitado. O recurso de distribuição do SDK do App Center deve ser habilitado e inicializado na inicialização do aplicativo. Se os testadores instalassem uma versão com o recurso de distribuição desabilitado, eles precisariam instalar a versão mais recente manualmente.
    • A marcar automática para atualização está desabilitada. Se o marcar automático para atualização estiver desabilitado, o aplicativo não marcar para novas versões na inicialização. O marcar acontece quando checkForUpdate é chamado.
    • A versão de versão do aplicativo está incorreta para uma nova versão
      • Para Android: incrementar código de versão.
      • Para iOS: incrementar CFBundleShortVersionString e estar em conformidade com os padrões de controle de versão semântico
  1. Por que os testadores veem a mensagem "Atualização no aplicativo desabilitada"?
  • Vários cenários podem tornar o SDK do App Center para exibir esta mensagem:
    • O aplicativo não foi instalado do App Center.
    • A versão que um testador instalou não foi lançada por meio do App Center ou a versão foi excluída no App Center.
    • O segredo do aplicativo usado no SDK está incorreto. Para obter o segredo do aplicativo, acesse a página de configurações do aplicativo, clique nos pontos verticais triplos no canto superior direito e copie o segredo do aplicativo.