Compartilhar via


Atualizações do In-App

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

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 para atualização se não houver nenhuma alteração nos 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.

Atualizações de In-App públicas

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

Andróide

Se o aplicativo estiver instalado no Google Play ou em 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 não seja usado em runtime. Recomendamos que você remova esse código do seu aplicativo antes de enviá-lo ao Google Play. Para facilitar, fornecemos uma versão do SDK de Distribuição do App Center com APIs simuladas, 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 na App Store ou TestFlight, as atualizações no aplicativo não estarão disponíveis e a verificação de novas versões será desabilitada.

Perguntas Freqüentes

  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 os cookies no 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 verificação automática de atualização está desabilitada. Se a verificação automática de atualização estiver desabilitada, 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 um novo lançamento
      • Para Android: incrementar código de versão.
      • Para iOS: incrementar CFBundleShortVersionString e estar em conformidade com os padrões de versão semântica
  1. 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:
    • 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, vá para 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]