# iOS Player Build Guide

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

#### Checking SDK Compatibility

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

To do this:

1. Create a new project in Xcode (for example, “HelloWorld”).  
    <div drawio-diagram="8773"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763597755.png" alt=""/></div>
2. Try running it on your device.
3. If any warnings appear, follow the instructions until the project successfully runs on the iPhone.  
    <div drawio-diagram="8774"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763597842.png" alt=""/></div>

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

#### Generating the Project

Before generating the project:

Make sure that your **Asset.bin** file is placed in the root directory.

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.

#### Installing Player on iOS

1. Launch Xcode and open the **Player\_iOS\_64** project.  
    <div drawio-diagram="8775"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598005.png" alt=""/></div>
2. Make sure that **Developer’s iPhone** is selected as the target device.  
    <div drawio-diagram="8776"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598059.png" alt=""/></div>
3. 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.
4. Click the \[ Play \] button or select \[ Product &gt; Run \] and wait for the app to build and install and launch on the device.  
    <div drawio-diagram="8777"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598131.png" alt=""/></div>
5. Once you see the Asset running on the iPhone screen, click \[ Stop \] in Xcode and disconnect the device.

Everything should now be functioning correctly.

#### Replacing Asset.bin

To replace the Asset file:

1. Go to the project root directory.
2. Replace the existing **Asset.bin** file with your new version.

#### Troubleshooting

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

<div drawio-diagram="8780"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598374.png" alt=""/></div>

<div drawio-diagram="8781"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598415.png" alt=""/></div>

To trust the developer:

1. On the iPhone, go to \[ Settings &gt; General \].   
    <div drawio-diagram="8782"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598484.png" alt=""/></div>
2. Scroll down and open **VPN &amp; Device Management**.  
    <div drawio-diagram="8783"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598537.png" alt=""/></div>
3. Select **your account email**.  
    <div drawio-diagram="8784"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598591.png" alt=""/></div>
4. Tap **Trust** <span style="color: rgb(230, 126, 35);"><developer@example.com>.</span>  
    <div drawio-diagram="8785"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598660.png" alt=""/></div>
5. Confirm by choosing \[ Allow \], then try installing the app again.   
    <div drawio-diagram="8786"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-11/drawing-7-1763598714.png" alt=""/></div>

---