Testando builds em dispositivos reais

  • 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 migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Neste documento, você aprenderá a integrar o Build do App Center e o Teste do App Center para executar sua compilação bem-sucedida mais recente em dispositivos reais.

Configurações com suporte

O teste de dispositivo do App Center requer:

  • Um aplicativo Android ou iOS .
  • O pacote do aplicativo é compatível com a execução em dispositivos físicos.

Configurando seu build

  1. Fazer logon https://appcenter.ms
  2. Crie seu aplicativo acessando Adicionar novo > aplicativo. Mais detalhes: Criando e gerenciando aplicativos
  3. Nomeie seu aplicativo, selecione o sistema operacional de destino do seu aplicativo e a plataforma que seu aplicativo usa.
  4. Selecione o ícone Compilar no lado esquerdo da tela.
  5. Conecte seu repositório de código. Mais detalhes: Introdução ao Build do App Center.
  6. Escolha seu branch.
  7. clique em Configurar para criar uma nova configuração ou clique no ícone de chave inglesa/engrenagem para editar uma configuração existente.
  8. Clique em Salvar

Se você fechar a página de configurações sem salvar, o padrão será voltar às configurações anteriores. Salvar é desabilitado quando as configurações são inválidas ou faltam informações necessárias.

Habilitar o teste de inicialização

Usar o Teste de Inicialização não requer a gravação de testes ou uma licença para o Teste do App Center. Para aplicativos Android, o recurso Iniciar Teste lida automaticamente com testes usando Xamarin.UITest, enquanto para iOS ele usa Appium.

Selecione a opção Testar em um dispositivo real na página de configuração do branch. O teste de inicialização adiciona alguns minutos ao tempo de build, pois o build aguarda a conclusão do teste. O benefício é que você sabe se seu aplicativo é iniciado em um dispositivo físico.

Encontrar o resultado do teste de inicialização pode ser feito de algumas maneiras:

  • Na página de resultados de cada Build, um link para o teste de inicialização é exibido.
  • Vá para Testar no menu à esquerda e selecione Test Series > Launch-Tests para exibir todos os testes de inicialização desse aplicativo.

Dica

Algumas configurações do Android podem criar vários arquivos APK. O que não deixa claro para o serviço de build qual binário testar. Desabilite Gerar um pacote (.apk) por ABI selecionado nas opções de Build do Android para resolve o problema. Os aplicativos Android exigem permissões de Internet para o Teste de Inicialização. Certifique-se de declarar permissões de Internet no manifesto do aplicativo.

Implantar automaticamente no teste do App Center

Você pode integrar o Build & Test para executar um conjunto de testes de interface do usuário com cada build do seu aplicativo. Esse recurso tem requisitos e limitações adicionais em comparação com o Teste de Inicialização:

  • Uma avaliação de teste válida ou uma licença paga é necessária.
  • Atualmente, há suporte apenas para testes de interface do usuário escritos usando Appium (JUnit), Calabash, Espresso, XCUITest ou Xamarin.UITest.
  • Algumas estruturas de teste exigem configuração adicional para habilitar o suporte ao Teste do App Center, incluindo Appium, Espresso & XCUITest
  • Use um script pós-build para lidar com todas as tarefas que seu conjunto de testes requer que não sejam tratadas diretamente pelo build do aplicativo. Essas tarefas podem incluir a compilação de dlls de teste & um comando para carregar o conjunto de testes no serviço de teste.
  • O serviço build não estende seu limite de tempo limite (1 hora) para UITests completos, portanto, a menos que as execuções de teste sejam curtas, é necessário usar o --async sinalizador no comando de upload. A status de conclusão do build não refletirá se o conjunto de testes foi aprovado ou não.

Instruções passo a passo:

  1. Configure seu aplicativo, compilar & teste de avaliação ou licença. (Você pode ignorar a configuração Iniciar Teste no Build).
  2. Confirme se o conjunto de testes é executado localmente em um dispositivo físico e se você pode carregá-lo localmente no serviço de teste.
  3. Escreva seu script pós-build. As variáveis de ambiente podem ajudá-lo a escrever um script de build válido.
  4. Salve sua configuração de build no App Center após a primeira vez que você confirmar um script de build ou se alterar sua localização em seu repositório. O script de build deve estar localizado na pasta raiz do projeto de main aplicativo.
  5. No script de build, crie seu conjunto de testes se ele ainda não tiver sido compilado junto com seu aplicativo main.
  6. Também dentro do script de build, forneça e execute um comando de upload para o Teste do App Center que:
  • Aponta para todas as dependências de Teste, incluindo as dlls de teste, o pacote do aplicativo & quaisquer outros requisitos do teste, como arquivos de dados incluídos.
  • Use o --async comando para garantir que o Build não aguarde a conclusão do conjunto de testes
  • Exclua as dependências do aplicativo, que já devem estar presentes no pacote do aplicativo. Incluir dependências de aplicativo no upload pode causar um comportamento imprevisível em sua execução de teste.

Scripts de build de teste de exemplo

Você pode exibir exemplos de scripts de build válidos aqui: