A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Guida all'upgrade di OmniLab Android Test Station 2.0

OmniLab Android Test Station (ATS) è lo strumento principale utilizzato da sviluppatori e ingegneri di test per automatizzare i test dei dispositivi Android. OmniLab ATS fornisce un'interfaccia per gestire i dispositivi, visualizzare i risultati ed eseguire suite di test come Compatibility Test Suite (CTS).

OmniLab ATS 2.0 è una modernizzazione importante del motore della stazione. Abbiamo eseguito la migrazione dell'infrastruttura sottostante a OmniLab, la piattaforma moderna e ad alte prestazioni di Google. Questa modifica consente agli sviluppatori e agli ingegneri di test Android di utilizzare gli stessi strumenti robusti utilizzati da Google.

Ti consigliamo di iniziare a utilizzare OmniLab ATS 2.0. È disponibile tramite un flag di configurazione, che ti consente di usufruire immediatamente di prestazioni e stabilità migliorate.

Vantaggi principali di OmniLab ATS 2.0

Infrastruttura modernizzata: sfrutta la piattaforma OmniLab per migliorare la stabilità e le prestazioni.
Transizione senza interruzioni: non sono state apportate modifiche all'interfaccia utente web o ai flussi di lavoro di esecuzione dei test principali.
Pronto per il futuro: si allinea all'infrastruttura di test unificata di Google, consentendo un'adozione più rapida delle nuove funzionalità.

Nuove funzionalità

Queste funzionalità semplificano le operazioni di test:

Aggiornamento in blocco dei piani di test: puoi configurare più piani di test contemporaneamente filtrandoli con le etichette. In questo modo puoi aggiornare pianificazioni personalizzate, azioni di esecuzione dei test e risorse in decine di piani in un unico passaggio, riducendo il tempo di configurazione manuale.
Supporto migliorato per il deployment multi-host e cloud: ATS 2.0 ottimizza la pianificazione dei test, il trasferimento dei file e la memorizzazione nella cache dei file per rendere il sistema robusto, efficiente e flessibile in più modalità di deployment.
Orchestrazione cloud: ATS 2.0 supporta l'orchestrazione cloud per eseguire il provisioning, la scalabilità e la gestione dinamici dei dispositivi virtuali Cuttlefish durante le esecuzioni dei test.

Confronto delle funzionalità: ATS 1.0 e ATS 2.0

Capacità	ATS 1.0	ATS 2.0
Motore sottostante	Tradefed e cluster Tradefed	Piattaforma OmniLab, la piattaforma di dispositivi standard di Google
UI	UI MTT	UI MTT
Scala	Locale e multi-host	Locale e multi-host; ottimizzato per il deployment multi-host
Nuovi tentativi	Regole di nuovi tentativi di base	Nuovi tentativi personalizzabili, pianificazione avanzata dei nuovi tentativi
Supporto dei dispositivi virtuali	Supporto per le farm di dispositivi locali e cloud	Supporto per le farm di dispositivi locali e cloud
Elaborazione dei risultati	Basata su Tradefed	Basata su OmniLab ATS (condivisa con la console CTS)
API	Supportato	Supportato

Modifiche all'esperienza utente

Sebbene la maggior parte delle modifiche sia interna, tieni presente i seguenti aggiornamenti comportamentali:

Suite di test protette da password (ad esempio Security Test Suite (STS)): in ATS 1.0, le suite protette da password venivano estratte utilizzando gli setup_scripts di Trade Federation (ad esempio eseguendo unzip -P ...).

In OmniLab ATS 2.0, il server gestisce in modo nativo la decompressione del pacchetto di test prima di avviare Tradefed. Per le suite protette da password:
- Rimuovi il comando unzip -P ... manuale da Setup Scripts. Se mantieni lo script di decompressione, si verifica un errore di chiamata.
- Inserisci la password di decriptaggio del pacchetto di test direttamente nel campo Password in Test Resource Defs.
Figura 1. Adattamento della configurazione dei test STS in ATS 2.0.
Directory dei risultati: la struttura della directory di output sul disco per i risultati dei test è stata aggiornata a causa della modifica dell'infrastruttura. Tuttavia, puoi comunque accedere a questi file tramite la dashboard Test Run.

Figura 2. Visualizza l'elenco dei file di output.
Log di test: la struttura dei log di test è stata modificata. Puoi visualizzare tre origini di log da una chiamata: log generati dai test xTS di Tradefed (anche in ATS 1.0), log del server OmniLab per lo stato del dispositivo e dei test e log dei test Mobly per i moduli Mobly V2.

Figura 3. Origini dei log di ATS 2.0: Tradefed xTS, server OmniLab e log dei test Mobly.

Se esegui CTS con l'opzione di download dinamico attivata, OmniLab ATS attiva automaticamente i test MCTS oltre ai test CTS e i log MCTS sono disponibili anche nella sezione dei log di Tradefed.

Figura 4. Test MCTS attivato dal download dinamico di XTS.

Figura 5. Log MCTS nella sezione dei log di Tradefed, oltre ai log CTS.

Procedura di upgrade

L'upgrade è un cambio di software basato su flag, quindi non sono necessari modifiche all'hardware o reinstallazioni.

Per attivare il nuovo OmniLab ATS 2.0:

Arresta l'istanza corrente:
```
mtt stop
```
Avvia OmniLab ATS con il flag force_ats_version 2:
```
mtt start --force_ats_version 2
```
Se non utilizzi la versione della build più recente, aggiungi --force_update per recuperarla:
```
mtt start --force_ats_version 2 --force_update
```
(Facoltativo) Se riscontri problemi con ATS 2.0, puoi ripristinare temporaneamente ATS 1.0 rimuovendo --force_ats_version 2 o utilizzando esplicitamente --force_ats_version 1:
```
mtt start --force_ats_version 1
```

Tempistiche della transizione

Nel 2026, OmniLab ATS 1.0 verrà ritirato gradualmente. Pianifica la migrazione di conseguenza:

Primo trimestre 2026: ATS 2.0 è disponibile per tutti gli sviluppatori e i partner come opzione.
Secondo trimestre 2026: ATS 2.0 diventa l'impostazione predefinita per un numero crescente di sviluppatori e partner.
Terzo trimestre 2026: ATS 2.0 diventa la versione standard per tutti gli sviluppatori e i partner.
Quarto trimestre 2026: la versione legacy di ATS 1.0 viene ritirata e rimossa dalle build di produzione.

Assistenza

Se riscontri problemi durante l'upgrade, utilizza queste risorse:

Assistenza per l'utilizzo: visita Stazione di test Android OmniLab per guide alla configurazione e alla risoluzione dei problemi.
Segnala problemi: consulta Segnalazioni di bug.