@react-native-harness/platform-android 1.3.0 → 1.4.0

package/src/__tests__/avd-config.test.ts

@@ -6,6 +6,9 @@ import {
   resolveAvdCachingEnabled,
 } from '../avd-config.js';
 import { AndroidPlatformConfigSchema } from '../config.js';
+import { getEmulatorCpuCores } from '../emulator-startup.js';
+
+const emulatorCpuCores = getEmulatorCpuCores();
 
 describe('AVD config helpers', () => {
   it('parses snapshot config from Android schema', () => {
@@ -73,8 +76,11 @@ abi.type=x86_64
 hw.device.name=pixel_8
 disk.dataPartition.size=1G
 vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores}
 `);
 
+    expect(avdConfig.hwCpuNcore).toBe(String(emulatorCpuCores));
+
     expect(
       isAvdCompatible({
         emulator: {
@@ -93,6 +99,69 @@ vm.heapSize=512M
     ).toEqual({ compatible: true });
   });
 
+  it('rejects AVDs missing hw.cpu.ncore', () => {
+    const avdConfig = parseAvdConfig(`
+image.sysdir.1=system-images/android-35/default/x86_64/
+abi.type=x86_64
+hw.device.name=pixel_8
+disk.dataPartition.size=1G
+vm.heapSize=512M
+`);
+
+    expect(
+      isAvdCompatible({
+        emulator: {
+          type: 'emulator',
+          name: 'Pixel_8_API_35',
+          avd: {
+            apiLevel: 35,
+            profile: 'pixel_8',
+            diskSize: '1G',
+            heapSize: '512M',
+          },
+        },
+        avdConfig,
+        hostArch: 'x86_64',
+      })
+    ).toMatchObject({
+      compatible: false,
+      reason: `CPU core count mismatch: expected ${emulatorCpuCores}, got missing.`,
+    });
+  });
+
+  it('rejects AVDs with a different hw.cpu.ncore', () => {
+    const avdConfig = parseAvdConfig(`
+image.sysdir.1=system-images/android-35/default/x86_64/
+abi.type=x86_64
+hw.device.name=pixel_8
+disk.dataPartition.size=1G
+vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores === 4 ? 3 : 4}
+`);
+
+    expect(
+      isAvdCompatible({
+        emulator: {
+          type: 'emulator',
+          name: 'Pixel_8_API_35',
+          avd: {
+            apiLevel: 35,
+            profile: 'pixel_8',
+            diskSize: '1G',
+            heapSize: '512M',
+          },
+        },
+        avdConfig,
+        hostArch: 'x86_64',
+      })
+    ).toMatchObject({
+      compatible: false,
+      reason: `CPU core count mismatch: expected ${emulatorCpuCores}, got ${
+        emulatorCpuCores === 4 ? 3 : 4
+      }.`,
+    });
+  });
+
   it('accepts disk partition sizes rewritten to bytes', () => {
     const avdConfig = parseAvdConfig(`
 image.sysdir.1=system-images/android-35/default/x86_64/
@@ -100,6 +169,7 @@ abi.type=x86_64
 hw.device.name=pixel_8
 disk.dataPartition.size=6442450944
 vm.heapSize=512M
+hw.cpu.ncore=${emulatorCpuCores}
 `);
 
     expect(

package/src/__tests__/crash-diagnostics.test.ts

@@ -0,0 +1,144 @@
+import { describe, expect, it } from 'vitest';
+import {
+  collectDropboxArtifacts,
+  filterExitInfo,
+  getBestDropboxArtifact,
+  parseDropboxOutput,
+} from '../crash-diagnostics.js';
+
+const javaCrashDropbox = `
+Drop box contents: 1 entries
+Max entries: 1000
+========================================
+2026-03-12 10:30:45.123 data_app_crash (text, 500 bytes)
+Process: com.harnessplayground
+PID: 7777
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: boom
+\tat com.harnessplayground.MainActivity.onCreate(MainActivity.kt:38)
+`;
+
+const nativeCrashDropbox = `
+========================================
+2026-03-12 10:31:10.456 data_app_native_crash (text, 800 bytes)
+Process: com.harnessplayground
+PID: 8888
+signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xdeadbeef
+Abort message: 'JNI DETECTED ERROR IN APPLICATION'
+backtrace:
+      #00 pc 00001234  /data/app/lib/libapp.so
+`;
+
+const deviceJavaCrashDropbox = `
+Drop box contents: 8 entries
+Searching for: data_app_crash
+
+========================================
+2026-05-29 10:22:34 data_app_crash (text, 1328 bytes)
+SystemUptimeMs: 79467172
+Process: com.harnessplayground
+PID: 586
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: Intentional asynchronous Kotlin crash
+\tat com.harnessplayground.PlaygroundCrashModule.crashFromKotlinAsync(PlaygroundCrashModule.kt:44)
+`;
+
+describe('collectDropboxArtifacts', () => {
+  it('matches harness playground crashes from merged per-tag dropbox output', async () => {
+    const artifacts = await collectDropboxArtifacts({
+      bundleId: 'com.harnessplayground',
+      getDropboxOutput: async () => deviceJavaCrashDropbox,
+      occurredAt: Date.now(),
+      pid: 586,
+    });
+
+    expect(artifacts).toHaveLength(1);
+    expect(artifacts[0]).toMatchObject({
+      artifactType: 'dropbox-crash',
+      pid: 586,
+      processName: 'com.harnessplayground',
+    });
+  });
+
+  it('ignores Dropbox entries older than the session start time', async () => {
+    const artifacts = await collectDropboxArtifacts({
+      bundleId: 'com.harnessplayground',
+      getDropboxOutput: async () => deviceJavaCrashDropbox,
+      minOccurredAt: Date.parse('2026-05-29T10:22:35.000Z'),
+      occurredAt: Date.parse('2026-05-29T10:22:36.000Z'),
+    });
+
+    expect(artifacts).toHaveLength(0);
+  });
+});
+
+describe('parseDropboxOutput', () => {
+  it('parses java and native dropbox entries', () => {
+    const entries = parseDropboxOutput(`${javaCrashDropbox}\n${nativeCrashDropbox}`);
+
+    expect(entries).toHaveLength(2);
+    expect(entries[0]).toMatchObject({
+      tag: 'data_app_crash',
+      pid: 7777,
+    });
+    expect(entries[1]).toMatchObject({
+      tag: 'data_app_native_crash',
+      pid: 8888,
+    });
+    expect(entries[1]?.content).toContain('SIGSEGV');
+  });
+});
+
+describe('getBestDropboxArtifact', () => {
+  it('prefers the highest-scored artifact', () => {
+    const entries = parseDropboxOutput(`${javaCrashDropbox}\n${nativeCrashDropbox}`);
+    const artifacts = entries.map((entry, index) => ({
+      artifactType:
+        entry.tag === 'data_app_native_crash'
+          ? ('dropbox-native-crash' as const)
+          : ('dropbox-crash' as const),
+      dropboxTag: entry.tag,
+      occurredAt: Date.now(),
+      score: index === 0 ? 100 : 300,
+      summary: entry.content,
+      pid: entry.pid,
+      processName: 'com.harnessplayground',
+    }));
+
+    expect(getBestDropboxArtifact(artifacts)?.dropboxTag).toBe(
+      'data_app_native_crash'
+    );
+  });
+});
+
+describe('filterExitInfo', () => {
+  it('returns matching exit-info records for the target package and pid', () => {
+    const output = `
+ApplicationExitInfo #0:
+  package=com.harnessplayground pid=7777 realUid=10123
+  reason=4 (APP CRASH(NATIVE))
+  timestamp=2026-03-12 10:31:10.456
+ApplicationExitInfo #1:
+  package=com.other.app pid=9999 realUid=10199
+  reason=10 (USER REQUESTED)
+`;
+
+    const filtered = filterExitInfo({
+      output,
+      bundleId: 'com.harnessplayground',
+      pid: 7777,
+    });
+
+    expect(filtered).toContain('com.harnessplayground pid=7777');
+    expect(filtered).not.toContain('com.other.app');
+  });
+
+  it('returns null when no exit-info records exist', () => {
+    expect(
+      filterExitInfo({
+        output: 'No exit info records for com.harnessplayground',
+        bundleId: 'com.harnessplayground',
+      })
+    ).toBeNull();
+  });
+});

package/src/__tests__/crash-reporter.test.ts

@@ -0,0 +1,167 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { createAndroidCrashReporter } from '../crash-reporter.js';
+
+const javaCrashDropbox = `
+========================================
+2026-03-12 10:30:45.123 data_app_crash (text, 500 bytes)
+Process: com.harnessplayground
+PID: 7777
+Package: com.harnessplayground v1 (1.0)
+java.lang.RuntimeException: boom
+\tat com.harnessplayground.MainActivity.onCreate(MainActivity.kt:38)
+`;
+
+const nativeCrashDropbox = `
+========================================
+2026-03-12 10:31:10.456 data_app_native_crash (text, 800 bytes)
+Process: com.harnessplayground
+PID: 8888
+signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xdeadbeef
+Abort message: 'JNI DETECTED ERROR IN APPLICATION'
+backtrace:
+      #00 pc 00001234  /data/app/lib/libapp.so
+`;
+
+describe('createAndroidCrashReporter', () => {
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('persists the current logcat crash block with the test file path', async () => {
+    vi.useFakeTimers();
+    const persistArtifact = vi.fn(
+      () => '/tmp/.harness/crash-reports/logcat.txt'
+    );
+    const reporter = createAndroidCrashReporter({
+      bundleId: 'com.harnessplayground',
+      crashArtifactWriter: {
+        runTimestamp: '2026-03-12T11-35-08-000Z',
+        persistArtifact,
+      },
+      getLogs: () => [
+        { line: 'ordinary crash-buffer line', occurredAt: 1_000 },
+        { line: '--------- beginning of crash', occurredAt: 1_100 },
+        {
+          line: 'Process: com.harnessplayground, PID: 7777',
+          occurredAt: 1_100,
+        },
+        { line: 'FATAL EXCEPTION: main', occurredAt: 1_100 },
+      ],
+    });
+
+    const detailsPromise = reporter.getCrashDetails({
+      occurredAt: 1_100,
+      pid: 7777,
+      testFilePath: '/test/native-crash.test.ts',
+    });
+    await vi.advanceTimersByTimeAsync(100);
+    const details = await detailsPromise;
+
+    expect(details).toMatchObject({
+      artifactType: 'logcat',
+      artifactPath: '/tmp/.harness/crash-reports/logcat.txt',
+      pid: 7777,
+      processName: 'com.harnessplayground',
+    });
+    expect(persistArtifact).toHaveBeenCalledWith({
+      artifactKind: 'logcat',
+      testFilePath: '/test/native-crash.test.ts',
+      source: {
+        kind: 'text',
+        fileName: 'logcat.txt',
+        text: [
+          '--------- beginning of crash',
+          'Process: com.harnessplayground, PID: 7777',
+          'FATAL EXCEPTION: main',
+          '',
+        ].join('\n'),
+      },
+    });
+  });
+
+  it('adds dropbox artifacts as enrichment when logcat evidence is available', async () => {
+    vi.useFakeTimers();
+    const persistArtifact = vi
+      .fn()
+      .mockImplementation(({ artifactKind }: { artifactKind: string }) => {
+        return `/tmp/.harness/crash-reports/${artifactKind}.txt`;
+      });
+    const reporter = createAndroidCrashReporter({
+      bundleId: 'com.harnessplayground',
+      crashArtifactWriter: {
+        runTimestamp: '2026-03-12T11-35-08-000Z',
+        persistArtifact,
+      },
+      getLogs: () => [
+        { line: '--------- beginning of crash', occurredAt: 1_100 },
+        {
+          line: 'Process: com.harnessplayground, PID: 7777',
+          occurredAt: 1_100,
+        },
+        { line: 'FATAL EXCEPTION: main', occurredAt: 1_100 },
+      ],
+      getDropboxOutput: async () => javaCrashDropbox,
+      getExitInfo: async () =>
+        'ApplicationExitInfo #0:\n  package=com.harnessplayground pid=7777 reason=4 (APP CRASH(NATIVE))',
+    });
+
+    const detailsPromise = reporter.getCrashDetails({
+      occurredAt: 1_100,
+      pid: 7777,
+      testFilePath: '/test/native-crash.test.ts',
+    });
+    await vi.advanceTimersByTimeAsync(100);
+    const details = await detailsPromise;
+
+    expect(details).toMatchObject({
+      artifactType: 'logcat',
+      artifactPath: '/tmp/.harness/crash-reports/logcat.txt',
+    });
+    expect(details?.enrichmentArtifacts).toEqual(
+      expect.arrayContaining([
+        {
+          artifactType: 'dropbox-crash',
+          artifactPath: '/tmp/.harness/crash-reports/dropbox-crash.txt',
+        },
+        {
+          artifactType: 'exit-info',
+          artifactPath: '/tmp/.harness/crash-reports/exit-info.txt',
+        },
+      ])
+    );
+  });
+
+  it('falls back to native dropbox evidence when logcat is empty', async () => {
+    vi.useFakeTimers();
+    const persistArtifact = vi
+      .fn()
+      .mockImplementation(({ artifactKind }: { artifactKind: string }) => {
+        return `/tmp/.harness/crash-reports/${artifactKind}.txt`;
+      });
+    const reporter = createAndroidCrashReporter({
+      bundleId: 'com.harnessplayground',
+      crashArtifactWriter: {
+        runTimestamp: '2026-03-12T11-35-08-000Z',
+        persistArtifact,
+      },
+      getLogs: () => [],
+      getDropboxOutput: async () => nativeCrashDropbox,
+    });
+
+    const detailsPromise = reporter.getCrashDetails({
+      occurredAt: 1_100,
+      pid: 8888,
+      testFilePath: '/test/native-crash.test.ts',
+    });
+    await vi.advanceTimersByTimeAsync(100);
+    const details = await detailsPromise;
+
+    expect(details).toMatchObject({
+      artifactType: 'dropbox-native-crash',
+      artifactPath: '/tmp/.harness/crash-reports/dropbox-native-crash.txt',
+      pid: 8888,
+      signal: 'SIGSEGV',
+      processName: 'com.harnessplayground',
+    });
+  });
+});

package/src/__tests__/emulator-startup.test.ts

@@ -1,5 +1,19 @@
 import { describe, expect, it } from 'vitest';
-import { getEmulatorStartupArgs } from '../emulator-startup.js';
+import {
+  getEmulatorCpuCores,
+  getEmulatorStartupArgs,
+  isAccelerationUsable,
+} from '../emulator-startup.js';
+import { getDeviceCoreBudget } from '@react-native-harness/tools';
+import os from 'node:os';
+
+describe('getEmulatorCpuCores', () => {
+  it('uses the shared device-core budget for the current host', () => {
+    expect(getEmulatorCpuCores()).toBe(
+      getDeviceCoreBudget(os.availableParallelism())
+    );
+  });
+});
 
 describe('emulator startup modes', () => {
   it('builds default boot args', () => {
@@ -8,17 +22,24 @@ describe('emulator startup modes', () => {
         '@Pixel_8_API_35',
         '-no-snapshot-load',
         '-no-snapshot-save',
+        '-no-metrics',
       ])
     );
-    expect(getEmulatorStartupArgs('Pixel_8_API_35', 'default-boot')).not.toEqual(
-      expect.arrayContaining(['-camera-back', 'none'])
-    );
+    expect(
+      getEmulatorStartupArgs('Pixel_8_API_35', 'default-boot')
+    ).not.toEqual(expect.arrayContaining(['-camera-back', 'none']));
   });
 
   it('builds clean snapshot generation args', () => {
     expect(
       getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')
-    ).toEqual(expect.arrayContaining(['@Pixel_8_API_35', '-no-snapshot-load']));
+    ).toEqual(
+      expect.arrayContaining([
+        '@Pixel_8_API_35',
+        '-no-snapshot-load',
+        '-no-metrics',
+      ])
+    );
     expect(
       getEmulatorStartupArgs('Pixel_8_API_35', 'clean-snapshot-generation')
     ).not.toContain('-no-snapshot-save');
@@ -26,10 +47,36 @@ describe('emulator startup modes', () => {
 
   it('builds snapshot reuse args', () => {
     expect(getEmulatorStartupArgs('Pixel_8_API_35', 'snapshot-reuse')).toEqual(
-      expect.arrayContaining(['@Pixel_8_API_35', '-no-snapshot-save'])
+      expect.arrayContaining([
+        '@Pixel_8_API_35',
+        '-no-snapshot-save',
+        '-no-metrics',
+      ])
     );
     expect(
       getEmulatorStartupArgs('Pixel_8_API_35', 'snapshot-reuse')
     ).not.toContain('-no-snapshot-load');
   });
 });
+
+describe('isAccelerationUsable', () => {
+  it('returns true when the emulator reports acceleration is usable', () => {
+    expect(
+      isAccelerationUsable(
+        'accel:\n0\nKVM (version 12) is installed and usable.\naccel\n'
+      )
+    ).toBe(true);
+  });
+
+  it('returns false when acceleration is disabled', () => {
+    expect(
+      isAccelerationUsable(
+        'accel:\n0\nKVM is not installed on this machine.\naccel\n'
+      )
+    ).toBe(false);
+  });
+
+  it('returns false for empty output', () => {
+    expect(isAccelerationUsable('')).toBe(false);
+  });
+});