Scrivere un test senza dispositivo lato host in TF

Questa pagina spiega come scrivere un test lato host che non richiede un dispositivo, ad esempio un test eseguito su un'istanza GCE Linux. Per informazioni dettagliate su come scrivere un test basato sull'host che richiede un dispositivo, consulta Scrivere un test basato sull'host in Trade Federation.

Tipi di test lato host

Puoi eseguire diversi tipi di test lato host tramite Trade Federation (TF).

Test nativi (gtest)

Crea test nativi (gtest) per testare una piattaforma. Se il test non richiede un dispositivo, eseguilo su un host; in questo modo, il test verrà eseguito molto più velocemente. Per configurare questi test in modo che vengano eseguiti su un host di test, utilizza il runner TF HostGTest.

Questa è una configurazione di test TradeFed di esempio:

<configuration description="Runs hello_world_test.">
    <option name="null-device" value="true" />
    <test class="com.android.tradefed.testtype.HostGTest" >
        <option name="module-name" value="hello_world_test" />
    </test>
</configuration>

La configurazione di test esegue un test gtest (hello_world_test) su un host. La configurazione di test di esempio può essere generata automaticamente. A meno che il test non richieda una configurazione o una pulizia speciale, puoi fare affidamento sulla generazione automatica della configurazione di test per creare configurazioni di test TF adeguate.

Per configurare un gtest lato host e attivare la generazione automatica della configurazione del test, impostahost_supported su true inAndroid.bp, come in hello_world_test.

Per ulteriori informazioni sulla scrittura di un test nativo, consulta Esempio di aggiunta di un nuovo test nativo.

Test degli host JAR

I test host JAR (Java), come JUnit, sono test che non devono essere eseguiti su un dispositivo e che forniscono la copertura del codice del progetto Java. Questi test possono essere configurati per essere eseguiti su un host di test utilizzando il runner HostTest.

Configurazione di test di TradeFed di esempio

<configuration description="Executes HelloWorldHostTest">
    <test class="com.android.tradefed.testtype.HostTest" >
        <option name="jar" value="HelloWorldHostTest.jar" />
    </test>
</configuration>

La configurazione del test esegue un test JUnit lato host di HelloWorldHostTest. Tieni presente che la configurazione di test riportata sopra può essere generata automaticamente. A meno che il test non richieda una configurazione o una pulizia speciale, affidati alla generazione automatica della configurazione di test per creare una configurazione di test TradeFed corretta.

Per ulteriori dettagli su come scrivere un test host JAR, consulta la pagina Test host JAR (Java).

Test di host Java isolati

I test Java senza dispositivo possono essere eseguiti in un ambiente di isolamento con un lieve costo in termini di prestazioni. Tuttavia, prima di scegliere di utilizzare questo ambiente, è necessario fare alcune considerazioni importanti.

  • Questo è il runner predefinito utilizzato per i test di unità Robolectric e JUnit
  • Tradefed supporta solo i test JUnit nell'ambiente di isolamento.
  • Sono supportate solo le dipendenze collegate in modo statico. Nel classpath non sono incluse dipendenze dichiarate con lib.
  • L'isolation runner inserisce nel classpath solo l'isolation runner e il file jar di test.
  • Esiste un determinato carico fisso per ogni esecuzione di test eseguita con questo runner.

Configurazione di test Tradefed di esempio (isolata)

<configuration description="Executes HelloWorldHostTest">
    <test class="com.android.tradefed.testtype.IsolatedHostTest" >
        <option name="jar" value="HelloWorldHostTest.jar" />
    </test>
</configuration>

Configurazione di esempio di Soong per l'autogenerazione

Anziché creare manualmente la configurazione di test come sopra, Soong può generarla automaticamente utilizzando una dichiarazione come questo esempio. 

java_test_host {
    name: "HelloWorldHostTest",

    test_options: {
        unit_test: true,
    },

    test_suites: ["general-tests"],

    srcs: ["test/**/*.java"],

    static_libs: [
        "junit",
    ],
}

Test Robolectric

I test Robolectric utilizzano lo stesso runner dei test host isolati, con alcune opzioni speciali.

  • L'opzione robolectric-resources consente di passare alcune opzioni della riga di comando specifiche di Robolectric al sottoprocesso e aggiunge la compilazione ad albero di android-all al percorso di classe del sottoprocesso. Mentre le altre due sono best practice, questa opzione è obbligatoria per eseguire i test Robolectric senza problemi.
  • L'opzione java-folder consente di modificare il runtime Java utilizzato dal sottoprocesso. Questo è necessario perché Robolectric preferisce determinate versioni di Java che potrebbero non essere in linea con la JVM preferita del sistema host.
  • L'opzione exclude-paths consente al programma di esecuzione dei sottoprocessi di evitare del tutto il caricamento di determinati moduli, il che è utile quando un JAR è dotato di classi estranee che potrebbero causare errori di caricamento. java. è un'esclusione comune per evitare di generare eccezioni SecurityException.

Configurazione Robolectric di esempio

<configuration description="Executes a Sample Robolectric Test">
    <option name="java-folder" value="prebuilts/jdk/jdk9/linux-x86/" />
    <option name="exclude-paths" value="java" />
    <option name="use-robolectric-resources" value="true" />
    <test class="com.android.tradefed.testtype.IsolatedHostTest">
        <option name="jar" value="RobolectricExampleTest.jar" />
    </test>
</configuration>

Configurazione di esempio di Soong per la generazione automatica di Robolectric

Anziché creare manualmente la configurazione di test come sopra, Soong può generare automaticamente la configurazione utilizzando una dichiarazione come questo esempio. 

android_robolectric_test {
    name: "HelloWorldRoboTest",
    srcs: [
        "src/**/*.java",
    ],

    // Include the testing libraries
    static_libs: [
        "mockito-robolectric-prebuilt",
        "platform-test-annotations",
        "testng",
        "truth-prebuilt",
    ],

    instrumentation_for: "HelloWorldApp",
}

Test di Python

Se la logica di test è scritta in Python, utilizza il tipo di compilazione python_test_host per creare un file par che può essere eseguito da TF PythonBinaryHostTest.

Configurazione di test di TradeFed di esempio

<configuration description="Config to run atest unittests">
    <test class="com.android.tradefed.testtype.python.PythonBinaryHostTest" >
        <option name="par-file-name" value="atest_unittests" />
        <option name="test-timeout" value="2m" />
    </test>
</configuration>

Impostazione della suite di test

Affinché il test lato host sia accessibile da TF per una determinata build, imposta l'impostazione del modulo di test `test_suites` su `general-tests`:

test_suites: ["general-tests"],

Con questa impostazione, il test viene pacchettizzato per general-tests.zip nel target test_suites.