Skip to main content

How to run your first test

A complete beginner guide from installation to viewing test results.

Prerequisites​

  • Node.js 20+ installed
  • An Android APK or a running emulator
  • An Aucert account

Steps​

Step 1: Install the CLI​

npm install -g @aucert/cli

Verify: aucert --version prints the version number.

Step 2: Authenticate​

aucert auth login

Verify: browser opens, you complete OAuth, terminal shows "Authenticated successfully."

Step 3: Initialize your project​

cd your-android-project
aucert init

Verify: aucert.config.yaml is created in the current directory.

Step 4: Run tests​

aucert run --watch

Verify: you see real-time progress as tests generate, execute, and report results.

Step 5: View results​

aucert status --latest

Verify: a summary table shows tests run, passed, failed, and any bug reports with confidence scores.

Troubleshooting​

"No APK found" — Specify the APK path explicitly: aucert init --app ./path/to/app.apk

"Emulator not detected" — Ensure an Android emulator is running: adb devices should list a device.

"Authentication failed" — Run aucert auth login again. Ensure you're using the correct account.

What's next​