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 文件时，跳过重复文件，而不是覆盖这些文件。
将 <KanziWorkspace>/Engine/applications/kzb_player/configs/platforms/android_gradle 目录复制到您要迁移到新的 Android 平台包的 Kanzi 应用程序的 <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
    
    至 (To)
    
    com.rightware.kanzi.myproject
  - 更改类
    
    KZBPlayer
    
    至 (To)
    
    MyProject
  - 更改 TAG。
    
    "KZBPlayer"
    
    至 (To)
    
    "MyProject"
  - 更改
    
    Debug.startMethodTracing("kzbplayer")
    
    至 (To)
    
    Debug.startMethodTracing("myproject")
4. 在文本编辑器中打开 android_gradle/app/src/main/AndroidManifest.xml 文件，并编辑该文件以包含对您的应用程序的引用。
  
  例如，如果您应用程序的名称是 MyProject：
  - 更改
    
    com.rightware.kanzi.kzbplayer
    
    至 (To)
    
    com.rightware.kanzi.myproject
  - 更改
    
    activity android:name=".KZBPlayer"
    
    至 (To)
    
    activity android:name=".MyProject"
5. 在文本编辑器中打开 android_gradle/app/src/main/res/values/strings.xml 文件，并编辑该文件以包含您的应用程序名称。
  
  例如，如果您应用程序的名称是 MyProject，请更改
  
  <string name="app_name">KZB Player</string>
  
  至 (To)
  
  <string name="app_name">MyProject</string>
在工程中，编辑创建脚本：
1. 在文本编辑器中打开 android_gradle/app/CMakeLists.txt 文件，并编辑该文件以包含您的应用程序名称和 C++ 应用程序源文件的路径。
  
  例如，如果您应用程序的名称是 MyProject：
  - 更改
    
    project(kzb_player)
    
    至 (To)
    
    project(myproject)
  - 更改
    
    add_executable(${PROJECT_NAME} src/main/cpp/kzb_player.cpp)
    
    至 (To)
    
    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

至 (To)

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);
    }
};

在 <project_name>.cpp 文件中的 Application::onConfigure 回调函数中，删除对 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;
}

使用 Android Studio 或命令行界面构建和部署您的 Kanzi 应用程序。请参阅从 Android Studio 构建和部署 Kanzi 应用程序。和从命令行构建和部署 Kanzi 应用程序。

另请参阅¶

Kanzi 3.6.6 发行说明

已知问题