Présentation de l'exécution des appareils sur la plate-forme Developer Device

Bienvenue dans Developer Device Platform Device Run, qui vous permet d'exécuter des tests sur des appareils Android physiques et virtuels, ainsi que sur des appareils iOS physiques dans le cloud. Cette page décrit les points communs entre l'exécution de tests Android et iOS. Consultez Exécuter sur un appareil pour Android et Exécuter sur un appareil pour iOS pour connaître les étapes spécifiques à chaque plate-forme.

Pour utiliser cette Google Cloud CLI, vous devrez fournir l'ID de votre projet Google Cloud . Pour obtenir un récapitulatif des commandes, consultez gcloud beta device-run.

Notez que ces options sont obligatoires :

  • Appareil : spécifiez un appareil à l'aide de --device : --device shiba-35 ou --device iphonese3-18-4.
  • Test : spécifiez l'APK ou l'IPA de test à l'aide de --test : --test /path/to/test.apk ou --test /path/to/test.ipa.

Les options de configuration suivantes sont communes aux tests Android et iOS.

Chemins d'entrée et de sortie Cloud Storage

  • Bucket Cloud Storage personnalisé : vous pouvez spécifier un bucket Cloud Storage personnalisé pour les entrées et les sorties : --bucket-name=my-custom-bucket. Si vous ne spécifiez pas de bucket Cloud Storage à l'aide du flag --bucket-name=, la Google Cloud CLI utilisera un bucket par défaut nommé PROJECT_ID-devicerun.
  • Fichiers d'entrée : lorsque vous spécifiez un chemin d'accès local avec les indicateurs --test, --additional-apps ou --xctestrun-file, la Google Cloud CLI le copie automatiquement dans votre bucket Cloud Storage sous gs://BUCKET_NAME/automation/inputs/DATE_TIME_FOUR_CHARS_SUFFIX/ chaque fois que vous exécutez la commande, où BUCKET_NAME est défini par défaut sur PROJECT_ID-devicerun.
  • Chemins Cloud : comme l'importation de fichiers volumineux peut prendre du temps, vous pouvez y faire référence directement à l'aide de leurs chemins gs:// Cloud Storage pour gagner du temps.
  • Fichiers de résultats : les artefacts de sortie sont importés dans votre bucket Cloud Storage sous gs://BUCKET_NAME/automation/sessions/session-[SESSION_ID]/.

Exécutions synchrones et asynchrones

Par défaut, la commande d'envoi est bloquante (synchrone). Il attendra la fin du test et imprimera un tableau récapitulatif des résultats.

Pour envoyer la session et revenir immédiatement après avoir importé des fichiers dans Cloud Storage, ajoutez l'option --async :

Android

gcloud beta device-run sessions submit instrumentation \
  --device shiba-35 \
  --test ./ANDROID_TESTS.apk \
  --async

iOS

gcloud beta device-run sessions submit xctest \
  --device iphonese3-18-4 \
  --test ./IOS_TESTS.zip \
  --async

Un ID de session est renvoyé immédiatement. Vous pouvez ensuite l'attendre à l'aide de la commande sessions wait :

gcloud beta device-run sessions wait SESSION_ID

La commande sera bloquée jusqu'à ce que le job soit terminé.

Plusieurs appareils

Pour exécuter les mêmes tests sur plusieurs appareils, fournissez l'indicateur --device avec plusieurs ID d'appareils séparés par des virgules ou avec plusieurs indicateurs --device, chacun spécifiant un ID d'appareil distinct.

Android

gcloud beta device-run sessions submit instrumentation \
  --device shiba-34,tokay-36 \
  --test ./ANDROID_TESTS.apk

ou

gcloud beta device-run sessions submit instrumentation \
  --device shiba-34 \
  --device tokay-36 \
  --test ./ANDROID_TESTS.apk

iOS

gcloud beta device-run sessions submit xctest \
  --device iphonese3-18-4,iphonese3-26-3 \
  --test ./IOS_TESTS.zip

ou

gcloud beta device-run sessions submit xctest \
  --device iphonese3-18-4 \
  --device iphonese3-26-3 \
  --test ./IOS_TESTS.zip

Délai avant la fin du test

Limitez la durée d'exécution de votre test :

Android

gcloud beta device-run sessions submit instrumentation \
  --device shiba-35 \
  --test ./ANDROID_TESTS.apk \
  --instrumentation-timeout=10m

iOS

gcloud beta device-run sessions submit xctest \
  --device iphonese3-18-4 \
  --test ./IOS_TESTS.zip \
  --xctest-timeout=10m

La plage valide est comprise entre 1m et 1h, et la valeur par défaut est 5m.

Étapes suivantes

Exécutez un test Android ou un test iOS avec la plate-forme Developer Device.