O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Provisionamento de dispositivos de teste

Para dispositivos que executam Android 6 ou Android 7, você pode testar o provisionamento de dispositivos usando o Android Enterprise (AE) Test Harness, que é um conjunto de testes para validar a compatibilidade corporativa de dispositivos Android. O arnês inclui aplicativos de apoio, casos de teste, arquivos de configuração, e um corredor de teste ( afw-test-tradefed ) construído sobre cts-tradefed . Antes de configurar o AE Harness de teste, certifique-se de completar Provisioning para a Administração de dispositivos .

Para dispositivos que executam o Android 8 ou superior, o uso da AE Harness de teste está obsoleta.

Configurando um ambiente de desenvolvimento

O ambiente de desenvolvimento para o AE Test Harness é semelhante ao sistema operacional Android. Siga os passos no Requisitos para a criação de uma máquina de desenvolvimento.

Baixando o código-fonte

Baixar o código fonte AE Harness de teste usando as etapas em Downloading a Fonte . O código-fonte AE Harness de teste está no ./test/AfwTestHarness projeto. O nome do branch determina a versão do AE Test Harness para baixar (cada plataforma Android tem uma versão separada do AE Test Harness). Por exemplo, o nome de filial para Android 7.0 Nougat é afw-test-harness-nougat-dev . Para inicializar o repo e baixar o código-fonte para este branch, use os seguintes comandos:

mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
repo init -u https://android.googlesource.com/platform/manifest -b afw-test-harness-nougat-dev
repo sync -j24

Para verificar o código-fonte de uma versão diferente, especifique o branch com a tag correspondente. As filiais disponíveis incluem:

Nome da filial Plataforma Android Suportada
afw-test-harness-nougat-dev Android 7.0
afw-test-harness-2.1 Android 7.0
afw-test-harness-marshmallow-dev Android 6.0
afw-test-harness-1.5 Android 6.0

Outros projetos de dependência necessários para construir o chicote também são baixados com o código-fonte.

Visualização no Android Studio

Para visualizar e editar o código-fonte no Android Studio:

  1. Execute os seguintes comandos
    make idegen
    development/tools/idegen/idegen.sh
    
  2. Em Android Studio, abra android.ipr .

O código-fonte AE Harness de teste está em test/AfwTestHarness .

Configurando o Chicote de Teste AE

Você pode personalizar o arnês configurando test/AfwTestHarness/afw-test.props . Para operar o chicote com sucesso, conclua as seguintes etapas:

  1. Configurar a rede Wi-Fi em afw-test.props com as seguintes propriedades:
    wifi_ssid
    wifi_password (optional)
    wifi_security_type (optional, available options are: NONE, WEP or WPA)
    
  2. Obtenha pelo menos uma conta de um domínio vinculado ao Test DPC como seu controlador de política de dispositivo. Especificar os detalhes em afw-test.props com as seguintes propriedades:
    work_account_username
    work_account_password
    

    O AE Harness de teste utiliza Teste DPC, para fluxos de teste de aprovisionamento, de modo que as contas devem ligar-se ao teste de DPC para executar o equipamento de teste.

Construindo o Chicote de Testes AE

Inicialize a configuração do build usando:

source build/envsetup.sh
lunch

Selecione um tipo de dispositivo e pressione Enter.

Construir o arnês usando:

make afw-test-harness -j32

Isso cria um diretório ( out/host/linux-x86/afw-th/android-cts ) com todos os binários necessários, arquivos de configuração e ferramentas para executar o equipamento de teste. Este diretório também é compactado em um arquivo ( out/host/linux-x86/afw-th/android-afw-test-harness.zip ) para distribuição.

Executando o arnês de teste AE

Use as seguintes etapas para executar o Chicote de Teste AE:

  1. Em seu ambiente de construção, lançar o corredor de teste usando:
    afw-test-tradefed
    
    Isso inicia o cts-tf console, planos cargas de teste, casos de teste, e afw-test.props de out/host/linux-x86/afw-th/android-cts .
  2. A partir da pasta descompactada de android-afw-test-harness.zip , lançar o corredor de teste usando:
    cts-tf> ./android‐cts/tools/afw-test‐tradefed
    
    Esta cargas planos de teste, casos de teste e afw-test.props de android-cts diretório. Garantir ./android‐cts/repository/testcases/afw-test.props tem a conta de trabalho e configuração Wi-Fi.
  3. Execute um plano de teste. Cada plano de teste é um arquivo XML que contém um conjunto de pacotes de teste do AfwTestHarness/tests diretório do pacote de teste. Planos comuns incluem:
    • afw-userdebug-build . Contém todos os pacotes de teste que requerem uma compilação de depuração do usuário.
    • afw-user-build . É executado em uma construção do usuário, mas requer que o dispositivo de teste seja configurado corretamente, incluindo a conclusão da configuração inicial e a ativação da depuração USB.

    Para executar o plano de teste afw-userdebug-build , use:
    cts-tf> run cts --plan afw-userdebug-build
    
    Para ver todos os planos de teste, use o comando list plans . Para definições plano vista, referem-se out/host/linux-x86/afw-th/android-cts/repository/plans .
  4. Execute um pacote de teste. Para executar um pacote único teste, o uso
    cts-tf> run cts --package com.android.afwtest.NfcProvisioning
    
    Para ver todos os pacotes, use o comando list packages . Para mais opções, use o comando run cts --help .

Depurando o arnês de teste AE

