Panoramica dell'esecuzione del dispositivo della piattaforma del dispositivo per sviluppatori

Ti diamo il benvenuto in Esecuzione di test su dispositivi della piattaforma Developer Device, che ti consente di eseguire test su dispositivi Android fisici e virtuali e su dispositivi iOS fisici nel cloud. Questa pagina descrive i punti in comune tra l'esecuzione di test Android e iOS. Consulta Device Run per Android e Device Run per iOS per i passaggi specifici per la piattaforma.

Per utilizzare questa Google Cloud CLI, devi fornire l'ID del tuo Google Cloud progetto. Per un riepilogo dei comandi, consulta: gcloud beta device-run

Tieni presente che questi flag sono obbligatori:

  • Dispositivo: specifica un dispositivo utilizzando --device: --device shiba-35 o --device iphonese3-18-4
  • Test: specifica l'APK o l'IPA di test utilizzando --test: --test /path/to/test.apk o --test /path/to/test.ipa

Le seguenti opzioni di configurazione sono comuni ai test Android e iOS.

Percorsi Cloud Storage di input e output

  • Bucket Cloud Storage personalizzato: puoi specificare un bucket Cloud Storage personalizzato per input e output: --bucket-name=my-custom-bucket Se non specifichi un bucket Cloud Storage utilizzando il flag --bucket-name=, Google Cloud CLI utilizzerà un bucket predefinito denominato PROJECT_ID-devicerun.
  • File di input: quando specifichi un percorso locale con i flag --test, --additional-apps o --xctestrun-file, Google Cloud CLI lo copia automaticamente nel bucket Cloud Storage in gs://BUCKET_NAME/automation/inputs/DATE_TIME_FOUR_CHARS_SUFFIX/ ogni volta che esegui il comando, dove BUCKET_NAME è impostato per impostazione predefinita su PROJECT_ID-devicerun.
  • Percorsi cloud: poiché il caricamento di file di grandi dimensioni può richiedere molto tempo, puoi farvi riferimento direttamente utilizzando i percorsi gs:// di Cloud Storage per risparmiare tempo di caricamento.
  • File dei risultati: gli artefatti di output vengono caricati nel bucket Cloud Storage in gs://BUCKET_NAME/automation/sessions/session-[SESSION_ID]/.

Esecuzioni sincrone e asincrone

Per impostazione predefinita, il comando di invio è bloccante (sincrono). Attenderà il completamento del test e stamperà una tabella riepilogativa dei risultati.

Per inviare la sessione e tornare immediatamente dopo aver caricato i file in Cloud Storage, aggiungi il flag --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

Restituisce immediatamente un ID sessione. Puoi quindi attendere che venga eseguito utilizzando il comando sessions wait:

gcloud beta device-run sessions wait SESSION_ID

Il comando verrà bloccato fino al completamento del job.

Più dispositivi

Per eseguire gli stessi test su più dispositivi, fornisci il flag --device con più ID dispositivo separati da virgole o con più flag --device, ognuno che specifica un ID dispositivo distinto.

Android

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

Oppure:

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

Oppure:

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

Timeout test

Limita la durata dell'esecuzione del 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

L'intervallo valido è compreso tra 1m e 1h e il valore predefinito è 5m.

Passaggi successivi

Esegui un test Android o esegui un test iOS con la piattaforma del dispositivo per sviluppatori.