A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

Guia Avançado de ATOS

Este é um guia sobre como executar testes do Android Comms Test Suite (ACTS) .

Obtendo o código

A versão mais atualizada do ACTS pode ser encontrada no repositório Gerrit do Android Open Source Project (AOSP) em /platform/tools/test/connectivity/ .

Para obter detalhes sobre como sincronizar o código, consulte Download the Source and the Android Developer Codelab . Ao sincronizar o código, sincronize o branch master. Não sincronize uma compilação marcada.

Observe que ao baixar o ACTS, você não precisa sincronizar todo o repositório Android. Para sincronizar apenas o ACTS, após executar o comando repo init , execute:

repo sync platform/tools/test/connectivity

ACTS pode ser encontrado em <repo>/tools/test/connectivity/acts/ .

Configuração do ambiente

Para garantir que o ACTS tenha as dependências necessárias para configuração, instale as seguintes ferramentas de configuração do Python 3:

sudo apt-get install python3-setuptools
sudo apt-get install python3-pip
sudo apt-get install adb fastboot
sudo pip3 install --upgrade pip setuptools
# Needed due to an on-going bug.
sudo apt-get install protobuf-compiler

Instalando ATOS

O script setup.py encontrado em <repo>/tools/test/connectivity/acts/framework instala o restante das dependências e o próprio ACTS.

Para desenvolvimento contínuo em ou com ACTS, execute o seguinte comando:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -

Se você deseja executar apenas testes, execute este comando:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -

Verificando instalação

Após a configuração, certifique-se de usar act.py em seu terminal e importe módulos ACTS em Python. Por exemplo:

act.py -h
usage: act.py [-h] -c <PATH> [--test_args Arg1 Arg2 ... ]
python3
>>> from acts.controllers import android_device
>>> device_list = android_device.get_all_instances()

Executando sem instalar

Os usuários podem executar o ACTS sem instalar o pacote diretamente. A única etapa que deve ser executada é modificar o caminho do Python para importar de <repo>/tools/test/connectivity/acts/framework . Antes de executar o ACTS, execute setup.py install_deps para instalar todas as dependências exigidas pelo ACTS sem instalar o ACTS. Se uma versão existente do ACTS estiver em sua máquina, execute sudo setup.py uninstall .

Para executar o ACTS, use um dos seguintes comandos:

cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py

O ACTS emite mensagens solicitando os sinalizadores -c e -tc . Para obter mais informações, consulte Configurando testes do ACTS .

Configurando o ACTS em um ambiente virtual

Para isolar sua instalação de outras instalações do ACTS, você deve instalar o ACTS em um ambiente virtual. As etapas a seguir pressupõem que você tenha acts_test.zip do aosp-master em ci.android.com ou tenha acesso direto à fonte.

Obtenha ATOS.
As construções são publicadas. Para obter mais informações, consulte Integração contínua do Android . Você pode extrair arquivos zip de uma compilação em ci.android.com . Procure o destino test_suites_x86_64 .
O arquivo acts_test.zip está na guia Artefatos. Para este exemplo, suponha que acts_test.zip foi baixado para /tmp/acts_test.zip .
Se você tiver acesso ao código-fonte, poderá usá-lo.
Instale virtualenv em sua máquina.
Se você ainda não o tiver, poderá instalar o virtualenv usando:
```
python3 -m pip install -U --user virtualenv
```
Crie e ative o ambiente virtual (em /tmp/my_virtualenv para este exemplo). Isso garante que novos pacotes sejam instalados no diretório virtualenv .
```
python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
```

Instale ATOS. Execute o seguinte comando.

unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install

Se você tiver acesso direto ao código, pode pular a descompactação:

cd /path/to/acts/framework
python3 setup.py install

Execute o ACTS de qualquer lugar.
```
act.py -c <config> ...
```
Saia do ambiente virtual quando terminar de executar os testes.
```
deactivate
```

Piscando o dispositivo Android (opcional)

Se você deseja obter o controle privilegiado do sistema do dispositivo, atualize o dispositivo com uma compilação userdebug .

Para fazer o flash do dispositivo, use a Android Flash Tool (flash.android.com/) . Para obter mais detalhes, consulte a documentação em Android Flash Tool .

Instalando o SL4A (opcional, recomendado)

Se estiver usando um dispositivo com uma compilação userdebug , você tem a opção de obter o controle de privilégios do sistema do seu dispositivo usando SL4A. Se o seu teste não usa SL4A no dispositivo, você pode definir o sinalizador skip_sl4a na configuração do ACTS para desabilitar o recurso.

"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]

Para obter o APK SL4A, siga as instruções em Scripting Layer for Android .