//加载提供 Kanzi 功能的原生库，
//初始化上下文，以及分配用于渲染的 KanziView 的本机库。
//此函数调用 KanziNativeLibrary.createApplication() 函数
//加载 Kanzi 工程。
KanziView.createNativeApplication();

//停止并销毁 Kanzi 应用程序。
//此函数调用 KanziNativeLibrary.haltApplication() 和
// KanziNativeLibrary.destroyApplication() 函数。
KanziView.destroyNativeApplication();

//创建应用程序图面时，运行 Kanzi 应用程序。
KanziNativeLibrary.runApplication(holder.getSurface());

//销毁 Kanzi 应用程序图面时，暂停渲染。
KanziNativeLibrary.haltApplication();

//当 Kanzi 应用程序图面格式或大小更改时，
//调整应用程序图面的大小。
// @param width: 图面的新宽度。
// @param height: 图面的新高度。
KanziNativeLibrary.resizeEvent(width, height);

Kanzi 不使用 LifeCycle.Event.ON_PAUSE 和 Lifecycle.Event.ON_RESUME 事件，因为这两个事件不告知应用程序图面是否准备好渲染。 KanziView 分别使用 SurfaceHolder.Callback surfaceCreated() 和 surfaceDestroyed() 函数，来暂停和恢复渲染。

请参阅 https://developer.android.com/reference/androidx/lifecycle/Lifecycle.Event.html 和 https://developer.android.com/reference/android/view/SurfaceHolder.Callback 。

此图表展示了一个 Kanzi 应用程序在 Android 平台上的初始化序列。

向 Android Studio 工程添加一个 KanziView

要在您的 Android 应用程序中运行 Kanzi 应用程序，您可以向现有的 Android Studio 工程添加一个 KanziView 。

要向 Android Studio 工程添加 KanziView ，请执行以下操作：

• 从 Kanzi 应用程序的 <KanziWorkspace> / Projects / <ProjectName> / Application 目录中，复制 CMakeLists.txt 文件到 cpp 目录。
• 从 Kanzi 应用程序的 <KanziWorkspace> / Projects / <ProjectName> / Application / src 目录中，复制 <project_name>.cpp 文件到 cpp 目录。

1. 在 app / build.gradle 文件中，将 Kanzi 添加到您的 Android 工程中：

   apply plugin: 'com.rightware.gradle.kanzi'

2. 导入 Java 活动 Configuration 和 KanziView 类。
   例如，在 app / src / main / java / com / rightware / <projectname> / MainActivity.java 中添加以下代码：

   import android.content.res.Configuration;
   import com.rightware.kanzi.KanziView;

3. 在 MainActivity.java 文件中，将 Kanzi 视图添加到 MainActivity 类：

   public class MainActivity extends AppCompatActivity {
       private KanziView mView = null;
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           mView = findViewById(R.id.kanzicontent);
           mView.registerLifecycle(getLifecycle());
       @Override
       public void onConfigurationChanged(Configuration newConfig)
           super.onConfigurationChanged(newConfig);
           mView.setOrientation(newConfig.orientation);
   }

4. 在 Android 工程根目录的 build.gradle 文件中获取 Kanzi Gradle 插件，并添加作为依赖项的 Kanzi ：

   buildscript {
       apply from: 'getkanzi.gradle'
       repositories {
           google()
           jcenter()
           flatDir { dirs getKanziPlugins().toString() }
       dependencies {
           classpath 'com.android.tools.build:gradle:4.1.0'
           classpath 'com.rightware.gradle:kanzi:0.6.1'
   ...

5. 向您的 Android 应用程序内容添加 KanziView 并设置其布局。
   例如，在 app / src / main / res / layout / content_main.xml 中添加以下代码：

       <com.rightware.kanzi.KanziView
               android:id="@+id/kanzicontent"
               android:layout_width="match_parent"
               android:layout_height="wrap_content"
               android:layout_marginTop="24dp"
               app:layout_constraintBottom_toBottomOf="parent"
               app:layout_constraintEnd_toEndOf="parent"
               app:layout_constraintStart_toStartOf="parent" />

6. 在 app / build.gradle 文件中进行以下设置：
   • 将 Android 工程的资产目录设置为包含 kzb 文件的目录。
   • 将路径设置 Cmake 构建文件

   apply plugin: 'com.android.application'
   apply plugin: 'com.rightware.gradle.kanzi'
   android {
           sourceSets {
               main {
                   assets.srcDirs = [new File(rootDir, "bin")]
       externalNativeBuild {
           cmake {
               path file("$projectDir/src/main/cpp/CMakeLists.txt")
               
   在 Android Studio 主菜单中选择“生成”>“制作工程”。
   Android Studio 生成应用程序包。
   
           
   部署 Kanzi 应用程序到 Android
           
   Android API 参考