mirror of
https://github.com/callstack/agent-device.git
synced 2026-09-14 20:06:34 +08:00
d5cbec08fc
* perf: speed up apple ci jobs * chore: address ci review feedback * chore: unify apple runner build scripts
1.3 KiB
1.3 KiB
Contributing
Thanks for your interest in contributing to agent-device.
Development
Requirements:
- Node.js 22+
- pnpm
- Android SDK tools (
adb) for Android support - Xcode (
simctl/devicectl) for iOS support
Setup:
pnpm install
Build all CLIs and Xcode projects:
pnpm build:all
Apple XCTest builds now share a common helper script. pnpm build:xcuitest:ios and
pnpm build:xcuitest:tvos keep their existing cleanup behavior, while
pnpm build:xcuitest:macos reuses the existing DerivedData by default for faster local
iteration. Set AGENT_DEVICE_IOS_CLEAN_DERIVED=1 when you need a clean macOS runner rebuild.
Run tests:
pnpm test
Optional device selectors for tests:
ANDROID_DEVICE=Pixel_9_Pro_XLorANDROID_SERIAL=emulator-5554IOS_DEVICE="iPhone 17 Pro"orIOS_UDID=<udid>
Guidelines
- Keep dependencies minimal.
- Preserve the CLI’s agent-friendly JSON output.
- Ensure tests open and close sessions explicitly.
- Add/adjust integration tests when introducing new commands.
- Prefer built-in Node APIs over new packages.
Reporting issues
Please include:
- OS and Node version
- Xcode/Android SDK versions (if relevant)
- Exact command and output
Thanks for helping improve agent-device.