iOS Player Build Guide

Before you begin, it’s recommended to prepare and verify the connection between your Mac and your iPhone.

First, make sure that the SDK version in Xcode is compatible with your iPhone’s iOS version.

To do this:

Create a new project in Xcode (for example, “HelloWorld”).
Try running it on your device.
If any warnings appear, follow the instructions until the project successfully runs on the iPhone.

This step ensures that your device pairing, certificates, and accounts are set up correctly.

Go to the directory where you downloaded your client and create a folder named build.
Ensure that CMake is installed, then run:

cmake \
  -G Xcode \
  -DCMAKE_TOOLCHAIN_FILE=../cgi_studio_devices/src/iOS/Toolchain_Files/GCC-toolchain-iOS-Device.txt \
  ../cmake/Candera/Player

After the project is generated, open Xcode and load the created project.

Launch Xcode and open the Player_iOS_64 project.
Make sure that Developer’s iPhone is selected as the target device.
If something else is selected, click on the device selector and choose the correct iPhone.
If your iPhone does not appear, disconnect and reconnect the USB cable.
Click the [ Play ] button or select [ Product -> Run ] and wait for the app to build and install and launch on the device.
Once you see the Asset running on the iPhone screen, click [ Stop ] in Xcode and disconnect the device.

Everything should now be functioning correctly.

To replace the Asset file:

In the Xcode project, navigate to:
Player/AppPlatform/Target_iOS_ARM
Locate Asset.bin.
Right-click it and select Show in Finder to open the original file location.
Replace the existing file with your version of Asset.bin.

If an error appears during installation, it may indicate that your developer account needs to be trusted on the iPhone.

To trust the developer: