Package Manager

Package Manager 是一个用于共享和管理可复用软件组件及资产,并支持跨平台应用程序和插件开发的工具。您可以使用它安装、更新和移除工程依赖项,例如:

  • Kanzi Engine 库和头文件

  • Kanzi Engine 插件

  • Kanzi Studio 插件

  • 资产包

备注

Package Manager 适用于 Kanzi 3.9.11 及更高版本。

安装 Package Manager

从 Kanzi Hub 下载并安装 Package Manager。

../../_images/kanzi-hub-kpm-download.png

请参阅 Kanzi Hub 和 Kanzi Account。

Package Manager 安装完成后,它已:

  • 安装 Conan 2.10.0。

  • 将 Rightware 官方 Conan 仓库 kanzi-conan-external 添加为 Conan 远程仓库。

  • 添加 Kanzi 所需的 Conan 配置文件 (profile) 和配置。

  • 为 Kanzi 3.9.11 及更高版本安装 Package Manager Kanzi Studio 插件。

安装成功后,Package Manager 将出现在 Kanzi Studio 主菜单中。

../../_images/main-menu-package-manager-open.png

Kanzi Studio 的 Package Manager 插件

Kanzi Studio 的 Package Manager 提供了用于处理 Conan 仓库和包的图形界面。使用该插件,您无需手动使用命令行指令或编辑配置文件。

支持的包类型

该插件可识别不同的包类型,并按如下方式处理:

  • Kanzi Engine 插件被添加为工程依赖项。

  • Kanzi Studio 插件被添加为当前 Kanzi Studio 实例的依赖项。

  • 资产包被添加为当前 Kanzi Studio 实例的资产源。

自动包检测

该插件会自动检测 packages.json 文件中的更改,并通知您 Kanzi Studio 工程的库需要进行哪些更新。

资产包中的 Kanzi Engine 插件

该插件允许将 Kanzi Engine 插件添加为资产包中的依赖项。这样可确保在导入此类资产时,所需的 Kanzi Engine 插件会自动添加到工程中。

基于 Conan 的 Kanzi Studio 工程模板

该插件包含一组基于 Conan 的 Kanzi Studio 工程模板。这些模板使 Kanzi Studio 能够使用基于 Conan 的包管理,让工程设置和开发更加高效、顺畅。

安装 Package Manager 后,新模板将出现在 New Project 窗口的 Template 下拉列表中。

../../_images/kanzi-studio-kpm-asset-template.png

请参阅 使用 Package Manager Kanzi Studio 插件

将工程迁移到更新的 Kanzi 版本

安装新版本的 Kanzi 后,您可以迁移工程以使用该版本。

  1. 安装更新的 Kanzi 版本。您可以将其与现有版本并行安装。

  2. 在更新的 Kanzi Studio 中打开您的工程。

  3. 如果新版本包含破坏性更改,请按照该版本的迁移指南进行操作。请参阅 发行说明和迁移指南。

当您打开使用较早版本 Kanzi Studio 创建的工程时,较新的 Kanzi Studio 会显示一个弹出窗口,要求您确认迁移该工程。确认后,Kanzi Studio 会将该工程更新到新版本。

备注

  • 如果您的工程使用 Code Behind 功能,请在较新版本的 Kanzi Studio 中打开该工程之前移除 Code Behind 插件。基于 Conan 的模板不支持 Code Behind。

  • 某些包依赖项可能要求您在迁移后更新或重新安装包。

已知问题

  • 使用基于 Conan 的 Kanzi Studio 工程模板时,不支持 Code Behind 功能。

  • 使用通过 Package Manager 提供的模板时,无法从 Kanzi Studio 将 Kanzi 应用程序部署到 Android。您可以使用 Gradle CLI 或 Android Studio 手动构建和部署应用程序。

  • Package Manager 不支持 Java 包,并且 Android 模板不包含 Java 插件模板。您可以手动添加 Java 依赖项并创建您自己的 Java 插件子工程。

  • Package Manager 安装程序目前会覆盖 Conan 缓存中的 Conan 配置文件。如果您已有与 Kanzi 所需配置文件相同的配置文件,安装 Package Manager 时这些配置文件将被覆盖。

排除问题

在某些情况下,Package Manager 安装程序可能会失败或无响应。如果发生这种情况:

  1. 清除您计算机上的 Conan 缓存,其位于 C:\Users\<admin>\.conan2\。

  2. 从 Kanzi Hub 重新安装 Package Manager。

另请参阅

使用 Package Manager Kanzi Studio 插件

使用 Package Manager 创建和部署资产包