Executar todos os comandos na consola AFW-test-tradefed ( cts-tf ), que você pode lançar executando afw-test-tradefed .

  • Exibir mais informações com o -l INFO ou -l DEBUG bandeiras. Exemplo:
    cts-tf> run cts ‐‐plan afw-userdebug-build -l DEBUG
    
  • Execute o equipamento de teste de um dispositivo específico com o -s bandeira. Exemplo:
    cts-tf> run cts ‐‐plan afw-userdebug-build -l DEBUG -s device_sn
    
  • Execute equipamento de teste em todos os dispositivos conectados com o --all-devices bandeira. Exemplo:
    cts-tf> run cts ‐‐plan afw-userdebug-build -l DEBUG --all-devices
    
  • Ver execuções de funcionamento actuais utilizando list invocations ou li .
  • Ver resumo das execuções de teste últimos usando list results ou lr .
  • Ver outros list comandos usando help list .
  • Monitorar logcat em tempo real com filtro usando afwtest , em seguida, abra outro terminal e começar logcat usando: adb logcat | grep afwtest . Após a conclusão de um teste:
    • Ver registos em out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time . O logcat dispositivo completo e log host ( afw-test-tradefed registros) são salvos em arquivos zip separados.
    • Encontrar a informação relevante através de pesquisa na logcat dispositivo para afwtest. Exemplo: zless out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time /device_logcat_ random-number .zip | grep afwtest
    • Para visualizar a plena log AFW-test-tradefed, use: zless out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time /host_log_ random-number .zip
  • Um pacote de teste automatiza um fluxo de provisionamento corporativo percorrendo as páginas da interface do usuário e gravando um log de navegação no arquivo logcat do dispositivo para cada página. Exemplo: afwtest.AutomationDriver: Navigating:com.android.afwtest.uiautomator.pages.gms.AddAccountPage
    Páginas UI para pacote de teste com.android.afwtest.NfcProvisioning incluem:
    • com.android.afwtest.uiautomator.pages.managedprovisioning.NfcProvisioningPage
    • com.android.afwtest.uiautomator.pages.PageSkipper
    • com.android.afwtest.uiautomator.pages.LandingPage
  • Se um teste falhou durante o processo de provisionamento, logcat contém um erro semelhante a:
    TestRunner: java.lang.RuntimeException: Failed to load page: com.android.afwtest.uiautomator.pages.packageinstaller.DeviceAccessPage
    
    Isso normalmente é causado por erros em uma página UI anterior ou a página que falhou em carga, de modo a tentar encontrar outras mensagens de erro no logcat antes este erro e tente reproduzi-lo manualmente seguindo o fluxo de provisionamento.
  • Se um pacote de teste falhar:
    • Uma captura de tela é salvo em out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time usando a seguinte sintaxe: screenshot-test_ test_class_full_name _ test_case_name - random_number .png . Essas informações também são registradas no log do host.
    • Um relatório de bug é salvo em out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time como: bug- test_class_full_name _ test_case_name - random_number .zip .
  • Depois de todos os pacotes de teste foi executado, uma imagem é tirada e salva em out/host/linux-x86/afw-th/android-cts/repository/logs/ start-time como: screenshot- random_number .png . Essas informações também são registradas no log do host.

Perguntas frequentes

Posso executar o plano de teste afw-userdebug-build em um dispositivo brilhou com configuração de usuário?

Pacotes No. teste no afw-userdebug-build fábrica plano de repor o dispositivo de teste antes de executar o fluxo de teste real e exigem adb depuração para ser habilitado automaticamente. Com uma compilação usuário, adb depuração pode ser ativado apenas por alterar manualmente a configuração em Opções do desenvolvedor.

Posso executar o plano de teste afw-user-build em um dispositivo brilhou com construir userdebug?

Sim, mas recomendamos que você execute este plano de teste em uma construção de usuário.

Às vezes, meu teste falha porque o carregamento da IU leva muito tempo. Como posso consertar isso?

Configure o timeout_size configuração no ./android-cts/repository/testcases/afw-test.props . As configurações válidas são: S, M, L, XL, XXL.

O pacote de teste com.android.afwtest.NfcProvisioning (ou SuwDoProvisioning ) falhar no meu dispositivo, porque os shows de configuração inicial instalados personalizados UI (como Termo & Condições) após provisionamento é completa. Como posso pular esta IU personalizada?

Deve haver UI mínima após o processo de provisionamento. O equipamento de teste irá pular automaticamente essa IU se a IU tiver um botão com texto significativo ou descrição de conteúdo que contenha qualquer uma das seguintes palavras: Pular, Concluir, Concluído, Aceitar, Concordar, Avançar, Continuar ou Continuar. Alternativamente, você pode definir um botão no afw-test.props para configurar o equipamento de teste para ignorar a sua UI. Exemplo:

oem_widgets=your_btn
your_btn.text=your_customized_text
your_btn.package=your_package
your_btn.action=click

Para definir vários widgets, separe-os usando vírgulas.

O pacote de teste com.android.afwtest.NfcProvisioning (ou SuwDoProvisioning ) falhou ea última UI é "Verifique sua conta." Por que isso acontece e como posso recuperar o dispositivo de teste?

Essa falha ocorre porque o pacote de teste anterior falhou em limpar a proteção de redefinição de fábrica no final do teste. Você deve inserir manualmente a conta para desbloquear o dispositivo.

Meu dispositivo precisa de mais tempo para redefinir os padrões de fábrica. Posso estender o tempo limite de redefinição de fábrica?

sim. Configure o factory_reset_timeout_min configuração no afw-test.props . As configurações válidas estão em minutos; você pode definir para qualquer número de minutos que funcione com o seu dispositivo.