country_code

Client Setup - macOS & Swift#

The client setup is done a Apple Silicon based Mac (macOS) and an Apple Vision Pro device (visionOS).

Requirements#

  1. Click Here to create your Apple developer account.

  2. Your developer account and signing profiles need to be set up in Xcode before deploying to a device.

  3. Next you’ll set up your developer account and signing profiles in Xcode. Additionally, your developer account needs to be trusted by your device. This is required for deploying to device.

In the Apple Vision Pro headset, if you see the prompt below:

_images/trust-account.png

Navigate to the settings app and trust the certificate of your developer account:

_images/trust-cert.png

  1. Download Xcode 16.4 here

    Note

    Be sure to install the visionOS & iPadOS platforms when prompted to add run destinations.

  2. macOS Sonoma or later needs to be installed.

  3. You need a network connection to the Windows machine running Omniverse as set up above.

Clone the Repository#

  1. Choose a folder on your local machine to install the repository.

  2. Open a new terminal window.

  3. Navigate to the folder where you want to store your repository

  4. Clone the github repository.

git clone git@github.com:NVIDIA-Omniverse/apple-configurator-sample.git

Set Up the Client#

Now you’ll set up a client that communicates with Omniverse. Our sample client is designed specifically to communicate with the Purse USD dataset included in the workflow example. It contains custom thumbnails, text, variantSet and variant names, all tailored for the Purse. It has the needed CloudXR Framework components to communicate with Omniverse, making it quick to build and test our end to end workflow.

  1. Open the Configurator.xcodeproject to launch XCode. We’ll need to adjust some default profile settings of our project before building.

  2. Select the Project Navigator tab and select the top level Configurator object. #. Change to the Signing & Capabilities Tab #. Change Team to your own team. #. Change the Bundle Identifier to a new unique name, such as com.developername.purse-config.

  3. Navigate to Product > Destination and change the target device to the Vision Pro Simulator.

    1. For iPad Pro you can add an iPad Pro 13” Simulator.

    2. There are two build targets in the project, one for Vision Pro and one for iPad Pro - labeled as iOS. Choose the appropriate device you’re developing for.

    3. _images/build_target.png

  4. Once you’ve selected your target, press the Play button to build and run the client.

After a few moments the Simulator should open and the client will launch inside the visionOS or iPad OS Simulator window. If you’re greeted with the Connection Setup window, then you’re almost ready to try connecting to Omniverse!

_images/sim-launch.png

Or on the iPad Pro:

_images/sim-launch-ipad.png

  1. Ensure that Select Zone is set to Manual IP-Address.

  2. Ensure that Select Application is set to Purse Configurator.

In the next section, you’ll ensure that you can connect to Omniverse by checking if your server is running on your Windows machine.

Connecting to the Omniverse Server#

Back on our Windows machine with Omniverse:

  1. Initiate the Server: Follow the steps outlined in the “Set Up Omniverse SDK” section to start the server and retrieve the server IP address.

  2. Over in the XCode Simulator, change Select Zone to Manual IP-Address.

  3. Enter the IP address of your Omniverse server.

  4. Click Connect.

After a few moments, you should see the Purse stage being rendered inside a Portal window in Vision Pro:

_images/sim-run.png

Or in AR mode on the iPad Pro:

_images/sim-run-ipad.png

If so, congratulations, you’ve completed your first end to end test of the client and server!