使用 Java 代码隐藏的编程活动

备注

Kanzi 仅支持 Kanzi Android framework (droidfw) 应用程序的 Java Code Behind。请参阅 使用 Kanzi Android framework (droidfw) 进行开发时。

在您可以使用 Java Code Behind 编程活动之前，确保将您的 Kanzi 开发环境设置好。请参阅 使用 Kanzi 进行 Android 应用程序开发的要求。

要使用 Java Code Behind 编程 Activities：

  1. 在 Activity Browser 中，创建您要编程的 Activity 或 Activity Host。

    例如，创建一个包含多个 Activities 的根 Exclusive Activity Host。

    ../../_images/activity-browser-create-root-eah.png ../../_images/eah-media-navigation-phone-activity-browser.png

  2. 在 Activity Browser 中，右键单击 Activity 或 Activity Host，然后选择 Add Code Behind > Java。在 Create Code Behind 对话框中，您可以设置代码背后的包名称。

    ../../_images/activity-browser-add-java-code-behind.png ../../_images/android-media-code-behind.png

    当您将 Java Code Behind 添加到 Activity 节点时，Kanzi Studio：

    1. 从 <KanziWorkspace>/Templates/Java_code_behind_template 复制 Java 后端代码。

    2. 在 <ProjectName>/Application/configs/platforms/android_gradle/<ProjectName>codebehind 目录中创建一个 Java Code Behind 模块和项目，用于您添加了 Java Code Behind 的 Activity。

    3. 编译 Java Code Behind 模块。

    4. 将包含在 Java Code Behind 模块中定义的功能的 jar 文件作为 Kanzi Engine 插件导入到 Kanzi Studio 项目中。

      ../../_images/library-java-code-behind-plugin.png

    5. 重新启动 Preview。

      当 Preview 启动时，在 Activity Browser 中，具有 Java Code Behind 的活动包含 后台代码 图标，侧面板显示在 Java Code Behind 中定义的命令。

  3. 在 Activity Browser 中，右键单击您添加了 Java Code Behind 的 Activity，然后选择 Open Code Behind > Java。

    Kanzi Studio 在 Android Studio 中打开包含 Java Code Behind 的 Android 项目。

    Java Code Behind 存储在目录 <ProjectName>/Application/configs/platforms/android_gradle/<ProjectName>codebehind 中。

    ../../_images/open-java-code-behind-solution.png

    小技巧

    在 Kanzi Studio 主菜单中，选择 File > Open Android Project in Android Studio。

    Kanzi Studio 在 Android Studio 中打开来自 <ProjectName>/Application/configs/platforms/android_gradle 目录的 Android 项目。

    ../../_images/open-project-in-android-studio.png

  4. 在 Android Studio 中的 <ProjectName><ActivityNodeName>ActivityCode.java 文件中，在 NodeComponent.attachOverride 函数中为该 Activity 节点添加初始化功能并保存文件。在 NodeComponent.attachOverride 函数中，您可以安装消息处理程序和属性监听器，创建节点，设置活动的外观和功能等。

    通过这种方式，您为该 Activity 节点提供了独特的功能，以便您可以通过代码对状态变化做出反应。

  5. 在您的项目中使用 Java Code Behind：

    1. 在 Prefabs 中，在您用于添加了 Java Code Behind 的 Activity 的预设中，创建一个 Button 或 List Box 节点，或创建一个 List Box Item Container 预设。

      例如，创建一个 Button 2D 节点。

      ../../_images/code-behind-prefabs-button.png

    2. 在 Properties 中，添加 Command 属性，并将其设置为您在 <ProjectName><ActivityNodeName>ActivityCode.java 文件中创建的命令。

      当您使用之前创建的 Button 2D 节点激活 Activity，并在 Preview 中单击该按钮时，Log 窗口将显示 MyFirstCommand 的默认消息。

      ../../_images/code-behind-properties-command.png ../../_images/code-behind-log.png

Java Code Behind 故障排除

  • 当 Java Code Behind 中的构建错误阻止 Preview 启动时，您可以在 Kanzi Studio Log 窗口中查看错误。

    在修复错误后，要重建 Java Code Behind，请在 Kanzi Studio 主菜单中，选择 Preview > Restart Preview。

    ../../_images/java-code-behind-build-error.png

  • 当您添加 Java Code Behind 并且 Java 项目对命名空间有无效的 build.gradle 定义时，Kanzi Studio 会在此对话框中列出问题。

    修复问题并点击 Refresh。

    ../../_images/java-code-behind-warning.png ../../_images/java-code-behind-warnings-resolved.png

    从 Kanzi Studio 3.9.7 开始，您可以将 Java Code Behind 添加到使用以下内容的 Kanzi Studio 项目中：

    • Android Gradle Plugin 版本 7.2.2 或更新版本

    • Gradle 版本 7.3.3 或更新版本

    请参阅 对 Java Code Behind 的更改。

使用 Java Code Behind 在 API 中

有关详细信息，请参阅 CodeBehind 类。

另请参阅

教程：构建应用程序 UI

教程：使用 C++ 代码后台编程活动