Mobile: iOS

Overview

iOS app development and deployment is tightly controlled by Apple. It requires a Mac, Xcode, and an Apple developer account / membership. The free membership allows local, on-device testing. Broader testing requires the paid membership, which grants access to the App Store Connect suite of services, including deployment through the TestFlight app.

With these restrictions in place, we are unable to provide an iOS binary version of the VHToolkit sample through GitHub. Please contact us directly if you are interested in testing out the iOS version.

The iOS version of the VHToolkit uses the VHUnityURP Unity project.

Developer Setup

Requirements

• Recent iPhone
• Mac with Xcode
• Apple developer account / membership
• TestFlight app installed on your phone

Build App Manually (Xcode)

1. Unity
   1. Open the VHUnityURP Unity project on macOS machine
   2. File -> Build Settings
   3. Click iOS and then click Switch Platform
   4. Click Build and choose an empty folder
   5. When build finishes, navigate to target folder
2. Xcode
   1. Open Unity-iPhone.xcodeproj in Xcode
   2. Select the Project, Select General tab, under Build, enter the same value as CFBundleVersion above
   3. Change the Identifier to your own organization and app (the sample is set to edu.usc.ict.vhtoolkit)
   4. Build for App Store submission
      1. Product -> Archive
      2. When finished, Organizer window will appear
      3. Choose the app, ensure the Version is correct
      4. Click Distribute App
      5. When finished, it will be available on App Store Connect, under the TestFlight tab

Known Issues

• N/A