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

创建资产包工程

要使用 Package Manager 在 Kanzi Studio 中创建资产包:

  1. 在 New Project 窗口中,从 Template 下拉菜单中选择您需要的模板来创建工程。

    ../../_images/asset-creation-template-selection.png
  2. 构建工程内容后,为您要包含在包中的资产启用 Export in Asset Package 属性。

    ../../_images/kanzi-studio-export-asset-package.png
  3. 在工程属性中启用 Is Asset Package。

    ../../_images/is-asset-package-project-property.png
  4. 保存您的工程。

  5. 在文件资源管理器中导航至工程目录的根目录,其中包含三个用于帮助创建和部署资产包的新文件:

    • conanfile.py 控制资产打包。

    • create_and_deploy.bat 是一个便捷脚本,用于运行 Conan 命令来创建资产包并将其部署到指定的 Conan 仓库。

    • README.md 是一份快速参考,介绍如何将资产包创建为 Conan 包并将其部署到远程仓库。

    ../../_images/asset-helper-scripts.png
  6. 编辑 create_and_deploy.bat:

    该脚本包含您可以根据需要修改的辅助变量。您可以更新包名称、版本以及该包所适用的 Kanzi 版本。

将资产包创建为本地 Conan 包

要创建可在本地测试的资产包:

  1. 运行 create_and_deploy.bat:

    将包部署到本地 Conan 缓存。该脚本不会将包上传到任何远程仓库。

    备注

    此脚本创建一个 Conan 包,其参考形式为 my_asset/1.0.0@kanzi-4.1.0-assets/stable。用户段 kanzi-4.1.0-assets 由 create_and_deploy.bat 中的 KANZI_VERSION 变量构成;通道 stable 是脚本的默认值。

  2. 在 Kanzi Studio 中打开 Package Manager:

    • 选择 Local 选项卡。

    • 点击刷新图标以刷新本地包列表。

    ../../_images/package-manager-repository-refresh-local.png
    • 新的资产包会显示在本地资产下。

    ../../_images/package-manager-my-asset-local.png

备注

在非 Windows 平台上,请改用 create_and_deploy.sh 脚本。

创建资产包并将其部署到远程仓库

要创建资产包并将其发布到远程仓库:

  1. 运行 create_and_deploy.bat <remote>:

    将包部署到本地 Conan 缓存,并将其上传到远程仓库 <remote>。

    备注

    此脚本创建一个 Conan 包,其参考形式为 my_asset/1.0.0@kanzi-4.1.0-assets/stable。用户段 kanzi-4.1.0-assets 由 create_and_deploy.bat 中的 KANZI_VERSION 变量构成;通道 stable 是脚本的默认值。

  2. 在 Kanzi Studio 中打开 Package Manager:

    • 选择 Remote 选项卡。

    • 在 Repository 下拉列表中,选择您部署资产包的目标仓库。

    ../../_images/package-manager-repository-dropdown.png
    • 点击刷新图标以刷新仓库列表。

    ../../_images/package-manager-repository-refresh.png
    • 新的资产包会显示在该仓库的资产下。

    ../../_images/package-manager-my-asset.png

备注

在非 Windows 平台上,请改用 create_and_deploy.sh 脚本。

另请参阅

资产包

Package Manager

使用 Package Manager Kanzi Studio 插件