@react-native-harness/platform-android 1.1.0 → 1.2.0

package/src/__tests__/app-monitor.test.ts

@@ -1,273 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import fs from 'node:fs';
-import path from 'node:path';
-import { tmpdir } from 'node:os';
-import { createAndroidAppMonitor, createAndroidLogEvent } from '../app-monitor.js';
-import * as tools from '@react-native-harness/tools';
-import { createCrashArtifactWriter } from '@react-native-harness/tools';
-
-const createMockSubprocess = (): tools.Subprocess =>
-  ({
-    nodeChildProcess: Promise.resolve({
-      kill: vi.fn(),
-    }),
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    [Symbol.asyncIterator]: async function* () {},
-  }) as unknown as tools.Subprocess;
-
-const createStreamingSubprocess = (
-  chunks: Array<{ line: string; delayMs?: number }>
-): tools.Subprocess =>
-  ({
-    nodeChildProcess: Promise.resolve({
-      kill: vi.fn(),
-    }),
-    [Symbol.asyncIterator]: async function* () {
-      for (const { line, delayMs = 0 } of chunks) {
-        if (delayMs > 0) {
-          await new Promise((resolve) => setTimeout(resolve, delayMs));
-        }
-
-        yield line;
-      }
-    },
-  }) as unknown as tools.Subprocess;
-
-const artifactRoot = fs.mkdtempSync(
-  path.join(tmpdir(), 'rn-harness-android-monitor-artifacts-')
-);
-
-afterEach(() => {
-  fs.rmSync(artifactRoot, { recursive: true, force: true });
-  fs.mkdirSync(artifactRoot, { recursive: true });
-});
-
-describe('createAndroidLogEvent', () => {
-  it('extracts crash details from fatal signal log lines', () => {
-    const event = createAndroidLogEvent(
-      '03-12 11:35:08.000  1234  1234 F libc    : Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR) in tid 1234 (com.harnessplayground), pid 1234 (com.harnessplayground)',
-      'com.harnessplayground'
-    );
-
-    expect(event).toMatchObject({
-      type: 'possible_crash',
-      source: 'logs',
-      crashDetails: {
-        source: 'logs',
-        signal: 'SIGSEGV',
-        summary:
-          '03-12 11:35:08.000  1234  1234 F libc    : Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR) in tid 1234 (com.harnessplayground), pid 1234 (com.harnessplayground)',
-      },
-    });
-  });
-
-  it('extracts process and pid when AndroidRuntime reports a crash', () => {
-    const event = createAndroidLogEvent(
-      '03-12 11:35:09.000  1234  1234 E AndroidRuntime: Process: com.harnessplayground, PID: 1234',
-      'com.harnessplayground'
-    );
-
-    expect(event).toMatchObject({
-      type: 'possible_crash',
-      pid: 1234,
-      crashDetails: {
-        processName: 'com.harnessplayground',
-        pid: 1234,
-      },
-    });
-  });
-
-  it('starts logcat from the current device timestamp', async () => {
-    const spawnSpy = vi.spyOn(tools, 'spawn');
-
-    spawnSpy.mockImplementation(
-      ((file: string, args?: readonly string[]) => {
-        if (file === 'adb' && args?.includes('date')) {
-          return {
-            stdout: '03-12 11:35:08.000\n',
-          } as Awaited<ReturnType<typeof tools.spawn>>;
-        }
-
-        return createMockSubprocess();
-      }) as typeof tools.spawn
-    );
-
-    const monitor = createAndroidAppMonitor({
-      adbId: 'emulator-5554',
-      bundleId: 'com.harnessplayground',
-      appUid: 10234,
-    });
-
-    await monitor.start();
-    await monitor.stop();
-
-    expect(spawnSpy).toHaveBeenNthCalledWith(2, 'adb', [
-      '-s',
-      'emulator-5554',
-      'logcat',
-      '-v',
-      'threadtime',
-      '-b',
-      'crash',
-      '--uid=10234',
-      '-T',
-      '03-12 11:35:08.000',
-    ], {
-      stdout: 'pipe',
-      stderr: 'pipe',
-    });
-  });
-
-  it('hydrates crash details with stack lines that arrive after the first crash event', async () => {
-    const spawnSpy = vi.spyOn(tools, 'spawn');
-
-    spawnSpy.mockImplementation(
-      ((file: string, args?: readonly string[]) => {
-        if (file === 'adb' && args?.includes('date')) {
-          return {
-            stdout: '03-12 10:44:40.000\n',
-          } as Awaited<ReturnType<typeof tools.spawn>>;
-        }
-
-        return createStreamingSubprocess([
-          { line: '--------- beginning of crash' },
-          {
-            line: '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
-          },
-          {
-            line: '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
-            delayMs: 25,
-          },
-          {
-            line: '03-12 10:44:40.422 13861 13861 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
-            delayMs: 25,
-          },
-        ]);
-      }) as typeof tools.spawn
-    );
-
-    const monitor = createAndroidAppMonitor({
-      adbId: 'emulator-5554',
-      bundleId: 'com.harnessplayground',
-      appUid: 10234,
-    });
-
-    await monitor.start();
-    await new Promise((resolve) => setTimeout(resolve, 10));
-
-    const details = await monitor.getCrashDetails({
-      pid: 13861,
-      occurredAt: Date.now(),
-    });
-
-    await monitor.stop();
-
-    expect(details?.rawLines).toEqual([
-      '--------- beginning of crash',
-      '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
-      '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
-      '03-12 10:44:40.422 13861 13861 E AndroidRuntime:     at com.harnessplayground.MainActivity.onCreate(MainActivity.kt:42)',
-    ]);
-  });
-
-  it('persists resolved Android crash blocks into .harness', async () => {
-    const spawnSpy = vi.spyOn(tools, 'spawn');
-
-    spawnSpy.mockImplementation(
-      ((file: string, args?: readonly string[]) => {
-        if (file === 'adb' && args?.includes('date')) {
-          return {
-            stdout: '03-12 10:44:40.000\n',
-          } as Awaited<ReturnType<typeof tools.spawn>>;
-        }
-
-        return createStreamingSubprocess([
-          { line: '--------- beginning of crash' },
-          {
-            line: '03-12 10:44:40.420 13861 13861 E AndroidRuntime: Process: com.harnessplayground, PID: 13861',
-          },
-          {
-            line: '03-12 10:44:40.421 13861 13861 E AndroidRuntime: java.lang.RuntimeException: boom',
-            delayMs: 20,
-          },
-        ]);
-      }) as typeof tools.spawn
-    );
-
-    const monitor = createAndroidAppMonitor({
-      adbId: 'emulator-5554',
-      bundleId: 'com.harnessplayground',
-      appUid: 10234,
-      crashArtifactWriter: createCrashArtifactWriter({
-        runnerName: 'android',
-        platformId: 'android',
-        rootDir: path.join(artifactRoot, '.harness', 'crash-reports'),
-        runTimestamp: '2026-03-12T11-35-08-000Z',
-      }),
-    });
-
-    await monitor.start();
-    await new Promise((resolve) => setTimeout(resolve, 10));
-
-    const details = await monitor.getCrashDetails({
-      pid: 13861,
-      occurredAt: Date.now(),
-    });
-
-    await monitor.stop();
-
-    expect(details?.artifactPath).toContain('/.harness/crash-reports/');
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    expect(fs.readFileSync(details!.artifactPath!, 'utf8')).toContain(
-      'RuntimeException: boom'
-    );
-  });
-
-  it('can be started again after timestamp lookup fails', async () => {
-    const spawnSpy = vi.spyOn(tools, 'spawn');
-    const timestampError = new Error('date failed');
-
-    spawnSpy.mockImplementation(
-      ((file: string, args?: readonly string[]) => {
-        if (file === 'adb' && args?.includes('date')) {
-          if (
-            spawnSpy.mock.calls.filter(
-              ([calledFile, calledArgs]) =>
-                calledFile === 'adb' &&
-                Array.isArray(calledArgs) &&
-                calledArgs.includes('date')
-            ).length === 1
-          ) {
-            throw timestampError;
-          }
-
-          return {
-            stdout: '03-12 11:35:08.000\n',
-          } as Awaited<ReturnType<typeof tools.spawn>>;
-        }
-
-        return createMockSubprocess();
-      }) as typeof tools.spawn
-    );
-
-    const monitor = createAndroidAppMonitor({
-      adbId: 'emulator-5554',
-      bundleId: 'com.harnessplayground',
-      appUid: 10234,
-    });
-
-    await expect(monitor.start()).rejects.toThrow(timestampError);
-    await expect(monitor.start()).resolves.toBeUndefined();
-    await monitor.stop();
-
-    expect(
-      spawnSpy.mock.calls.some(
-        ([file, args]) =>
-          file === 'adb' &&
-          Array.isArray(args) &&
-          args.includes('logcat') &&
-          args.includes('--uid=10234')
-      )
-    ).toBe(true);
-  });
-});

