Skip to main content

Mobile Next Cloud

Mobile Next Cloud gives you API access to hundreds of real Android and iOS devices. Mobilewright allocates one device per worker, runs your tests, and uploads the results to your dashboard — no reporter configuration needed.

Setup​

The driver ships with Mobilewright — nothing extra to install.

1. Get an API key​

Sign in at mobilenext.ai, create an API key, and export it:

export MOBILENEXT_API_KEY=...

2. Set the driver​

// mobilewright.config.ts
import { defineConfig } from 'mobilewright';
import { MobileNextDriver } from '@mobilewright/driver-mobilenext';

export default defineConfig({
  testDir: './tests',
  bundleId: 'com.example.app',
  driver: new MobileNextDriver(), // reads MOBILENEXT_API_KEY from the environment
  projects: [
    {
      name: 'ios',
      use: { platform: 'ios', deviceType: 'real', osVersion: '>=18', installApps: ['./build/app.ipa'] },
    },
    {
      name: 'android',
      use: { platform: 'android', deviceType: 'real', installApps: ['./build/app.apk'] },
    },
  ],
});

The API key is read from the MOBILENEXT_API_KEY environment variable. To supply it some other way, pass it explicitly — an explicit apiKey always takes precedence over the environment variable:

driver: new MobileNextDriver({ apiKey: loadKeyFromVault() }),

Device selection uses the standard config fields — platform, deviceType, deviceName, osVersion — see Configuration for the full list of driver options such as allocationTimeout and uploadTimeout.

Switching between a local device and the cloud​

Keep one config and pick the driver by environment: local (mobilecli) by default, Mobile Next Cloud when the API key is present.

import { defineConfig, type MobilewrightConfig } from 'mobilewright';
import { MobileNextDriver } from '@mobilewright/driver-mobilenext';

const config: MobilewrightConfig = {
  testDir: './tests',
  bundleId: 'com.example.app',
  fullyParallel: true,
  workers: process.env.CI ? 4 : 1,
  projects: [
    { name: 'ios', use: { platform: 'ios', deviceType: 'real', installApps: ['./build/app.ipa'] } },
  ],
};

if (process.env.MOBILENEXT_API_KEY) {
  config.driver = new MobileNextDriver();
}

export default defineConfig(config);
npx mobilewright test                              # local device
MOBILENEXT_API_KEY=... npx mobilewright test       # the same suite on Mobile Next Cloud

Test results​

With MobileNextDriver, the HTML report and test results are uploaded to mobilenext.ai after every run. Control this with the driver's testResult option — see Reporting.

Debugging​

Set DEBUG=mw:driver-mobilenext to log device allocation and connection details. See Troubleshooting.