Measure performance (Android)

Use adb commands via device.adb(...) to collect FPS and CPU metrics during a flow and assert on rendering performance and CPU load. See the Android dumpsys documentation for more on SurfaceFlinger stats.

Performance measurements run on the Android emulator. FPS values reflect emulator rendering, not physical device GPU performance. CPU values are per-core percentages and can exceed 100% on multi-core emulators (typically 4 cores).

Examples

Assert average FPS

await device.adb("shell dumpsys SurfaceFlinger --timestats -clear -enable");

// perform the rendering-heavy interaction you want to measure

const resTxt = await device.adb("shell dumpsys SurfaceFlinger --timestats -dump");
const match = resTxt.match(/averageFPS\s*=\s*(?<avgFps>\d+\.\d*)/);
const avgFps = Number(match.groups["avgFps"]);
expect(avgFps).toBeGreaterThan(40);

If the device is idle when you collect stats, the reported FPS may be near zero because there is no active rendering. Always start measuring immediately before a rendering-heavy action.

Sample CPU usage

const packageName = await driver.getCurrentPackage();
const processId = await device.adb(`shell pidof ${packageName}`);
const stdout = await device.adb(`shell top -n 1 -p ${processId}`);

const match = stdout.match(/\S+\s+\S+\s+\S+\s+\S+\s+(\S+)/);
const cpuUsage = parseFloat(match[1]);
expect(cpuUsage).toBeLessThan(50);

When to use

Your app has animations or rendering-heavy screens and you need to assert on frame rate.
Your app performs background processing and you need to verify CPU usage stays within acceptable limits.
Your flow includes a workflow that should complete without excessive CPU load.
Your team has performance budgets you want to enforce in CI.

Full sample test

import { device, flow } from "@qawolf/flows/android";

export default flow(
  "Measure performance",
  { target: "Android - Pixel", launch: true },
  async ({ driver, test }) => {
    await test("assert FPS", async () => {
      await device.adb("shell dumpsys SurfaceFlinger --timestats -clear -enable");

      // perform the rendering-heavy interaction you want to measure

      const resTxt = await device.adb("shell dumpsys SurfaceFlinger --timestats -dump");
      const match = resTxt.match(/averageFPS\s*=\s*(?<avgFps>\d+\.\d*)/);
      const avgFps = Number(match.groups["avgFps"]);
      expect(avgFps).toBeGreaterThan(40);
    });

    await test("assert CPU usage", async () => {
      const packageName = await driver.getCurrentPackage();
      const processId = await device.adb(`shell pidof ${packageName}`);
      const stdout = await device.adb(`shell top -n 1 -p ${processId}`);

      const match = stdout.match(/\S+\s+\S+\s+\S+\s+\S+\s+(\S+)/);
      const cpuUsage = parseFloat(match[1]);
      expect(cpuUsage).toBeLessThan(50);
    });
  },
);

Email & SMS

Authentication

Networking

Data sharing

Audio

Camera

Accessibility

Performance

Visual diffing

AI & LLMs

Desktop

Sensors

Measure performance (Android)

Examples

When to use

Full sample test

​Examples

​When to use

​Full sample test

Examples

When to use

Full sample test