使用 Package Manager Kanzi Studio 插件¶
Package Browser¶
在 Package Browser 中,您可以浏览、安装、更新和移除您的工作所依赖的包。要在 Kanzi Studio 中打开它,请选择 Package Manager > Open Package Browser。
Package Browser 包含两个窗格:
左窗格列出包,并按包的来源分为四个选项卡:Remote、Local、Project 和 Studio。
右窗格显示列表中所选包的详细信息(版本、作者、许可证、描述和依赖项(Requires)),以及用于安装或移除该包的按钮。
动作按钮的标签反映安装该包所执行的操作,这取决于包的类型:
对于 Kanzi Engine 插件,显示 Add to project / Remove from project,添加后该插件会成为当前打开工程的依赖项。
对于 Kanzi Studio 插件,显示 Add to Studio / Remove from Studio。
对于资源包,显示 Add as Asset Source / Remove。
远程¶
Remote 选项卡列出已连接的 Conan 远程仓库中可用的包,例如由 Rightware 或您的团队发布的包。从 Repository 下拉菜单中选择要浏览的仓库,并使用刷新按钮重新加载其包列表。
要添加、移除 (Remove) 或管理已配置的存储库,请展开 (Expand) Repositories 部分。请参阅 Adding remote repositories。
本地¶
Local 选项卡列出本地 Conan 缓存中的包:包括您从远程仓库下载的包和您在本地创建的包。Cache: 路径显示缓存在磁盘上的位置,刷新按钮用于重新加载列表。
在缓存下方,单独的 Editable Packages 列表显示您的可编辑包。可编辑包是指 Conan 从您计算机上的文件夹(即包含其 conanfile.py 的文件夹)解析的包,而不是从缓存中已构建的包解析。这样,磁盘上的更改无需重新构建和重新发布包即可生效。在详细信息窗格中,可编辑包标有 (Editable)。Kanzi Studio 会在插件开发期间为您创建这些条目;Package Browser 本身没有用于将包设为可编辑的控件。
工程 (Project)¶
Project 选项卡列出当前打开的 Kanzi Studio 工程的包依赖项。Packages file 栏显示该工程依赖项文件的路径,并提供一个用于在文本编辑器中打开该文件的按钮,以及一个用于重新安装工程所列全部依赖项的 Restore 按钮。
要移除依赖项,请选择该依赖项,然后在详细信息窗格中点击 Remove from project。如果移除该包会修改 Kanzi Studio 工程文件,则在应用更改之前会弹出 Package Removal 对话框,要求您确认。
Studio¶
Studio 选项卡列出为当前 Kanzi Studio 版本安装的 Kanzi Studio 插件。Kanzi Engine 插件需要添加到单个工程中,而 Kanzi Studio 插件则安装到 Kanzi Studio 本身,可用于您使用该 Kanzi Studio 版本打开的所有工程。与 Project 选项卡相同,Packages file 栏显示依赖项文件,并提供 Restore 按钮。
将包安装到工程¶
使用 Kanzi Studio 的 Package Manager 插件安装包:
选择 Remote 选项卡。在左侧面板中选择要添加到工程的包,然后在右侧面板中点击包名称下方的按钮。
Package Manager 插件根据包的类型安装包。它会将:
Kanzi Engine 插件添加为工程依赖项。
Kanzi Studio 插件添加为当前 Kanzi Studio 实例的依赖项。
资产包添加为当前 Kanzi Studio 实例的资产来源。
从工程中移除包¶
要移除:
Kanzi Engine 包,请在 Package Manager 插件的 Project 选项卡中选择要移除的包,点击 Remove from project,然后确认移除。
资产包,请在 Asset Packages 窗口中右键单击资产来源并选择 Remove。
添加远程仓库¶
您可以使用 Package Manager 插件添加、移除和管理多个 Conan 远程仓库。
要添加 Conan 远程仓库:
在 Package Manager 插件中,选择 Remote 选项卡。在 Repositories 中,点击 + Add Repository。
在 Repository Setup 窗口中,设置:
将 Repository Name 设置为您要用于标识该 Conan 仓库的名称
将 Repository Url 设置为 Conan 仓库的 URL
将 User 设置为您的 Conan 仓库用户名
将 Password 设置为您的 Conan 仓库密码
单击 OK。
Package Manager 插件会列出您所添加仓库中的包。
Package Manager 插件一次只显示一个 Conan 仓库中的包。您可以使用下拉列表在仓库之间切换。
恢复依赖项¶
工程会在其包文件中记录所依赖的包。当您打开的工程的依赖项尚不在本地 Conan 缓存中时(例如在克隆工程、在另一台计算机上检出工程或将工程迁移到较新的 Kanzi 版本之后),您可以一步重新安装全部依赖项,而无需逐个手动添加包。
要恢复当前打开工程的依赖项:
在 Package Browser 中选择 Project 选项卡。要恢复 Kanzi Studio 插件,请改为选择 Studio 选项卡。
点击 Restore。
Package Manager 会重新安装包文件中列出的每个包。
要一次性恢复当前解决方案中所有工程的依赖项,请选择 Package Manager > Restore Solution。
清除本地缓存¶
Package Manager 将其下载和构建的包保存在本地 Conan 缓存中,该缓存在 Local 选项卡上显示为 Cache: (默认为 %USERPROFILE%\.conan2\)。如果 Package Manager 开始出现异常行为(例如在安装失败之后),清除缓存会强制 Kanzi 从远程仓库重新下载这些包。
要清除缓存,请选择 Package Manager > Clear local cache…,并在 Kanzi Studio 提示时确认。这会从本地 Conan 缓存中移除所有包。
下次安装或恢复包时,Package Manager 会从已连接的远程仓库重新下载这些包。