# 为 Dynamo 开发
无论用户的经验水平如何，Dynamo 平台是专为所有用户设计的，旨在使他们都能够成为参与者。有多个针对不同能力和技能水平的开发选项，每个选项都有其优势和劣势，具体取决于目标。下面，我们将概述不同的选项以及如何选择其中一个。
> 三种开发环境：Visual Studio、Python 编辑器和代码块 DesignScript
### 我有哪些选项？
Dynamo 的开发选项主要分为两类：*for*（面向）Dynamo 与 *in*（使用）Dynamo。可以将这两个类别视为如下所述：“in”Dynamo 表示使用 Dynamo IDE 创建要在 Dynamo 中使用的内容，而“for”Dynamo 表示使用外部工具创建要输入到 Dynamo 中以供使用的内容。尽管本手册重点介绍 *for* Dynamo 开发，但下面介绍了适用于所有过程的资源。
### For（面向）Dynamo
这些节点允许最高程度的自定义。许多软件包都是使用此方法构建的，它对于参与 Dynamo 的源代码而言必不可少。本手册将介绍构建这些软件包的过程。
* Zero-Touch 节点
* NodeModel 派生节点
* 扩展
> 本 Primer 提供了有关[输入 Zero-Touch 库](https://primer2.dynamobim.org/6_custom_nodes_and_packages/6-2_packages/5-zero-touch)的指南。
在下面的讨论中，Visual Studio 将用作 Zero-Touch 和 NodeModel 节点的开发环境。
> 我们将要开发的项目的 Visual Studio 界面
### In（使用）Dynamo
尽管这些过程存在于可视化编程工作空间中并且相对简单，但它们都是用于自定义 Dynamo 的可行选项。本 Primer 涵盖了这些内容，并在[脚本编写策略](/zh-cn/9_best_practices/2-scripting-strategies.md)一章中提供了脚本编写技巧和最佳实践。
* 代码块会在可视化编程环境中显示 DesignScript，从而支持灵活的文本脚本和节点工作流。代码块中的函数可由工作空间中的任何对象调用。
> 下载代码块示例（单击鼠标右键，然后单击“另存为”），或在 [Primer](https://primer.dynamobim.org/07_Code-Block/7-1_what-is-a-code-block.html) 中查看详细漫游。
* 自定义节点是节点集合甚至整个图形的容器。它们是收集常用例程并与社区共享这些例程的有效方式。
> 下载自定义节点示例（单击鼠标右键，然后单击“另存为”），或在 [Primer](https://primer.dynamobim.org/10_Custom-Nodes/10-1_Introduction.html) 中查看详细漫游。
* Python 节点是可视化编程工作空间中的脚本接口，类似于代码块。Autodesk.DesignScript 库使用与 DesignScript 类似的点表示法。
> 下载 Python 节点示例（单击鼠标右键，然后单击“另存为”），或在 [Primer](https://primer.dynamobim.org/10_Custom-Nodes/10-4_Python.html) 中查看详细漫游。
在 Dynamo 工作空间中开发是获得即时反馈的强大工具。
> 在 Dynamo 工作空间中使用 Python 节点开发
### 每种方法有哪些优点/缺点？
Dynamo 的开发选项旨在解决自定义需求的复杂性。无论目标是在 Python 中编写递归脚本还是构建完全自定义的节点 UI，都有一些选项可用于实现仅涉及启动和运行所需内容的代码。
**Dynamo 中的代码块、Python 节点和自定义节点**
这些都是用于在 Dynamo 可视化编程环境中编写代码的简单选项。通过 Dynamo 可视化编程工作空间，可访问 Python、DesignScript，还可以在自定义节点内包含多个节点。
使用这些方法，我们可以：
* 开始编写 Python 或 DesignScript，而几乎无需设置。
* 将 Python 库输入到 Dynamo 中。
* 将代码块、Python 节点和自定义节点作为软件包的一部分与 Dynamo 社区共享。
**Zero-Touch 节点**
“Zero-Touch”是指一种用于输入 C# 库的简单点击方法。Dynamo 将读取 `.dll` 的公有方法，并将这些方法转换为 Dynamo 节点。可以使用 Zero-Touch 来开发您自己的自定义节点和软件包。
使用此方法，我们可以：
* 输入一个不一定是为 Dynamo 开发的库，并自动创建一组新节点（如本 Primer 中的 [A-Forge 示例](/zh-cn/6_custom_nodes_and_packages/6-2_packages/5-zero-touch.md#case-study-importing-aforge)）
* 编写 C# 方法，并在 Dynamo 中轻松将这些方法用作节点
* 通过软件包将 C# 库作为节点与 Dynamo 社区共享
**NodeModel 派生节点**
通过这些节点，可以更深入地了解 Dynamo 的结构。它们基于 `NodeModel` 类，并使用 C# 编写。尽管此方法提供了最大的灵活性和强大功能，但节点的大多数方面都必须明确定义，并且函数需要位于单独的程序集中。
使用此方法，我们可以：
* 使用滑块、图像、颜色等创建完全可自定义的节点 UI（例如 ColorRange 节点）
* 访问并影响 Dynamo 画布中发生的情况
* 自定义连缀
* 作为软件包载入到 Dynamo 中
### 了解 Dynamo 版本控制和 API 更改 (1.x → 2.x)
由于 Dynamo 会定期更新，因此可能会对软件包使用的 API 的一部分进行更改。跟踪这些更改对于确保现有软件包继续正常工作而言非常重要。
API 更改是在 [Dynamo GitHub Wiki](https://github.com/DynamoDS/Dynamo/wiki/API-Changes) 上进行跟踪的。这包括对 DynamoCore、库和工作空间的更改。
举例来说，2.0 版中即将发生的重大更改是从 XML 文件格式转换为 JSON 文件格式。NodeModel 派生节点现在需要 [JSON 构造函数](https://github.com/DynamoDS/Dynamo/wiki/Write-a-Json-Constructor-for-a-NodeModel-Node)，否则它们将无法在 Dynamo 2.0 中打开。
Dynamo 的 API 文档目前涵盖了核心功能：
### 在软件包中分发二进制文件的权限
请注意，.dll 包含在要上传到软件包管理器的软件包中。如果软件包作者未创建 .dll，则他们必须有权共享它。
如果软件包包含二进制文件，则在下载时必须提示用户该软件包包含二进制文件。
### Dynamo UI 性能注意事项
在撰写本文时，Dynamo 主要使用 WPF（Windows 演示基础）来呈现其 UI。WPF 是一个复杂而强大的基于 xaml/绑定的系统。由于 Dynamo 具有复杂的 UI，因此很容易造成 UI 挂起、内存泄漏，或者以降低性能的方式将图形执行和 UI 更新包装在一起。
请参考 [Dynamo 性能注意事项 Wiki 页面](https://github.com/DynamoDS/Dynamo/wiki/Dynamo-UI-Performance)，该页面将帮助您避免在更改 Dynamo 代码时遇到的一些常见陷阱。
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://primer2.dynamobim.org/zh-cn/1_developer_primer_intro/3_developing_for_dynamo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.