In-App Atualizações

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

Permita que seus testadores se atualizem facilmente 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. Uma vez concluídos, todos os lançamentos futuros através do App Center acionarão uma notificação no aplicativo para cada testador, permitindo uma atualização rápida para a versão mais recente.

Importante

Neste momento, existem algumas limitações para In-App atualizações:

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

Atualizações Públicas de In-App

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

Compatibilidade com lojas de aplicativos

Androide

Se a aplicação estiver instalada a partir do Google Play ou de outras lojas em vez do App Center, a verificação de novas versões será desativada.

O Google pode considerar o código de atualização no aplicativo como um comportamento mal-intencionado, mesmo que não seja usado em tempo de execução. Recomendamos que você remova esse código do seu aplicativo antes de enviá-lo para o Google Play. Para facilitar, fornecemos a versão do App Center Distribute SDK com APIs 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 a partir da 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á desativada.

Perguntas Frequentes

1. Por que os testadores são solicitados a 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 eliminou os cookies do navegador padrão do dispositivo.
  • O testador desativou os 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.

2. 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 recebam notificações de atualização no aplicativo:
  • O recurso de distribuição do SDK do App Center está desativado. O recurso de distribuição do SDK do App Center deve ser habilitado e inicializado na inicialização do aplicativo. Se os testadores instalaram uma versão com o recurso de distribuição desativado, eles precisarão instalar a versão mais recente manualmente.
  • A verificação automática de atualizações está desativada. Se a verificação automática de atualizações estiver desativada, o aplicativo não verificará se há novas versões na inicialização. A verificação acontece quando checkForUpdate é chamado.
  • A versão de lançamento do seu aplicativo está incorreta para uma nova versão
    • Para Android: código de versão incremental.
    • Para iOS: incrementar CFBundleShortVersionString e seguir os padrões de versionamento semântico

3. Por que os testadores veem a mensagem "Atualização no aplicativo desabilitada"?

• Vários cenários podem fazer com que o SDK do App Center exiba esta mensagem:
  • A aplicação não foi instalada a partir do App Center.
  • A versão instalada por um testador não foi lançada via 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.
    • Se você migrou seu aplicativo do HockeyApp, consulte os seguintes artigos:
      • iOS: [Migrando do HockeyApp][ios-sdk-migration]
      • Android: [Migrando do HockeyApp][android-sdk-migration]