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

Installation

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:

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

applePlatform(config)

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

appleSimulator(deviceName, osVersion)

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')

applePhysicalDevice(deviceName)

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 is a group of React and React Native geeks, contact us at [email protected] 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! 🔥