!harness-banner

[![mit licence][license-badge]][license]
[![npm downloads][npm-downloads-badge]][npm-downloads]
[![Chat][chat-badge]][chat]
[![PRs Welcome][prs-welcome-badge]][prs-welcome]

Apple platform for React Native Harness - enables testing on iOS simulators and physical devices.

Installation

``bash
npm install @react-native-harness/platform-apple


or

pnpm add @react-native-harness/platform-apple

or

yarn add @react-native-harness/platform-apple
`

Usage

Import the Apple platform functions in your rn-harness.config.mjs:

`javascript
import {
applePlatform,
applePhysicalDevice,
appleSimulator,
} from '@react-native-harness/platform-apple';

const config = {
runners: [
applePlatform({
name: 'ios',
device: appleSimulator('iPhone 16 Pro Max', '18.0'),
bundleId: 'org.reactjs.native.example.YourApp',
}),
applePlatform({
name: 'iphone-device',
device: applePhysicalDevice('iPhone (Your Name)'),
bundleId: 'com.your.app',
}),
],
// ... other config
};

export default config;
`

API

$3

Creates an Apple platform runner configuration.

Parameters:

- config.name - Unique name for the runner
- config.device - Apple device configuration (simulator or physical)
- config.bundleId - iOS application bundle ID

$3

Creates an iOS simulator device configuration.

Parameters:

- deviceName - Name of the iOS simulator (e.g., 'iPhone 16 Pro Max')
- osVersion - iOS version (e.g., '18.0')

$3

Creates a physical Apple device configuration.

Parameters:

- deviceName - Name of the physical device (e.g., 'iPhone (Your Name)')

Requirements

- macOS with Xcode installed
- iOS Simulator or physical device connected
- React Native project configured for iOS

Made with ❤️ at Callstack

react-native-harness` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at hello@callstack.com if you need any help with these or just want to say hi!

Like the project? ⚛️ Join the team who does amazing stuff for clients and drives React Native Open Source! 🔥

[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=react-native-harness&utm_term=readme-with-love
[license-badge]: https://img.shields.io/npm/l/react-native-harness?style=for-the-badge
[license]: https://github.com/callstackincubator/react-native-harness/blob/main/LICENSE
[npm-downloads-badge]: https://img.shields.io/npm/dm/react-native-harness?style=for-the-badge
[npm-downloads]: https://www.npmjs.com/package/react-native-harness
[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
[prs-welcome]: ./CONTRIBUTING.md
[chat-badge]: https://img.shields.io/discord/426714625279524876.svg?style=for-the-badge
[chat]: https://discord.gg/xgGt7KAjxv