Kanzi を使用した Android アプリケーション開発の要件

Android向けの Kanzi アプリケーションを開発する際には、Android Studio、Clangツールチェーン、およびGradleビルドシステムを使用できます。この開発アプローチは以下でテストされています。

  • Ubuntu/Linux 18.04.1

  • Windows 10

Kanzi で Android アプリケーションを開発するには、Android Studio が必要です。Android Studio は https://developer.android.com/studio からダウンロードできます。使用できる Android Studio のバージョンは、プロジェクトで使用する Android Gradle プラグインのバージョンによって異なります。https://developer.android.com/studio/releases#android_gradle_plugin_and_android_studio_compatibility を参照してください。

Android デバイスへのプロジェクトのデプロイや Java Kanzi Engine プラグインのインポートなど、Kanzi Studio で Android の機能を使用するには、64 ビットの JDK 17 が必要です。Kanzi Studio 用のAndroid環境のセットアップ を参照してください。

これらのツールの他のバージョンを使用する場合は、プロジェクトを手動で調整する必要があります。より新しいツールを使用する例については、Jetpack Compose の例 を参照してください。

Kanzi にはさまざまな Android 統合オプションがあり、それぞれに独自の要件があります。Kanzi アプリケーションをAndroid向けに開発する を参照してください。

Kanzi Android framework (droidfw)

Kanzi Android framework (droidfw) での開発 を参照してください。

Kanzi Android framework (droidfw) の要件は以下のとおりです。

  • Android API 26 以上

  • Android 8 以上

  • Java 言語レベル 8 (1.8) 以上

  • NDK 21.3.6528147

Kanzi Android framework (droidfw) テンプレートは以下と互換性があります。

  • Gradle 7.6.2

  • Android Gradle プラグイン 7.4.2

  • JDK 17。プロジェクト設定で JDK を JDK 17 に設定する必要があります。JDKのインストール を参照してください。

  • CMake 3.10.2.4988404

Kanzi application framework (appfw)

Kanzi application framework (appfw) を使用した Android 向け開発 を参照してください。

Kanzi application framework (appfw) の要件:

  • Android API 21 以上

  • Android 5 以上

  • Java 言語レベル 7 (1.7) 以上

  • NDK 21.3.6528147

Kanzi application framework (appfw) テンプレートは以下と互換性があります。

  • Gradle 7.6.2

  • Android Gradle プラグイン 7.4.2

  • JDK 17。プロジェクト設定で JDK を JDK 17 に設定する必要があります。JDKのインストール を参照してください。

  • CMake 3.10.2.4988404

Kanzi Android Service

Kanzi Android Service での開発 を参照してください。

Kanzi Android Service の要件:

  • Android API 29 以上

  • Android 10 以上

  • Java 言語レベル 11 (11) 以上

  • NDK 21.3.6528147

Kanzi Android Service テンプレートは以下と互換性があります。

  • Gradle 8.7

  • Android Gradle プラグイン 8.6.0

  • JDK 17。プロジェクト設定で JDK を JDK 17 に設定する必要があります。JDKのインストール を参照してください。

  • CMake 3.10.2.4988404

OpenGL ESの要件

OpenGL ES API レベルが 2.0 より高いアプリケーションを Android エミュレーターにデプロイするには、Android エミュレーターで OpenGL ES 3.0 を有効にします。AndroidエミュレーターでOpenGL ES 3.0を有効にする を参照してください。

Android Studio環境のセットアップ

JDKのインストール

Android StudioにはJDKが付属しており、通常は C:\Program Files\Android\Android Studio\jbr または C:\Users\<user>\AppData\Local\Programs\Android Studio\jbr にインストールされます。

組み込みのJDKのバージョンはAndroid Studioのバージョンによって異なり、プロジェクトのGradleツールと互換性がない場合があります。Kanzi を使用した Android アプリケーション開発のトラブルシューティング を参照してください。

特定のバージョンのJDKをインストールして、特定のAndroid Studioプロジェクトで使用するには:

  1. Android Studioで、Kanzi プロジェクトのAndroidアプリケーションを開きます。

  2. メインメニューで、File > Settings を選択します。

  3. Settings ウィンドウで、Build, Execution, Deployment > Build Tools > Gradle を選択し、Gradle JDK を Download JDK に設定します。

  4. Download JDK ウィンドウで、次を設定します。

    • Version を使用するバージョンに設定します。Kanzi のAndroidテンプレートは JDK 17 と互換性があります。

    • Vendor を信頼できるソースに設定します。例えば、Eclipse Temurin (AdoptOpenJDK Hotspot) です。

    Download をクリックします。

  5. プロジェクトをGradleと同期します。

ネイティブビルドツールのインストール

Android Studio用のネイティブビルドツールをインストールするには:

  1. Android Studioの Welcome 画面で、More Actions > SDK Manager を選択します。

  2. SDK Manager ウィンドウの SDK Tools タブで、次を選択します。

    • NDK 21.3.6528147

    • CMake 3.10.2.4988404

    OK をクリックします。

Kanzi Studio 用のAndroid環境のセットアップ

Kanzi Studio でAndroidおよびJavaの機能を使用するには、Kanzi Studio 用のAndroid環境をセットアップする必要があります。

Kanzi Studio 用のAndroid環境をセットアップするには:

  1. Kanzi Studio のメインメニューで Edit > User Preferences を選択し、Advanced タブで Open Build Environment Configuration をクリックします。

    ../../_images/open-build-environment-configuration.png

  2. Build Environment Configuration ダイアログで、これらの環境変数が正しく設定されていることを確認してください。

    • ANDROID_HOME をAndroid SDKのインストール場所に設定

      例えば、C:\Users\<user>\AppData\Local\Android\Sdk。

    • （オプション） ANDROID_STUDIO をAndroid Studioのインストール場所に設定

      Kanzi Studio は、この環境変数を使用して、Android Studio で Android 用の Kanzi アプリケーションを開きます。たとえば、Activity Browser から Code Behind ソースを開くときです。

      設定されていない場合、Kanzi Studio は C:\Program Files\Android\Android Studio\bin\studio64.exe で Android Studio を探します。

    • JAVA_HOME を64ビット版 JDK 17 のインストール場所に設定

      Android Studio と一緒にインストールした JDK を使用できます。JDK のインストール を参照してください。

      または、スタンドアロンの JDK をインストールすることもできます。例えば、https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.8.1%2B1/OpenJDK17U-jdk_x64_windows_hotspot_17.0.8.1_1.zip からインストールできます。

    Kanzi Studio は環境変数を %ProgramData%\Rightware\<KanziVersion>\kanzi_environment_variables.bat ファイルに保存します。Kanzi Command Prompt はこのファイルに設定された環境変数を使用します。Kanzi Command Prompt を使用する を参照してください。

Kanzi の Android ビルドプロセス

この図は、Kanzi が Android パッケージをビルドする際に使用するプロセスを示しています。

../../_images/gradle-build.svg