Deploying Kanzi applications to iOS¶

Kanzi Studio provides tools to generate an Xcode project from your Kanzi application and deploy it to an iOS device.

Requirements¶

To develop iOS applications with Kanzi, you need:

For more information about setting up the environment for iOS development, see https://developer.apple.com.

To deploy to a physical iOS device, you need an Apple Developer certificate to sign the application. See https://developer.apple.com/support/code-signing/.

To generate the Xcode project for your Kanzi application:

In Kanzi Studio, export the kzb file of your project. Select File > Export > Export KZB.
Copy the Application folder to your Mac development machine.
On your Mac development machine, set the KANZI_HOME environment variable to the location of your Kanzi iOS platform package.
From the root of the Application folder, run generate_cmake_xcode_ios_project.sh to generate the Xcode project:
```
./generate_cmake_xcode_ios_project.sh --platform device
```
Note

If the script is not executable, run chmod +x generate_cmake_xcode_ios_project.sh first.

To build and deploy a Kanzi application to an iOS device from Xcode:

Connect your iOS device to your Mac development machine with a USB cable.
Open the generated Xcode project from the build_ios folder.
In Xcode, set up code signing for your Apple Developer certificate. See Apple code signing.
Click Run to build and deploy the application.

To build and deploy a Kanzi application to an iOS device from the command line:

Connect your iOS device to your Mac development machine with a USB cable.
From the Application folder, build and install the application to the output folder:
```
xcodebuild -project build_ios/<ApplicationName>_ios.xcodeproj \
    -scheme <ApplicationName> -configuration Release \
    -destination 'generic/platform=iOS' \
    DEVELOPMENT_TEAM=<YourTeamID> \
    'DSTROOT=$(PROJECT_DIR)' \
    install
```
Replace <YourTeamID> with your Apple Developer Team ID. You can find your Team ID in your Apple Developer account under Membership details.

xcodebuild places the built application in output/<ApplicationName>.app.

Tip

If you do not have an existing provisioning profile, add -allowProvisioningUpdates to the xcodebuild command to allow it to automatically create one.
Find the identifier of your connected device:
```
xcrun devicectl list devices
```

Install the application on the device:

xcrun devicectl device install app \
    --device <DeviceIdentifier> \
    output/<ApplicationName>.app