/gaia-test-device-matrix

user-facing

Category:: Testing
Lifecycle phase:: Anytime
Arguments:: [--platform ios|android|all] [--filter REGEX] [--config PATH]

What it does

Expands a configured device-target matrix (OS versions x form factors x screen sizes) and dispatches each entry to the device-farm adapter. Returns per-device verdicts plus a composite verdict.

When to use it

You need to verify your app across a matrix of devices, OS versions, and form factors.

Prerequisites

Device targets must be configured in project-config.yaml. A device-farm adapter must be set up.

How to invoke

/gaia-test-device-matrix --platform ios
/gaia-test-device-matrix --platform android
/gaia-test-device-matrix --platform all
/gaia-test-device-matrix --filter "iPhone.*"
/gaia-test-device-matrix --platform ios --filter "iPad.*"

What it does step by step

See the description above for the high-level flow. The command handles all steps automatically.

Inputs

Input	Source	Description	Example
`--platform`	Argument (optional)	Platform to test: ios, android, or all.	`/gaia-test-device-matrix --platform ios`
`--filter`	Argument (optional)	Regex filter to restrict matrix entries.	`/gaia-test-device-matrix --filter "iPhone.*"`
`--config`	Argument (optional)	Path to project-config.yaml (auto-resolved by default).	`/gaia-test-device-matrix --config .gaia/config/project-config.yaml`

Outputs

Per-device verdicts for each matrix entry and a composite verdict.

Example session

> /gaia-test-device-matrix --platform ios

Running...
(Command output varies by project and configuration.)

What to run next

Follow the suggestions displayed at the end of the command output.

Troubleshooting

Check that prerequisite files and tools are in place. The command provides specific error messages with guidance when something is missing.