package/src/__tests__/environment.test.ts

@@ -1,212 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import {
-  ensureAndroidAdbAvailable,
-  ensureAndroidEmulatorAvailable,
-  getAndroidSdkRoot,
-  getAndroidSystemImagePackage,
-  getDefaultUnixAndroidSdkRoot,
-  getHostAndroidSystemImageArch,
-  getRequiredAndroidSdkPackages,
-} from '../environment.js';
-import * as tools from '@react-native-harness/tools';
-
-describe('Android environment', () => {
-  beforeEach(() => {
-    vi.restoreAllMocks();
-    vi.unstubAllEnvs();
-  });
-
-  it('skips bootstrapping command-line tools when adb is already installed', async () => {
-    const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
-    const adbPath = path.join(sdkRoot, 'platform-tools', 'adb');
-
-    fs.mkdirSync(path.dirname(adbPath), { recursive: true });
-    fs.writeFileSync(adbPath, '');
-
-    const spawnSpy = vi.spyOn(tools, 'spawn');
-
-    await expect(
-      ensureAndroidAdbAvailable({
-        env: { ANDROID_HOME: sdkRoot },
-      }),
-    ).resolves.toBe(sdkRoot);
-
-    expect(spawnSpy).not.toHaveBeenCalled();
-
-    fs.rmSync(sdkRoot, { force: true, recursive: true });
-  });
-
-  it('installs only platform-tools when adb is missing', async () => {
-    const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
-    const sdkManagerDirectory = path.join(
-      sdkRoot,
-      'cmdline-tools',
-      'latest',
-      'bin',
-    );
-
-    fs.mkdirSync(sdkManagerDirectory, { recursive: true });
-    fs.writeFileSync(path.join(sdkManagerDirectory, 'sdkmanager'), '');
-    fs.writeFileSync(path.join(sdkManagerDirectory, 'avdmanager'), '');
-
-    const spawnSpy = vi.spyOn(tools, 'spawn').mockImplementation((async (
-      command: string,
-      args?: readonly string[],
-    ) => {
-      if (command === 'bash' && typeof args?.[1] === 'string') {
-        const commandString = args[1];
-
-        if (commandString.includes('platform-tools')) {
-          const adbPath = path.join(sdkRoot, 'platform-tools', 'adb');
-          fs.mkdirSync(path.dirname(adbPath), { recursive: true });
-          fs.writeFileSync(adbPath, '');
-        }
-      }
-
-      return {} as Awaited<ReturnType<typeof tools.spawn>>;
-    }) as typeof tools.spawn);
-
-    await expect(
-      ensureAndroidAdbAvailable({
-        env: { ANDROID_HOME: sdkRoot },
-      }),
-    ).resolves.toBe(sdkRoot);
-
-    expect(spawnSpy).toHaveBeenCalledWith(
-      'bash',
-      ['-lc', expect.stringContaining('platform-tools')],
-      expect.any(Object),
-    );
-    expect(
-      spawnSpy.mock.calls.some(
-        ([command, args]) =>
-          command === 'bash' &&
-          typeof args?.[1] === 'string' &&
-          args[1].includes('platform-tools') &&
-          args[1].includes('emulator'),
-      ),
-    ).toBe(false);
-
-    fs.rmSync(sdkRoot, { force: true, recursive: true });
-  });
-
-  it('installs emulator only when emulator is missing', async () => {
-    const sdkRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'android-sdk-'));
-    const sdkManagerDirectory = path.join(
-      sdkRoot,
-      'cmdline-tools',
-      'latest',
-      'bin',
-    );
-
-    fs.mkdirSync(sdkManagerDirectory, { recursive: true });
-    fs.writeFileSync(path.join(sdkManagerDirectory, 'sdkmanager'), '');
-    fs.writeFileSync(path.join(sdkManagerDirectory, 'avdmanager'), '');
-
-    const spawnSpy = vi.spyOn(tools, 'spawn').mockImplementation((async (
-      command: string,
-      args?: readonly string[],
-    ) => {
-      if (command === 'bash' && typeof args?.[1] === 'string') {
-        const commandString = args[1];
-
-        if (commandString.includes('emulator')) {
-          const emulatorPath = path.join(sdkRoot, 'emulator', 'emulator');
-          fs.mkdirSync(path.dirname(emulatorPath), { recursive: true });
-          fs.writeFileSync(emulatorPath, '');
-        }
-      }
-
-      return {} as Awaited<ReturnType<typeof tools.spawn>>;
-    }) as typeof tools.spawn);
-
-    await expect(
-      ensureAndroidEmulatorAvailable({
-        env: { ANDROID_HOME: sdkRoot },
-      }),
-    ).resolves.toBe(sdkRoot);
-
-    expect(spawnSpy).toHaveBeenCalledWith(
-      'bash',
-      ['-lc', expect.stringContaining('emulator')],
-      expect.any(Object),
-    );
-
-    fs.rmSync(sdkRoot, { force: true, recursive: true });
-  });
-
-  it('uses the default Unix SDK root when env vars are missing', () => {
-    expect(
-      getDefaultUnixAndroidSdkRoot({
-        platform: 'darwin',
-        homeDirectory: '/Users/tester',
-      }),
-    ).toBe('/Users/tester/Library/Android/sdk');
-
-    expect(
-      getAndroidSdkRoot(
-        {},
-        {
-          platform: 'linux',
-          homeDirectory: '/home/tester',
-        },
-      ),
-    ).toBe('/home/tester/Android/Sdk');
-  });
-
-  it('prefers ANDROID_HOME and ANDROID_SDK_ROOT over default paths', () => {
-    expect(
-      getAndroidSdkRoot(
-        {
-          ANDROID_HOME: '/env/android-home',
-          ANDROID_SDK_ROOT: '/env/android-sdk-root',
-        },
-        {
-          platform: 'darwin',
-          homeDirectory: '/Users/tester',
-        },
-      ),
-    ).toBe('/env/android-home');
-
-    expect(
-      getAndroidSdkRoot(
-        {
-          ANDROID_SDK_ROOT: '/env/android-sdk-root',
-        },
-        {
-          platform: 'linux',
-          homeDirectory: '/home/tester',
-        },
-      ),
-    ).toBe('/env/android-sdk-root');
-  });
-
-  it('selects Android packages using the host architecture', () => {
-    expect(getHostAndroidSystemImageArch('x64')).toBe('x86_64');
-    expect(getHostAndroidSystemImageArch('arm64')).toBe('arm64-v8a');
-    expect(getAndroidSystemImagePackage(35, 'x86_64')).toBe(
-      'system-images;android-35;default;x86_64',
-    );
-    expect(getAndroidSystemImagePackage(35, 'arm64-v8a')).toBe(
-      'system-images;android-35;default;arm64-v8a',
-    );
-  });
-
-  it('derives emulator package requirements from runner config fields', () => {
-    expect(
-      getRequiredAndroidSdkPackages({
-        apiLevel: 34,
-        includeEmulator: true,
-        architecture: 'x86_64',
-      }),
-    ).toEqual([
-      'platform-tools',
-      'emulator',
-      'platforms;android-34',
-      'system-images;android-34;default;x86_64',
-    ]);
-  });
-});