# 更新 Dynamo 4.x 的软件包和 Dynamo 库
### 简介
本部分包含有关将图形、软件包和库移植到 Dynamo 4.x 时可能所遇到问题的信息。Dynamo 4.0 引入了：
* 重要性能的改进
* 稳定性和错误修复更新
* 代码库的现代化
* 删除了以前在 1.x 中标记为过时的 API
* 从 .NET 8 到 .NET 10 的主要运行时更新
* PythonNet 3 现在是所有新 Python 节点的默认 Python 引擎
.NET 10 迁移工作确保 Dynamo 与 Microsoft 的技术路线图保持一致，远早于 2026 年 11 月结束对 .NET 8 的支持。
启动 Dynamo 4.0 时，如果尚未更新，系统将要求您更新到 .NET 10。软件包作者需要将其项目更新为目标 .NET 10，以确保完全兼容。
在 Dynamo 4.0+ 中创建的所有新 Python 节点都以 PythonNet3 开始。无需担心向后兼容性：对于在多版本软件（例如，Revit 或 Civil 3D 2025/2026）中工作的用户，请在 Dynamo 3.3-3.6 中安装 PythonNet3 引擎软件包以保持兼容性。有关详细信息，可在[此处](https://dynamobim.org/dynamo-core-4-0-release/)找到。
在 1.x 中标记为过时的 API 和节点已在 Dynamo 4.0 中删除。您可以参考此处的[更改完整列表](https://github.com/DynamoDS/Dynamo/wiki/API-Changes-in-Dynamo-4.0.0)。
### 软件包兼容性
#### 在 Dynamo 4.x 中使用 Dynamo 2.x 和 3.x 软件包
由于 Dynamo 4.x 现在在 .NET 10 运行时上运行，因此不能保证为 Dynamo 2.x (\* .NET48\*) 和 Dynamo 3.x（*使用 .NET 8*）构建的软件包能够在 Dynamo 4.x 中工作。尝试在 Dynamo 4.x 中下载从 Dynamo 版本低于 4.0 发布的软件包时，您会收到一条警告，指出该软件包来自较旧版本的 Dynamo。
**这并不意味着软件包将不工作**。这只是一个警告，指出可能存在兼容性问题；通常，最好检查是否有专为 Dynamo 4.x 构建的较新版本。
在加载软件包时，您还可能会在 Dynamo 日志文件中注意到此类警告。如果一切正常，可以忽略它。
#### 在 Dynamo 2.x 中使用 Dynamo 4.x 软件包
为 Dynamo 4.x（*使用 .Net 10*）构建的软件包不太可能基于 Dynamo 2.x 运行。尝试在 Dynamo 2.x 中安装为 Dynamo 4.x 构建的软件包时，还会看到以下警告。
#### 在 Dynamo 3.x 中使用 Dynamo 4.x 软件包
为 Dynamo 4.x（*使用 .Net 10*）构建的软件包可以在 Dynamo 3.x 上运行，只要该软件包中使用的所有 API 都存在于 .NET 8 中即可。但不能保证它会奏效。尝试在 Dynamo 3.x 中安装为 Dynamo 4.x 构建的软件包时，还会看到以下警告。
#### 软件包作者的最佳做法
最佳做法是通过修改 .csproj，使项目同时支持 .NET 8 和 .NET 10。
```
net8.0;net10.0
```
这可确保：
* 支持仍基于 .NET 8 的 Revit 托管的 Dynamo 版本
* 与 .NET 10 上的单机版 Dynamo 4.x 兼容
---
# 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/6-2-updating-your-packages-and-dynamo-libraries-for-dynamo-4x.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.