[build-tools] Add Appium sessions on a warm Simulator

.changeset/prepared-appium-session.md

@@ -0,0 +1,6 @@
+---
+'@expo/simulator-launcher': minor
+'@expo/build-tools': minor
+---
+
+Add a warm Appium session step, `eas/start_warm_appium_remote_session`, that claims the warm Simulator and its serve-sim, then sets up Appium and WDA for the job. An Appium claim waits for the unused tools to stop, so WDA does not share the Simulator with the agent-device runner. The step waits for Appium setup to finish before it stops warmup.

packages/build-tools/src/steps/__tests__/warmFunctions.test.ts

@@ -3,7 +3,7 @@ import { getEasFunctions } from '../easFunctions';
 
 it('registers separate opt-in session functions with the existing inputs', () => {
   const functions = getEasFunctions({ hasBuildJob: () => false } as CustomBuildContext);
-  for (const name of ['serve_sim_remote', 'agent_device', 'argent_remote']) {
+  for (const name of ['serve_sim_remote', 'agent_device', 'argent_remote', 'appium_remote']) {
     const existing = functions.find(fn => fn.id === `start_${name}_session`)!;
     const warm = functions.find(fn => fn.id === `start_warm_${name}_session`)!;
     expect(warm.getFullId()).toBe(`eas/start_warm_${name}_session`);

packages/build-tools/src/steps/easFunctions.ts

@@ -57,7 +57,10 @@ import {
 } from './functions/startWarmIosSimulatorSession';
 import { createStartAndroidEmulatorBuildFunction } from './functions/startAndroidEmulator';
 import { createStartArgentRemoteSessionBuildFunction } from './functions/startArgentRemoteSession';
-import { createStartAppiumRemoteSessionBuildFunction } from './functions/startAppiumRemoteSession';
+import {
+  createStartAppiumRemoteSessionBuildFunction,
+  createStartWarmAppiumRemoteSessionBuildFunction,
+} from './functions/startAppiumRemoteSession';
 import { createStartCuttlefishDeviceBuildFunction } from './functions/startCuttlefishDevice';
 import { createStartIosSimulatorBuildFunction } from './functions/startIosSimulator';
 import { createStartIosSimulatorRecordingsBuildFunction } from './functions/startIosSimulatorRecordings';
@@ -120,6 +123,7 @@ export function getEasFunctions(ctx: CustomBuildContext): BuildFunction[] {
     createStartArgentRemoteSessionBuildFunction(ctx),
     createStartWarmArgentRemoteSessionBuildFunction(ctx),
     createStartAppiumRemoteSessionBuildFunction(ctx),
+    createStartWarmAppiumRemoteSessionBuildFunction(ctx),
     createStartAndroidEmulatorBuildFunction(),
     createStartCuttlefishDeviceBuildFunction(),
     createStartIosSimulatorBuildFunction(),