# 为 Dynamo 2.0+ 定义自定义软件包组织

实现软件包所需的布局取决于将包含在包中的节点类型。“节点模型”派生的节点、ZeroTouch 节点和自定义节点在定义分类方面的过程都略有不同。可以在同一软件包中混合和匹配这些节点类型，但这需要结合使用下面概述的策略。

## NodeModel

默认情况下，NodeModel 库基于类结构进行组织。

```c#
namespace SampleLibraryUI.Examples
```

```c#
// Class Attribute
[NodeName("MyNodeModel")]
public class MyNewNodeModel : NodeModel

// or

// Constructor
public ButtonCustomNodeModel()
{
    this.Name = "MyNodeModel";
}

```

节点将位于以下目录下的附加模块中：

```
SampleLibraryUI/Examples/MyNodeModel
```

还可以通过在类或构造函数中使用 NodeCategory 属性来覆盖该类别，如下所示。

```c#
// Class Attribute
[NodeCategory("NewSampleLibraryUI.Examples")]

// or

// Constructor
public ButtonCustomNodeModel()
{
    this.Category = "NewSampleLibraryUI.Examples";
}
```

节点现在将位于以下目录下的附加模块中：

```
NewSampleLibraryUI/Examples/MyNodeModel
```

## ZeroTouch

默认情况下，ZeroTouch 库也根据类结构进行组织。

```c#
namespace MyZTLibrary
```

```c#
public class Utilities
{
    public double doubleValue(double num)
    {
        return num * 2;
    }
}
```

节点将位于以下目录下的附加模块中：

```
MyZTLibrary/Utilities/doubleValue
```

还可以使用 Dynamo 自定义 XML 文件替代类结构位置。

* XML 文件必须相应地命名并包含在软件包的 `extra` 文件夹中
  * `PackageName_DynamoCustomization.xml`

```xml
<?xml version="1.0"?>
<doc>
    <assembly>
        <name>MeshToolkit</name>
    </assembly>
    <namespaces>
        <!--Remap Namespaces-->
        <namespace name="Autodesk.Dynamo.MeshToolkit">
            <category>MeshToolkit</category>
        </namespace>
        <namespace name="Autodesk.Dynamo.MeshToolkit.Display">
                <category>Display</category>
        </namespace>
    </namespaces>
    <classes>
        <!--Remap Class Names-->
        <class name="Autodesk.Dynamo.MeshToolkit.Display.MeshDisplay" shortname="MeshDisplay"/>
        <class name="Autodesk.Dynamo.MeshToolkit.Mesh" shortname="Mesh"/>
    </classes>
</doc>

```

## CustomNodes

自定义节点是在创建节点（使用新的“自定义节点”对话框）期间根据指定的 `Category Name` 组织的。

**警告！**\
在节点名称或类别中使用点表示法将产生其他嵌套的子类别。`.` 将用作分隔符来确定其他层次结构。这是 Dynamo 2.0 库中的新行为。

类别名称可以稍后在 .dyf 文件（XML 或 JSON）中更新

```json
{
  "Uuid": "85066088-1616-40b1-96e1-c33e685c6948",
  "IsCustomNode": true,
  "Category": "MyCustomNodes.Utilities.Actions",
  "Description": "This is an example custom nodes.",
  "Name": "doubleValue",
  "ElementResolver": {
    "ResolutionMap": {}
  },...
```

```xml
<Workspace Version="1.3.0.0000" X="100" Y="100" zoom="1.0000000" Description="This is an example custom nodes." Category="MyCustomNodes.Utilities.Actions" Name="doubleValue" ID="85066088-1616-40b1-96e1-c33e685c6948">
```

## 软件包节点移植策略

当软件包作者决定在新版本中重命名以前存在的节点时，他们应该提供一种方法来移植包含具有旧名称的节点的图表。这可以通过以下方式完成...

**ZeroTouch** 节点使用位于软件包 `bin` 文件夹中的 `Namespace.Migrations.XML` 文件，例如：

`MyZeroTouchLib.MyNodes.SayHello` 到 `MyZeroTouchLib.MyNodes.SayHelloRENAMED`

```xml
<?xml version="1.0"?>
<migrations>
  <priorNameHint>
    <oldName>MyZeroTouchLib.MyNodes.SayHello</oldName>
    <newName>MyZeroTouchLib.MyNodes.SayHelloRENAMED</newName>
  </priorNameHint>
</migrations>
```

**NodeModel 派生的节点**使用诸如以下类的 `AlsoKnownAs` 属性：

`SampleLibraryUI.Examples.DropDownExample` 到 `SampleLibraryUI.Examples.DropDownExampleRENAMED`

```c#
namespace SampleLibraryUI.Examples
{
    [NodeName("Drop Down Example")]
    [NodeDescription("An example drop down node.")]
    [IsDesignScriptCompatible]
    [AlsoKnownAs("SampleLibraryUI.Examples.DropDownExample")]
    public class DropDownExampleRENAMED : DSDropDownBase
    {
        ...
    }
{
```


---

# 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/9-defining-custom-package-organisation-dynamo2.0+.md?ask=<question>
```

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.