Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  GCLOUD_TOPIC_ARG-FILES (1)


gcloud topic arg-files - supplementary help for arg-files to be used with gcloud test



Supplementary help for arg-files to be used with gcloud test.

All gcloud test android run arguments may be specified by flags on the command line and/or via a YAML-formatted ARG_FILE. The optional, positional ARG_SPEC argument on the command line is used to specify a single ARG_FILE:ARG_GROUP_NAME pair, where ARG_FILE is the path to the YAML argument file, and ARG_GROUP_NAME is the name of the argument group to load and parse. The ARG_FILE must contain valid YAML syntax or gcloud will respond with an error.

The basic format of a YAML argument file is:

arg1: value1 # a comment
arg2: value2

# Another comment arg-group2:
arg3: value3

List arguments may be specified within square brackets:

device-ids: [Nexus5, Nexus6, Nexus9]

or by using the alternate YAML list notation with one dash per list item:

- Nexus5
- Nexus6
- Nexus9

If a list argument only contains a single value, you may omit the square brackets:

device-ids: Nexus9

Note that while the command-line flags support both singular and plural forms of each list-style argument (e.g. either --device-id or --device-ids), argument files only support the plural forms.


A special include: [ARG_GROUP1, ...] syntax allows merging or composition of argument groups (see EXAMPLES below). Included argument groups can include: other argument groups within the same YAML file, with unlimited nesting.


An argument which appears on the command line has the highest precedence and will override the same argument if it is specified within an argument file.

Any argument defined directly within a group will have higher precedence than an identical argument which is merged into that group using the include: keyword.


Here are the contents of a very simple YAML argument file which we’ll assume is stored in a file named excelsior_args.yaml:

# Run a quick ’robo’ test on the ’Excelsior’ app for # 90 seconds using only the default virtual device. quick-robo-test:
app: path/to/excelsior.apk
type: robo
max-steps: 100
timeout: 90s
async: true

To invoke this test, run:

$ gcloud beta test android run excelsior_args.yaml:quick-robo-test

Here is a slightly more complicated example which demonstrates composition of argument groups. Assume the following YAML text is appended to the arg-file shown above named excelsior_args.yaml:

# Specify some unit tests to be run against a test matrix # with one device type, two Android versions, and four # locales, for a total of eight test variations (1*2*4). unit-tests:
type: instrumentation
app: path/to/excelsior.apk
test: path/to/excelsior-test.apk # the unit tests
timeout: 10m
device-ids: Nexus6
include: [supported-versions, supported-locales]

os-version-ids: [21, 22]

locales: [en, es, fr, it]

To invoke this test matrix, run:

$ gcloud beta test android run excelsior_args.yaml:unit-tests

To run these unit tests with the same locales and os-version-ids, but substituting a sampling of three physical Android devices instead of the single virtual Nexus6 device, run:

$ gcloud beta test android run excelsior2.args:unit-tests \
--device-ids shamu,m7,g3

In the last example, the --device-ids argument on the command line overrides the device-ids: specification inside the arg-file because command-line arguments have higher precedence.

Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.