发布软件包
Last updated
Last updated
软件包是一种用于存储节点并与 Dynamo 社区共享节点的便捷方式。软件包可以包含从在 Dynamo 工作空间中创建的自定义节点到 NodeModel 派生节点等的所有内容。发布和安装软件包使用的是软件包管理器。除了此页面，Primer 还提供了有关软件包的常规手册。
Dynamo Package Manager 是一个软件注册表（类似于 npm），可以从 Dynamo 或 Web 浏览器中访问。软件包管理器包括安装、发布、更新和查看软件包。与 npm 一样，它会维护不同版本的软件包。它还有助于管理项目的依赖关系。
在浏览器中，搜索软件包并查看统计信息：https://dynamopackages.com/
在 Dynamo 中，软件包管理器包括安装、发布和更新软件包。
联机搜索软件包：
Packages > Search for a Package...查看/编辑已安装的软件包：
Packages > Manage Packages...发布新软件包：
Packages > Publish New Package...
软件包是从 Dynamo 内的软件包管理器发布的。建议的过程是本地发布、测试软件包，然后联机发布以与社区共享。通过使用 NodeModel 案例研究，我们将完成本地发布 RectangularGrid 节点为软件包和联机发布的必要步骤。
启动 Dynamo，然后选择 Packages > Publish New Package... 以打开 Publish a Package 窗口。
选择
Add file...以浏览要添加到软件包的文件从 NodeModel 案例研究中选择两个
.dll文件选择
Ok
在将文件添加到软件包内容中后，为软件包指定名称、描述和版本。使用 Dynamo 发布软件包会自动创建 pkg.json 文件。
准备好发布的软件包。
提供所需的名称、描述和版本信息。
通过单击“本地发布”进行发布，然后选择 Dynamo 的软件包文件夹“
AppData\Roaming\Dynamo\Dynamo Core\1.3\packages”以使节点在核心中可用。始终本地发布，直到软件包准备好共享。
发布软件包后，节点将在 Dynamo 库中的 CustomNodeModel 类别下可用。
我们刚刚在 Dynamo 库中创建的软件包
在软件包准备好联机发布后，打开软件包管理器、选择 Publish，然后选择 Publish Online。
要查看 Dynamo 如何设置软件包的格式，请单击“CustomNodeModel”右侧的三个垂直点，然后选择“显示根目录”
在“发布 Dynamo 软件包”窗口中，选择
Publish，然后选择Publish Online。要删除软件包，请选择
Delete。
更新软件包的过程与发布过程类似。打开软件包管理器、在需要更新的软件包上选择 Publish Version...，然后输入更高版本。
选择
Publish Version以使用根目录中的新文件更新现有软件包，然后选择它应本地发布还是联机发布。
软件包管理器 Web 客户端允许用户搜索和查看软件包数据，包括版本控制、下载统计信息和其他相关信息。此外，软件包作者可以直接通过 Web 客户端登录以更新其软件包详细信息，例如兼容性信息。
有关这些功能的详细信息，请参阅此处的博客帖子：https://dynamobim.org/discover-the-new-dynamo-package-management-experience/。
可以通过以下链接访问软件包管理器 Web 客户端：https://dynamopackages.com/
更新软件包详细信息
作者可以按照以下步骤编辑其软件包说明、网站链接和存储库链接：
在**“我的软件包”下，选择软件包，然后单击“编辑软件包详细信息”**。
使用各自的字段添加或修改网站和存储库链接。
根据需要更新**“软件包说明”**。
单击**“保存更改”**以应用更新。
注意：由于服务器更新需要一些时间，因此更新可能需要长达 15 分钟才能在 Dynamo 内的软件包管理器中刷新。正在努力减少这种延误。
编辑已发布软件包版本的兼容性信息
兼容性信息可以针对以前发布的软件包版本进行追溯更新。请遵循下列步骤：
第 1 步：
单击要更新的软件包版本。
依赖于列表将自动填充您的软件包所依赖的软件包。
单击**“兼容性”旁边的铅笔图标以打开“编辑兼容性信息”**工作流。
第 2 步：
请按照流程图并参考下表，帮助您了解哪个选项最适合您的软件包。
让我们使用一些示例来演练一些方案：
示例软件包 # 1 - Civil 连接：此软件包与 Revit 和 Civil 3D 都有 API 依存关系，并且不包括核心节点的集合（例如：几何函数、数学函数和/或列表管理）。因此，在这种情况下，理想的选择是使用选项 1。该软件包在 Revit 和 Civil 3D 中将显示为兼容，与版本范围和/或单个版本列表匹配。
示例软件包 # 2 - Rhythm：此软件包是 Revit 特定节点以及核心节点的集合。在这种情况下，软件包具有主机依存关系。但还包括将在 Dynamo Core 中工作的核心节点。因此，在这种情况下，理想的选择是选项 2。该软件包在与版本范围和/或单个版本列表匹配的 Revit 和 Dynamo Core（也称为 Dynamo Sandbox）环境中将显示为“兼容”。
示例软件包 # 3 - Mesh Toolkit：此软件包是 Dynamo Core 软件包，它是不依赖于主机的几何图形节点的集合。因此，在这种情况下，理想的选择是选项 3。该软件包在 Dynamo 和所有与版本范围和/或单个版本列表匹配的主机环境中将显示为“兼容”。
根据选定的选项，将弹出 Dynamo 和/或主机特定字段，如下图所示。
