Android Test Station è uno strumento di test che gli sviluppatori e gli ingegneri di test Android possono utilizzare per utilizzare un'interfaccia utente per l'esecuzione di suite di test Android standard, come Android Compatibility Test Suite (CTS) . Questo strumento funge da interfaccia web per Trade Federation (TF) , consentendo di eseguire facilmente CTS su una serie di dispositivi di test con una configurazione minima, nonché di stabilire un programma per l'esecuzione continua dei test.
Configura la stazione di test Android
Questa sezione spiega come installare e configurare Android Test Station.
Android Test Station utilizza il codice sorgente di queste posizioni:
- Codice sorgente della stazione di test Android
- Codice sorgente di TradeFed Cluster
Installa la stazione di test Android
Segui tutti i requisiti hardware e software per le suite di test che esegui.
I requisiti per CTS si trovano su source.android.com .
Non sono previsti requisiti hardware aggiuntivi per ATS, ma consigliamo di utilizzare i requisiti host CTS come punto di partenza.
Esistono due modi per installare Android Test Station:
- Eseguire il programma di installazione .
- Installalo manualmente , il che richiede l'installazione di più programmi e risorse.
Installare con il programma di installazione
Su Ubuntu 20.04+, il programma di installazione installa e configura tutti i programmi e le risorse necessarie per eseguire Android Test Station.
Per utilizzare il programma di installazione:
Esegui il programma di installazione:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
Esegui
mtt version
per verificare la versione installata della CLI di Android Test Station.
Installa manualmente
Installa Docker
Segui le istruzioni per installare Docker Community Edition (CE) sulla tua macchina Linux.
Segui i passaggi post-installazione per gestire Docker come utente non root .
Potrebbe essere necessario riavviare la finestra del terminale o disconnettersi e accedere nuovamente affinché le modifiche alle autorizzazioni abbiano effetto.
Installa Python 3
La CLI di Android Test Station viene verificata rispetto alle versioni di Python dalla 3.7 alla 3.10.
Per Ubuntu 16.04 o versioni precedenti, aggiungi prima il repository per Python 3 effettuando una delle seguenti operazioni:
Esegui questo comando:
sudo add-apt-repository ppa:deadsnakes/ppa
Costruisci e installa il repository dal sorgente .
Per installare Python 3, esegui questi comandi:
sudo apt-get update
sudo apt install python3 python3-distutils
Per installare una versione specifica di Python 3 (ad esempio, 3.10), esegui invece questi comandi:
sudo apt-get update
sudo apt install python3.10 python3.10-distutils
Ottieni la CLI di Android Test Station
Scarica il pacchetto dell'interfaccia a riga di comando (CLI) qui.
Avvia la stazione di test Android
Avvia Android Test Station con il seguente comando:
mtt start
La prima volta che viene avviata l'interfaccia utente, potrebbero essere necessari alcuni minuti per visualizzarla. La CLI visualizza un URL Web per accedere all'interfaccia utente in un browser. Per impostazione predefinita, l'URL Web è localhost:8000
. Se necessario, puoi modificare la porta predefinita all'avvio con il flag --port
.
Se è disponibile una versione più recente, è possibile aggiornare alla versione corrente. È possibile controllare le note di rilascio per le versioni più recenti.
Per aggiornare alla versione corrente, eseguire:
mtt start --force_update
Per interrompere l'app, esegui:
mtt stop
Per visualizzare un elenco di altri comandi, utilizzare:
mtt --help
Eseguire il backup e ripristinare il database
Per eseguire il backup del database ATS, arresta l'app ed esegui il comando seguente, che esegue il backup del database corrente in un file TAR denominato mtt-backup.tar
nella tua directory home:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."
Per ripristinare, esegui il comando seguente prima di avviare l'app:
docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"
Configurazione guidata
Dopo aver installato ed eseguito Android Test Station per la prima volta, la configurazione guidata ti guida attraverso alcuni passaggi per aiutarti a personalizzare lo strumento per il tuo ambiente. Qualsiasi modifica apportata qui può essere riconfigurata in seguito tramite la pagina Impostazioni.
Ripristinare un backup della configurazione
Se disponi di un backup di un file di configurazione da un altro host Android Test Station, puoi caricare il file per copiare eventuali configurazioni modificate da quell'host facendo clic sul pulsante Carica file .
Figura 1. Ripristino di un backup della configurazione.
Imposta l'account di servizio predefinito
Puoi impostare un account di servizio che Android Test Station utilizza per impostazione predefinita quando accedi alle tue risorse (ad esempio, Google Cloud Storage, Google Drive). Per autenticare il tuo account di servizio, fai clic su Carica chiave account di servizio e seleziona il file della chiave JSON del tuo account di servizio.
Figura 2. Impostazione dell'account di servizio.
Una volta autenticato l'account di servizio, l'indirizzo e-mail dell'account viene visualizzato nell'angolo in alto a destra della pagina. Per modificare l'account di servizio, fai clic sul nome dell'account, rimuovi l'account predefinito corrente e carica una nuova chiave dell'account di servizio.
Figura 3. Modifica dell'account del servizio.
Importa set di configurazione
Un set di configurazione è un insieme di configurazioni per l'esecuzione di suite di test, incluse le azioni del dispositivo correlate e i canali di creazione. I set di configurazione sono ospitati in uno specifico bucket Google Cloud Storage (GCS). Dopo aver autenticato il canale di build GCS con il tuo account Google, vedrai un elenco di tutti i set di configurazione disponibili.
Seleziona i set di configurazione che desideri aggiungere al tuo host Test Station e fai clic su Importa selezionati .
Figura 4. Importazione di un set di configurazione.
Includi le impostazioni Wi-Fi
Alcuni test CTS richiedono che il tuo dispositivo si connetta a un hotspot Wi-Fi. Per selezionare la tua rete Wi-Fi, inserisci l' SSID WiFi e il PSK WiFi opzionale.
Figura 5. Impostazioni dell'hotspot Wi-Fi.
Dopo aver completato l'installazione guidata, la pagina si ricarica con le nuove impostazioni applicate.
Connetti un dispositivo
Il debug USB deve essere abilitato per utilizzare un dispositivo per il test. Per abilitare il debug:
Segui le istruzioni in Abilitare le opzioni sviluppatore e il debug .
Se prevedi di utilizzare build Android di prova precaricate con chiavi ADB personalizzate, inserisci i file
.adb_key
personalizzati nella directory~/.android/
.I file vengono caricati automaticamente e passati ad ADB per abilitare automaticamente il debug USB dopo aver eseguito il flashing del dispositivo per i dispositivi che eseguono tali build.
Collega il dispositivo al computer host tramite USB.
Il dispositivo viene visualizzato nella scheda Dispositivi Android Test Station entro un minuto dall'aggiornamento dell'interfaccia web. In questa scheda è inoltre possibile visualizzare lo stato dei dispositivi.
Figura 6. Collegamento di un dispositivo.
I diversi stati del dispositivo sono:
- Disponibile : il dispositivo è connesso e pronto per eseguire un test.
- Assegnato : il dispositivo è connesso e sta attualmente eseguendo un test. Ciascun dispositivo può eseguire un solo test alla volta, quindi il dispositivo deve completare il test corrente prima di eseguirne uno nuovo.
Esegui un test
Seleziona una prova
Android Test Station viene fornito con una serie di configurazioni CTS preconfezionate. Per eseguire uno di questi test, vai alla scheda Test Suite e fai clic su Esegui test per il test desiderato.
Figura 7. Selezione di un test.
Per modificare o aggiungere nuovi test, vedere Aggiunta di test .
Configura l'esecuzione del test
Modifica i parametri da utilizzare per questa specifica esecuzione del test. La maggior parte dei parametri sono precompilati con valori definiti nella configurazione di test selezionata.
Questo passaggio può essere completato utilizzando i valori predefiniti, ma è possibile modificare qualsiasi parametro, come Max Retry e Command , in base alle proprie esigenze.
Figura 8. Configurazione di un'esecuzione di prova.
I parametri di esecuzione del test sono:
- Nome : nome della suite di test che desideri eseguire.
- Conteggio esecuzioni : numero di volte in cui l'esecuzione del test deve essere eseguita quando pianificato. Le esecuzioni di test vengono pianificate utilizzando Trade Federation , che esegue fino a 20 esecuzioni di test in parallelo se c'è la capacità di farlo.
- Numero massimo di tentativi : numero massimo di tentativi per eseguire un test se almeno un test fallisce. Solitamente è impostato su 4-6 tentativi per un'esecuzione completa di CTS per gestire test instabili.
- Timeout coda : se un'esecuzione di test rimane nello stato In coda per troppo tempo, viene automaticamente annullata. Specifica qui il tempo di attesa prima della cancellazione. Il valore predefinito è 24 ore.
Comando : il comando per eseguire la suite di test. Qui puoi inserire ulteriori argomenti della riga di comando. Ad esempio, esegui un modulo specifico in CTS 8.1 con:
cts-suite -m ShortModuleName
Comando Riprova : il comando per riprovare una suite di test. Puoi aggiungere ulteriori argomenti della riga di comando qui. Ad esempio, per riprovare solo un modulo specifico in CTS 8.1, utilizzare:
cts --retry 0 -m ShortModuleName
Gli argomenti del nuovo tentativo potrebbero differire da quelli disponibili con il comando iniziale, quindi controlla i parametri supportati sul sito ufficiale per la suite di test selezionata.
Esecuzione di test precedente : se desideri eseguire nuovamente un'esecuzione di test precedente:
Locale: se l'esecuzione è stata avviata sull'host corrente, immettere l'ID dell'esecuzione del test visualizzato quando si visualizzano i dettagli dell'esecuzione del test.
Figura 9. Esecuzione di test precedente locale.
Remoto: se l'esecuzione è stata avviata su un host diverso, caricare il file dei risultati del test selezionando Remoto , facendo clic su Carica file dei risultati del test e selezionando un file dall'archivio locale.
Figura 10. Esecuzione di test precedente remota.
Seleziona i dispositivi
Fare clic sulle caselle di controllo per selezionare i dispositivi da allocare per l'esecuzione della suite di test. Il conteggio degli shard dovrebbe cambiare automaticamente per corrispondere al numero di dispositivi selezionati.
Figura 11. Selezione dei dispositivi.
Per selezionare i dispositivi in base ad attributi diversi dai numeri di serie del dispositivo, è possibile inserire manualmente "Specifiche del dispositivo". Ad esempio, per selezionare 3 dispositivi il cui nome prodotto è "bramble", inserisci quanto segue:
product:bramble;product:bramble;product:bramble
Gli attributi supportati sono:
- build_id
- dispositivo_seriale
- tipo di dispositivo
- Nome host
- Prodotto
- variante_prodotto
- sim_state
Tutti i dispositivi selezionati devono essere nello stato Disponibile per eseguire l'esecuzione del test e passano tutti allo stato Allocato quando viene eseguita l'esecuzione del test. Un'esecuzione di test è nello stato In coda mentre attende che i dispositivi diventino disponibili.
Aggiungi azioni del dispositivo
Le azioni del dispositivo sono script che possono essere eseguiti prima di ogni esecuzione del test. Alcune azioni del dispositivo sono già configurate, come il flashing e il riavvio. Per creare nuove azioni del dispositivo, consulta Creare una nuova azione del dispositivo .
Figura 12. Azioni del dispositivo.
Per aggiungere un'azione del dispositivo a un'esecuzione di prova, fare clic su Aggiungi nuova azione , selezionare le caselle di controllo relative alle azioni da aggiungere e fare clic su Aggiungi azione/i . Le azioni del dispositivo vengono eseguite in sequenza. Puoi riordinare le azioni trascinandole.
Figura 13. Azioni di riordino.
Imposta le risorse di prova
Le risorse di test sono file necessari per eseguire un'esecuzione di test. Ad esempio, l'esecuzione di CTS richiede un file android-cts*.zip
e il flashing di un dispositivo richiede la fornitura dell'immagine di build.
L'URL di download per il file zip della suite di test dovrebbe corrispondere per impostazione predefinita ai collegamenti di Google Drive forniti ai partner. È possibile selezionare un file diverso facendo clic su Sfoglia . Nella finestra popup è possibile inserire un collegamento per il download del file, utilizzare un file da un canale di build autenticato o caricare un file da utilizzare dall'archivio locale.
Figura 14. Risorse di test.
Di seguito è riportata la finestra popup per la selezione di una risorsa di test tramite un URL web. Puoi semplicemente inserire il collegamento dell'URL di download e fare clic sul pulsante Seleziona per confermare la selezione.
Figura 15. Selettore risorsa di prova: URL Web.
Se hai caricato risorse su Google Grive, Google Cloud Storage (GCS) o altri canali, puoi anche accedere alla scheda del canale specifico e selezionare le risorse lì. Ecco un esempio per selezionare una risorsa da Google Drive.
Figura 16. Selettore risorsa di prova - Google Drive.
Oltre alla semplice selezione dei file, sono supportati anche i caratteri jolly nel campo Nome file . La documentazione può essere trovata qui .
Figura 17. Selettore risorsa test: supporto del modello di caratteri jolly.
È inoltre possibile selezionare un file dall'archivio file locale di Android Test Station. È possibile caricare file in questo spazio di archiviazione o utilizzare direttamente file e directory locali .
Figura 18. Selettore risorsa di test: archivio file locale.
Aggiungi configurazioni di ripetizione
È possibile pianificare le ripetizioni che iniziano dopo il completamento dell'esecuzione primaria e caricarne i risultati, ma è possibile utilizzare dispositivi, azioni o risorse diversi.
Figura 19. Aggiunta delle configurazioni di riesecuzione.
Avvia una corsa di prova
Dopo aver immesso le informazioni necessarie per l'esecuzione del test, fare clic su Avvia esecuzione test . Se tutte le informazioni sono valide, viene avviata l'esecuzione del test e verrai reindirizzato a una pagina per visualizzare i dettagli e l'avanzamento dell'esecuzione del test.
Figura 20. Avvio di un'esecuzione di prova.
Crea un piano di prova
I piani di test vengono utilizzati per creare esecuzioni di test in base a una pianificazione periodica. Ad esempio, eseguendo CTS 9.0 ogni giorno alle 17:00. Per creare un nuovo piano di test, fare clic su Crea un nuovo piano di test .
Figura 21. Creazione di un piano di test.
Configura il piano di test
Inserisci il nome del piano di test e le eventuali etichette che desideri aggiungere. Quindi seleziona una pianificazione da utilizzare.
- Manuale : il piano di test crea esecuzioni di test solo quando un utente fa clic su Esegui piano di test nella pagina di elenco dei piani di test.
- Periodico : il piano di test pianifica automaticamente le esecuzioni dei test in base alla pianificazione periodica selezionata. Ad esempio, pianificando un'esecuzione di test ogni giorno alle 17:00.
- Personalizzato : il piano di test pianifica automaticamente le esecuzioni dei test in base all'espressione cron immessa. Ad esempio, per pianificare l'esecuzione di un test ogni giorno alle 17:00, l'espressione cron è
0 17 * * *
.
Figura 22. Configurazione di un piano di test.
Aggiungi suite di test
Aggiungi le suite di test che desideri vengano pianificate dal piano di test facendo clic su + Aggiungi configurazione esecuzione test . Seleziona una suite di test dal menu a discesa Nome e fai clic su Passaggio successivo . Seleziona quindi i dispositivi su cui desideri eseguire il test e fai clic su Aggiungi configurazione . È possibile aggiungere più configurazioni per ciascun piano di test.
Figura 23. Configurazione di un'esecuzione di prova.
Aggiungi azioni del dispositivo
Aggiungi le azioni del dispositivo che desideri vengano eseguite prima di ogni esecuzione del test. Per ulteriori dettagli vedere Aggiunta di azioni del dispositivo .
Figura 24. Aggiunta di azioni del dispositivo.
Imposta le risorse di prova
Aggiungere risorse di test ai piani di test equivale ad aggiungerle alle singole esecuzioni di test. Vedi Impostazione delle risorse di test per maggiori dettagli.
Figura 25. Impostazione delle risorse di test.
Visualizza le esecuzioni dei test
Elenco delle prove eseguite
Visualizza l'elenco delle esecuzioni di test pianificate nella pagina Esecuzioni di test. Fare clic su Visualizza per visualizzare ulteriori dettagli sull'esecuzione di un test.
Puoi anche filtrare l'elenco inserendo una stringa nella barra dei filtri e premendo il tasto Invio . Puoi utilizzare più filtri separandoli con una virgola. Il filtro restituisce tutte le righe che contengono il testo esatto (nessuna corrispondenza di sottostringa) in qualsiasi colonna, esclusi Status e Created .
Un filtro vuoto restituisce tutte le righe. Al momento non è possibile filtrare le righe con valori vuoti.
Figura 26. Elenco delle esecuzioni dei test.
Dettagli dell'esecuzione del test
Qui è possibile visualizzare i dettagli dell'esecuzione di un test, ad esempio lo stato, i registri e i risultati.
Figura 27. Dettagli dell'esecuzione del test.
Stato dell'esecuzione del test
L'avanzamento dell'esecuzione del test viene visualizzato nella sezione Stato. Se è presente un messaggio correlato, ad esempio l'avanzamento del download, il motivo dell'annullamento o un messaggio di errore, viene visualizzato anche qui.
Figura 28. Stato dell'esecuzione del test.
Gli stati di esecuzione del test sono:
- In sospeso : è in corso il download delle risorse richieste.
- In coda : il test è pronto per essere eseguito quando un dispositivo diventa disponibile.
- In esecuzione : il test è in esecuzione su un dispositivo allocato.
- Completato : il test è stato completato e sono stati riportati i risultati.
- Annullato : il test è stato annullato dall'utente o è scaduto il timeout durante il tentativo di trovare dispositivi disponibili.
- Errore : si è verificato un errore che ha impedito l'esecuzione del test.
Annullare un'esecuzione di prova
Se l'esecuzione del test non è stata completata, è possibile annullarla facendo clic su Annulla e quindi su Sì nella finestra di dialogo di conferma. Le esecuzioni di test vengono inoltre annullate automaticamente se rimangono nello stato In coda per un periodo superiore a quello specificato nel campo tail_timeout_seconds . L'annullamento di un'esecuzione di prova mentre si è in stato In esecuzione potrebbe richiedere alcuni minuti per avere effetto.
Figura 29. Annullamento di un'esecuzione di prova.
Risultati della prova
Al termine dell'esecuzione di un test, i risultati vengono raccolti e visualizzati. È possibile visualizzare ulteriori dettagli facendo clic sulla freccia per ciascuna esecuzione. Fare clic su Visualizza file di output per visualizzare gli elementi di test raccolti, ad esempio test_result.xml
e test_result_failures.html
.
Figura 30. Risultati dell'esecuzione del test.
Puoi visualizzare i log dell'host live e di Tradefed nella scheda Log.
Figura 31. Scheda Registri.
I risultati dei singoli moduli si trovano nella scheda Risultati del test.
Figura 32. Scheda Risultati del test.
È possibile scaricare i file utilizzati come risorse di test facendo clic su Apri nella scheda Risorse di test.
Figura 33. Scheda Risorse di test.
Per visualizzare i dettagli dell'esecuzione del test, come create_time , vai alla scheda Config.
Figura 34. Scheda Configurazione.
Funzionalità avanzate
Gestisci i file di configurazione
Android Test Station utilizza file di configurazione scritti in YAML per caricare opzioni predefinite come test, canali di creazione e azioni del dispositivo. Di seguito è mostrato un file di configurazione di esempio per alcune opzioni.
// example_file.yaml
tests:
- id : android.cts.9_0.arm
name: CTS 9.0 (ARM)
test_resource_defs:
- name: android-cts.zip
default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
test_resource_type: TEST_PACKAGE
command: cts
env_vars:
- name: TF_PATH
value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
- name: LD_LIBRARY_PATH
value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
setup_scripts:
output_file_patterns:
- android-cts/logs/latest/.*
- android-cts/results/latest/.*\.html
- android-cts/results/latest/compatibility_result\..*
- android-cts/results/latest/logo.png
- android-cts/results/latest/test_result.xml
result_file: test_result.xml
java_properties:
- name: CTS_ROOT
value: ${TF_WORK_DIR}
context_file_dir: android-cts/results/
context_file_pattern: '[\d_\.]+\.zip'
retry_command_line: retry --retry 0
runner_sharding_args: --shard-count ${TF_SHARD_COUNT}
build_channels:
- id: google_drive
name: Google Drive
provider_name: Google Drive
device_actions:
- id: flash
name: Flash
test_resource_defs:
- name: bootloader.img
test_resource_type: DEVICE_IMAGE
- name: radio.img
test_resource_type: DEVICE_IMAGE
- name: img.zip
test_resource_type: DEVICE_IMAGE
tradefed_target_preparers:
- class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
option_values:
- name: work-dir
values:
- ${TF_WORK_DIR}
- name: host-setup-command
values:
- adb -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL flash bootloader bootloader.img
- fastboot -s $SERIAL flash radio radio.img
- fastboot -s $SERIAL reboot-bootloader
- fastboot -s $SERIAL -w update img.zip
- adb -s $SERIAL wait-for-device
- name: host-cmd-timeout
values:
- 10m
Quando configuri la tua istanza Android Test Station, puoi condividere la configurazione con altri utenti esportandola come file. Per fare ciò, vai alla pagina Impostazioni e fai clic su Esporta in alto a destra.
Figura 35. Gestione dei file di configurazione.
Dopo aver scaricato il file di configurazione, condividi il file con altri utenti. Possono aggiungere il file di configurazione alla propria istanza di Android Test Station facendo clic su Importa e selezionando il file di configurazione.
Crea una nuova azione del dispositivo
Le azioni del dispositivo vengono utilizzate per automatizzare il processo di configurazione del dispositivo. Le azioni sono script eseguiti su ciascun dispositivo su cui è in esecuzione il test prima di ogni esecuzione del test, anche prima dei nuovi tentativi. Per visualizzare un elenco delle azioni del dispositivo disponibili, vai alla pagina Impostazioni e fai clic sulla scheda Azioni del dispositivo. Diverse azioni del dispositivo sono già configurate, come il riavvio e il flashing.
Figura 36. Scheda Azioni dispositivo.
Aggiungi una nuova azione del dispositivo
Fare clic su Azione Nuovo dispositivo .
Figura 37. Pulsante di azione del nuovo dispositivo.
Inserisci un nome e una descrizione.
Figura 38. Nome dell'azione del dispositivo.
Fare clic su Aggiungi preparatore di destinazione .
Immettere il nome completo della classe Trade Federation Target Preparer, ad esempio
com.android.tradefed.targetprep.RunHostCommandTargetPreparer
.Figura 39. Aggiunta di un preparatore di target.
Un elenco dei preparatori di target disponibili è disponibile nel riferimento com.android.tradefed.targetprep .
Figura 40. Elenco Preparatore di destinazione.
Aggiungi eventuali opzioni da utilizzare con il preparatore di destinazione. Per visualizzare le opzioni disponibili, controlla targetprep per il codice sorgente per ciascun preparatore di destinazione in AOSP:
Figura 41. Esempio di opzione di azione.
Per aggiungere un'opzione, fare clic su Aggiungi opzione Preparatore target e immettere i valori richiesti.
Figura 42. Esempio di comando di azione.
Definire le risorse di test necessarie per eseguire l'azione del dispositivo, ad esempio creare immagini per il flashing. Per aggiungere una definizione di risorsa, fare clic su Aggiungi risorsa di test e compilare i campi richiesti. Se sai dove si trovano i tuoi file, puoi fornire un URL di download predefinito facendo clic su Sfoglia . Se i preparatori della destinazione accettano la directory come risorsa di test, seleziona Decompress . Specificare quindi la relativa directory di Destinazione sotto la directory di lavoro temporanea ed i Nomi dei File da decomprimere. Se non viene fornito alcun nome di file, tutti i file verranno decompressi dalla risorsa di test.
Figura 43. Risorse per il test delle azioni.
Fare clic su Aggiorna .
Figura 44. Azione salva modifiche.
Gestire i test
Modifica un test
Per modificare un test salvato, vai alla pagina Test e clicca su Modifica sulla riga del test che desideri modificare. Dopo aver modificato la configurazione del test, fare clic su Aggiorna .
Figura 45. Modifica di un test.
Aggiungi un nuovo test
Per aggiungere un nuovo test, vai alla pagina Test e fai clic su Crea un nuovo test . Immettere le informazioni appropriate e fare clic su Crea .
Figura 46. Creazione di un test.
Figura 47. Copia di un test.
Esporta configurazioni host
Dopo aver configurato un host, puoi esportare le configurazioni dell'host in un file. Puoi caricare questo file su altri host per copiare le configurazioni salvate.
Per esportare le configurazioni di un host, vai alla pagina Impostazioni e fai clic su Esporta nell'angolo in alto a destra.
Figura 48. Esportazione di una configurazione host.
Per importare un file di configurazione host, vai alla pagina Impostazioni e fai clic su Importa nell'angolo in alto a destra.
Figura 49. Importazione di una configurazione host.
Utilizza file e directory locali
A partire dalla versione R11, i file nella directory $HOME/.ats_storage
sono automaticamente accessibili in Android Test Station. Copia o sposta un file in quella directory, quindi puoi selezionarlo dalla scheda File locale quando pianifichi un'esecuzione di prova.
cp /path/to/file $HOME/.ats_storage
Figura 50. Selezione di un file dalla directory $HOME/.ats_storage
.
È possibile montare directory aggiuntive nell'archivio file locale con il flag --mount_local_path
.
mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2
Figura 51. Directory aggiuntive montate nell'archivio file locale.
Abilita la modalità multi-host
Con la modalità multi-host, gli utenti possono utilizzare un singolo host controller ATS per gestire i dispositivi e i test su più host di lavoro ATS.
Figura 52. Architettura in modalità multi-host.
Per avviare il controller ATS, utilizzare il seguente comando:
mtt start --operation_mode=ON_PREMISE
Verifica che il controller sia accessibile all'indirizzo
http://${CONTROLLER_HOSTNAME}:8000
.Per avviare i lavoratori, utilizzare il seguente comando:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
Se la tua rete non consente agli host di comunicare tra loro, devi seguire le istruzioni di configurazione più avanzate riportate di seguito su ATS Worker.
Connetti i due host utilizzando i tunnel SSH. Selezionare le porte per le porte primarie e del file server, ad esempio 9000 e 9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
Configura e avvia ATS.
DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \ --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \ --operation_mode=ON_PREMISE
Pulitore di file
Il pulitore file è un lavoro cron che viene eseguito ogni ora per pulire i file in base alle configurazioni definite dall'utente. ATS dispone di due configurazioni predefinite per archiviare i risultati dell'esecuzione dei test ed eliminare i file temporanei. Questa guida spiega come personalizzare le policy e le configurazioni per gestire i tuoi file in modo efficace.
Politiche
Una policy definisce l'operazione da eseguire su file o directory e i criteri per selezionare le destinazioni. Le operazioni disponibili sono mostrate nella tabella:
Tipo di operazione | Parametri |
---|---|
ARCHIVE | remove_file : se true , rimuove il file dopo l'archiviazione. |
DELETE |
I criteri si basano sugli attributi del file e sulle informazioni di sistema. I criteri disponibili sono mostrati nella tabella:
Tipo di criterio | Descrizione | Parametri |
---|---|---|
LAST_MODIFIED_TIME | Filtra i file in base alla data e all'ora dell'ultima modifica. | ttl : sono supportati vari tipi di espressioni temporali, ad esempio 10m , 2h , 7 days , 4w . Vedi pytimeparse per i formati supportati. |
LAST_ACCESS_TIME | Filtra i file in base alla data e all'ora dell'ultimo accesso. | Lo stesso di LAST_MODIFIED_TIME . |
NAME_MATCH | Filtra i file in base al nome utilizzando l'espressione regolare. | pattern : espressione regolare, ad esempio [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip per trovare la corrispondenza risultato zip. |
SYSTEM_AVAILABLE_SPACE | Attiva azioni in base allo spazio disponibile sul sistema. | threshold : attiva l'azione quando lo spazio disponibile scende al di sotto della soglia, ad esempio 200 (B), 200KB , 200MB , 200GB , 2TB . |
Figura 53. Aggiunta di una nuova policy di pulizia file.
Configurazioni
Una configurazione combina una o più policy con directory specifiche. I file e le directory all'interno delle directory specificate vengono elaborati in base alle policy definite. Le policy vengono applicate nell'ordine in cui appaiono nella configurazione.
Tutte le directory di destinazione devono trovarsi nella directory /data
. Se la configurazione specifica la directory di destinazione come logs
, viene interpretata come /data/logs
.
Figura 54. Modifica la configurazione del pulitore file.
Ripristina
Facendo clic su Ripristina impostazioni si ripristina lo stato predefinito della configurazione del pulitore file. Questa azione cancella TUTTI gli elementi personalizzati.
Figura 55. Ripristina le impostazioni di pulizia file.
Supporto
Segnalazioni di bug
Il tuo contributo ad Android Test Station aiuta a migliorare lo sviluppo dello strumento e noi vogliamo il tuo contributo! Consulta le note sulla versione di ATS per i dettagli sull'ultima versione. Per segnalare bug o offrire suggerimenti, invia una segnalazione di bug . I partner devono segnalare bug o suggerimenti tramite i canali dei partner.