# 版本控制

在开发和更新插件时，有时可能需要对代码进行版本控制。

例如，FormIt 的 API 可能在不同版本之间有变化，尽管您可能想要新版本的插件使用新的 FormIt 或 WSM API，但您还希望该插件在旧客户端中能够正常工作。

从 FormIt **v18.0** 开始，可以通过 3 个简单步骤实现插件的版本控制：

* 将 *versions.json* 文件添加到插件目录的根目录
* 在 *versions.json* 中，指定每个兼容的 FormIt 版本以及包含这些插件文件的目录
* 使用在 FormIt 中的“信息”>“关于”下找到的 FormIt 内部版本号或“内部版本号”。

### 如何组织插件的版本控制

组织插件文件和目录以匹配 *versions.json*

您的 *versions.json* 应如下所示：

```
        [
            {
                "version":{
                    "major":18,
                    "minor":0
                },
                "path":"v18_0"
            },
            {
                "version":{
                    "major":19,
                    "minor":1
                },
                "path":"v19_0"
            }
        ]
```

上述路径 *v18\_0* 和 *v19\_0* 必须是目录/存储库根目录中的有效子路径。

![](/files/M6qUzIgPlf4uOsrJ2r7O)

![](/files/lQy3Yb5NySW2yFNvRwed)

![](/files/6ozQ6MSndxkbDHYW1VJR)

处理此问题的绝佳方法是将插件代码移至子目录中。使用上述 *versions.json* 时，目录结构将如下所示：

* **versions.json**（文件）
* **v18\_0**（目录）
  * **manifest.json**（文件）
  * **plugin.html**（文件）
  * **plugin.js**（文件）
* **v19\_0**（目录）
  * **manifest.json**（文件）
  * **plugin.html**（文件）
  * **plugin.js**（文件）

版本的可选特性为“exactVersion”和“lastVersion”。“exactVersion”指示版本必须与 FormIt 的版本完全匹配。“lastVersion”指示允许在 FormIt 中运行的上一个版本。\\

```
[
    {
      "version":{
        "major":18,
        "minor":0,
        "exactVersion":true
        },
        "path":"v18_0"
    },
    {
        "version":{
            "major":19,
            "minor":1,
            "lastVersion":true
       },
        "path":"v19_0"
    }
 ]
```

还可以对路径使用 Git 分支/标记/提交。

如果您使用的是 FormIt 的预发布版或 Beta 版，并且想要测试对仅适用于预发布版的插件的更改：

* 请按照上述步骤操作，但使用文件名 *versions\_prerelease.json*
* 如果将 *versions\_prerelease* 提交到您的存储库，则您会想要在 FormIt 的预发布版发布时将其删除
  * 否则，未来预发布的 FormIt 版本将从可能已过时或适用于旧版本的位置加载插件


---

# 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://windows.help.formit.autodesk.com/zh-cn/plugins/how-to-develop-plugins/advanced-development/versioning.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.