ページの先頭へ

Kanzi アプリケーションを iOS にデプロイする¶

Kanzi Studio には、Kanzi アプリケーションから Xcode プロジェクトを生成し、iOS デバイスにデプロイするためのツールが用意されています。

要件¶

Kanzi で iOS アプリケーションを開発するには、次のものが必要です。

macOS
Xcode 26.3 以降
iOS SDK 26 以降
MoltenVK を含む Vulkan SDK
CMake 3.25 以降
物理 iOS デバイスにデプロイするための Apple Developer アカウント

iOS 開発環境のセットアップの詳細については、https://developer.apple.com を参照してください。

物理 iOS デバイスにデプロイするには、アプリケーションに署名するための Apple Developer 証明書が必要です。https://developer.apple.com/support/code-signing/ を参照してください。

Xcode プロジェクトを生成する¶

Kanzi アプリケーションの Xcode プロジェクトを生成するには、次の手順を実行します。

Kanzi Studio で、プロジェクトの kzb ファイルをエクスポートします。File > Export > Export KZB を選択します。
Application フォルダを Mac 開発マシンにコピーします。
Mac 開発マシンで、KANZI_HOME 環境変数を Kanzi iOS プラットフォームパッケージのロケーションに設定します。
Application フォルダのルートで generate_cmake_xcode_ios_project.sh を実行して、Xcode プロジェクトを生成します。
```
./generate_cmake_xcode_ios_project.sh --platform device
```
注釈

スクリプトが実行可能でない場合は、先に chmod +x generate_cmake_xcode_ios_project.sh を実行します。

Xcode からビルドしてデプロイする¶

Xcode から iOS デバイスに Kanzi アプリケーションをビルドしてデプロイするには:

USB ケーブルを使用して、iOS デバイスを Mac 開発マシンに接続します。
build_ios フォルダから、生成された Xcode プロジェクトを開きます。
Xcode で、Apple Developer 証明書のコード署名を設定します。Apple のコード署名を参照してください。
Run をクリックして、アプリケーションをビルドしてデプロイします。

コマンドラインからビルドしてデプロイする¶

コマンドラインから iOS デバイスに Kanzi アプリケーションをビルドしてデプロイするには:

USB ケーブルを使用して、iOS デバイスを Mac 開発マシンに接続します。
Application フォルダから、アプリケーションをビルドして output フォルダにインストールします:
```
xcodebuild -project build_ios/<ApplicationName>_ios.xcodeproj \
    -scheme <ApplicationName> -configuration Release \
    -destination 'generic/platform=iOS' \
    DEVELOPMENT_TEAM=<YourTeamID> \
    'DSTROOT=$(PROJECT_DIR)' \
    install
```
<YourTeamID> を Apple Developer のチーム ID に置き換えます。チーム ID は、Apple Developer アカウントの Membership details で確認できます。

xcodebuild は、ビルドしたアプリケーションを output/<ApplicationName>.app に配置します。

ヒント

既存のプロビジョニングプロファイルがない場合は、xcodebuild コマンドに -allowProvisioningUpdates を追加して、プロビジョニングプロファイルが自動的に作成されるようにします。
接続したデバイスの識別子を確認します:
```
xcrun devicectl list devices
```

デバイスにアプリケーションをインストールします:

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

デバイスでアプリケーションを起動します:
```
xcrun devicectl device process launch \
    --console \
    --device <DeviceIdentifier> \
    <BundleIdentifier>
```
注釈

--console オプションを指定すると、iOS アプリケーションのログが macOS ターミナルに出力されます。

<BundleIdentifier> はアプリケーションのバンドル ID で、通常は com.company-name.app-name の形式です。例: com.rightware.kanzi.basicapplication。

関連項目¶

Kanzi アプリケーションのデプロイ

Kanzi アプリケーションを iOS 向けに開発する

kzbファイルの使用