# Cloud Upload an app binary and run Maestro flows on DeviceCloud. This is the primary command and a drop-in replacement for `maestro cloud`. ```bash dcd cloud [flags] ``` The command blocks until all tests have completed, then exits with an appropriate [exit code](https://docs.devicecloud.dev/advanced/exit-codes). ## Arguments | Argument | Description | | ------------- | ---------------------------------------------------------------------- | | `` | Path to your app binary (`.apk` for Android, `.app` or `.zip` for iOS) | | `` | Path to the flow file or directory of flows to run | ## Flags ### Authentication | Flag | Description | | ----------------- | -------------------------------------------------------------------- | | `--api-key ` | Your DeviceCloud API key. Defaults to `DEVICE_CLOUD_API_KEY` env var | ### App | Flag | Description | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--app-binary-id ` | Reuse a previously uploaded binary instead of uploading again | | `--app-url ` | Signed URL to an Expo iOS build (`.tar.gz`). The archive is downloaded and extracted automatically. Expo signed URLs expire after \~1 hour. Mutually exclusive with `--app-file` | | `--additional-app-files ` | Comma-separated list of additional app files to upload | | `--additional-app-binary-ids ` | Comma-separated list of additional binary IDs to include | | `--ignore-sha-check` | Force re-upload even if a binary with the same SHA already exists | ### Device | Flag | Description | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `--android-device ` | Android device model to run on (see [Devices](https://docs.devicecloud.dev/getting-started/devices-configuration)) | | `--android-api-level ` | Android API level | | `--ios-device ` | iOS device model to run on (see [Devices](https://docs.devicecloud.dev/getting-started/devices-configuration)) | | `--ios-version ` | iOS version | | `--device-locale ` | Device locale (see [Device Locale](https://docs.devicecloud.dev/configuration/device-locale)) | | `--orientation ` | Device orientation (see [Orientation](https://docs.devicecloud.dev/configuration/orientation)) | | `--google-play` | Use a Google Play-enabled device (see [Google Play APIs](https://docs.devicecloud.dev/configuration/google-play-apis)) | | `--runner-type ` | Runner type to use (see [Runner Types](https://docs.devicecloud.dev/configuration/runner-type)) | ### Flows | Flag | Description | | ------------------------- | ------------------------------------------------------------------------- | | `--flows ` | Comma-separated list of flow files to run (alternative to positional arg) | | `--config ` | Path to a `config.yaml` workspace config file | | `--exclude-flows ` | Comma-separated list of flow files to exclude | | `--include-tags ` | Only run flows with these tags (comma-separated) | | `--exclude-tags ` | Skip flows with these tags (comma-separated) | ### Test Configuration | Flag | Description | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--maestro-version ` | Maestro version to use (see [Maestro Versions](https://docs.devicecloud.dev/configuration/maestro-versions)) | | `--env ` | Environment variables to pass to the test. Repeat for multiple values | | `--name ` | Name for this upload (shown in the console) | | `--retry ` | Retry failed tests up to `n` times. Max `2` (see [Retry Strategies](https://docs.devicecloud.dev/advanced/retry-strategies)) | | `--report ` | Generate a report. Options: `junit`, `html`, `html-detailed`, `allure` (see [Report Formats](https://docs.devicecloud.dev/test-results-and-artifacts/report-formats)) | ### GitHub / PR Context Attach Git and pull request metadata to a run. These values are displayed in the DeviceCloud console alongside the test results, making it easy to trace a run back to the exact commit or PR that triggered it. | Flag | Description | | -------------------------- | ------------------------------------------------------ | | `--branch ` | Git branch name for this run | | `--commit-sha ` | Git commit SHA for this run | | `--repo-name ` | Repository in `owner/repo` format (e.g. `acme/my-app`) | | `--pr-number ` | Pull request number | | `--pr-url ` | Pull request URL | ### Android-Specific | Flag | Description | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `--maestro-chrome-onboarding` | Run Chrome onboarding before tests (see [Chrome Onboarding](https://docs.devicecloud.dev/advanced/chrome-onboarding)) | | `--android-no-snapshot` | Disable snapshot restore at test start | | `--enable-animations` | Enable device animations during tests | ### Output & Execution | Flag | Description | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `--async` | Submit tests and return immediately without waiting for results (see [Async Execution](https://docs.devicecloud.dev/advanced/async-execution)) | | `--quiet` | Suppress per-test output; print only the final summary | | `--json` | Output results as JSON. Exits `0` even on test failure | | `--json-file ` | Write JSON results to a file | | `--download-artifacts ` | Download test artifacts after completion (see [Artifacts](https://docs.devicecloud.dev/test-results-and-artifacts/artifacts)) | | `--debug` | Enable verbose debug logging | | `--use-beta` | Use the beta version of the DeviceCloud runner | ## Examples **Android:** ```bash dcd cloud app.apk flows/ --android-device "Pixel 8" --android-api-level 34 ``` **iOS:** ```bash dcd cloud app.zip flows/ --ios-device "iPhone 16" --ios-version 18 ``` **Filter by tag:** ```bash dcd cloud app.apk flows/ --include-tags smoke ``` **Reuse a previously uploaded binary:** ```bash dcd cloud flows/ --app-binary-id 67894274-b789-4c1e-80d4-da8998998999 ``` **Save results to JSON:** ```bash dcd cloud app.apk flows/ --json-file results.json ```