Kanzi 3.6.6 マイグレーションガイド¶

このマイグレーションガイドを使用して、Kanzi アプリケーションを Kanzi 3.6.4 および 3.6.5 から Kanzi 3.6.6 に更新してください。

Kanzi 3.6.4および3.6.5アプリケーションをAndroidプラットフォームパッケージで使用するように移行する¶

AndroidプラットフォームパッケージはV8ライブラリをサポートしていません。Kanzi アプリケーションを移行する前に、移行したい Kanzi アプリケーションからJavaScriptを無効にするか削除してください。

Kanzi 3.6.4および3.6.5アプリケーションをAndroidプラットフォームパッケージで使用するように移行するには：

Kanzi Android プラットフォームパッケージの zip ファイルを <KanziWorkspace> ディレクトリに抽出します。zip ファイルを抽出する際には、重複するファイルを上書きせずにスキップしてください。
Kanzi アプリケーションを新しい Android プラットフォームパッケージに移行するために、<KanziWorkspace>/Engine/applications/kzb_player/configs/platforms/android_gradle ディレクトリを <ProjectName>/Application/configs/platforms ディレクトリにコピーします。
Kanzi アプリケーションで、Java リソースを編集します。
1. android_gradle/app/src/main/java/com/rightware/kanzi/kzbplayer ディレクトリで、KZBPlayer.java ファイルをアプリケーションの名前にリネームします。
  
  例えば、プロジェクト名が MyProject の場合、KZBPlayer.java ファイルを MyProject.java にリネームしてください。
2. android_gradle/app/src/main/java/com/rightware/kanzi ディレクトリ内で、kzbplayer ディレクトリをアプリケーションの小文字の名前にリネームしてください。
  
  例えば、アプリケーションが MyProject と呼ばれる場合、kzbplayer ディレクトリを myproject にリネームしてください。
3. テキストエディタで <project_name>.java ファイルを開き、アプリケーションへの参照を含めるようにファイルを編集してください。
  
  たとえば、あなたのアプリケーションが MyProject と呼ばれる場合：
  - 以下の文字列を見つけます。
    
    com.rightware.kanzi.kzbplayer
    
    終点
    
    com.rightware.kanzi.myproject
  - 以下のクラスを見つけます。
    
    KZBPlayer
    
    終点
    
    MyProject
  - TAG を変更する
    
    "KZBPlayer"
    
    終点
    
    "MyProject"
  - 以下の文字列を見つけます。
    
    Debug.startMethodTracing("kzbplayer")
    
    終点
    
    Debug.startMethodTracing("myproject")
4. テキストエディタで android_gradle/app/src/main/AndroidManifest.xml ファイルを開き、アプリケーションへの参照を含めるようにファイルを編集してください。
  
  たとえば、あなたのアプリケーションが MyProject と呼ばれる場合：
  - 以下の文字列を見つけます。
    
    com.rightware.kanzi.kzbplayer
    
    終点
    
    com.rightware.kanzi.myproject
  - 以下の文字列を見つけます。
    
    activity android:name=".KZBPlayer"
    
    終点
    
    activity android:name=".MyProject"
5. テキストエディタで android_gradle/app/src/main/res/values/strings.xml ファイルを開き、ファイルにアプリケーションの名前を含めるように編集してください。
  
  たとえば、アプリケーションが MyProject と呼ばれる場合、変更してください。
  
  <string name="app_name">KZB Player</string>
  
  終点
  
  <string name="app_name">MyProject</string>
プロジェクトでビルドスクリプトを以下のように編集します。
1. テキストエディタで android_gradle/app/CMakeLists.txt ファイルを開き、アプリケーションの名前とC++アプリケーションのソースファイルへのパスを含めるようにファイルを編集します。
  
  たとえば、あなたのアプリケーションが MyProject と呼ばれる場合：
  - 以下の文字列を見つけます。
    
    project(kzb_player)
    
    終点
    
    project(myproject)
  - 以下の文字列を見つけます。
    
    add_executable(${PROJECT_NAME} src/main/cpp/kzb_player.cpp)
    
    終点
    
    add_executable(${PROJECT_NAME} ../../../../src/myproject.cpp)
2. テキストエディタで android_gradle/settings.gradle ファイルを開き、ファイルにアプリケーションの名前を含めるように編集してください。
  
  例えば、アプリケーションが MyProject と呼ばれる場合、rootProject.name の値を "myproject" に設定します。
3. テキストエディタで android_gradle/app/build.gradle ファイルを開き、applicationId があなたのアプリケーションを指すようにファイルを編集してください。
  
  例えば、アプリケーションが MyProject と呼ばれる場合、applicationId を "com.rightware.kanzi.myproject" に設定します。
4. テキストエディタで android_gradle/gradle.properties ファイルを開き、次を置き換えます:
```
org.gradle.jvmargs=-Xmx<size>m
```
  以下に置き換えます。
```
org.gradle.jvmargs=-Xmx4608m
```

アプリケーションで C++ ソースファイルを以下のように編集します。

Application/src/<project_name>.cpp ファイルで次を変更します:

class <ProjectName>: public ExampleApplication

終点

class <ProjectName>: public Application

<project_name>.cpp ファイルに、V8Module 登録を含まない Module::registerMetadataOverride コールバックを追加します。

class <ProjectName>: public Application
{
public:
    ...

    void registerMetadataOverride(ObjectFactory& /*factory*/) override
    {
        Domain* domain = getDomain();
        KanziComponentsModule::registerModule(domain);
    }
};

Application::onConfigure コールバック関数内の <project_name>.cpp ファイルで、ExampleApplication クラスへの参照を削除します。

void onConfigure(ApplicationProperties& configuration) override
{
    Application::onConfigure(configuration);
    configuration.binaryName = "<project_name>.kzb.cfg";
    configuration.extensionOutputEnabled = true;
    configuration.defaultSurfaceProperties.antiAliasing = 0;
    configuration.defaultSurfaceProperties.bitsDepthBuffer = 0;
    configuration.defaultSurfaceProperties.bitsStencil = 0;
}

Kanzi アプリケーションを Android Studio またはコマンドラインインターフェースを使用してビルドおよびデプロイします。Android Studioから Kanzi アプリケーションをビルドしてデプロイするとコマンドラインから Kanzi アプリケーションをビルドおよびデプロイするを参照してください。

Kanzi 3.6.6 マイグレーションガイド¶

Kanzi 3.6.4および3.6.5アプリケーションをAndroidプラットフォームパッケージで使用するように移行する¶

関連項目¶