16

自从升级到 Eclipse 3.7 后，Eclipse PDE 插件希望我为我的所有 Eclipse 插件项目指定一个“API 基线”。

然而，似乎没有任何文档能够真正解释“API Baseline”在这里代表什么，以及它的用途。

有人可以解释一下吗？

4

2 回答 2

8

API Baseline 旨在帮助您维护其他人可以使用的插件。API 工具可帮助您创建兼容的 API 版本。按照Sumit Singh发布的链接获取有关如何使用它们的说明。

问题：

  1. 您创建插件并向公众发布版本 1。
  2. 数百万人将使用您的插件并根据您插件的 API 创建自己的代码。
  3. 您向公众发布第 2 版。错误地更改了插件的 API。
  4. 数百万人更新到新版本并不得不调整他们的代码。数以千计的程序失败。人们很伤心。

解决方案：

  1. 您创建插件，注释其 API并向公众发布版本 1。
  2. 数百万人将使用您的插件并根据您插件的 API 创建自己的代码。
  3. 您将插件的版本 1 声明为自动比较您的代码更改的API-Baseline 。在您发布插件或运行测试之前，API 中的任何中断都会呈现给您。您发布的版本 2 没有任何 API 更改。
  4. 数百万人可以在他们的应用程序中更新您的插件，因为新的插件版本与前一个版本是二进制兼容的。
  5. 您声明插件的第 2 版....

概括

如果您开发的插件仅供您个人使用，并且对维护兼容的 API 不感兴趣，您可以按照建议禁用警告。

当您为社区开发插件时，例如 eclipse 插件本身，您必须将 API 不兼容性保持在最低限度。然后你会按照建议，在为 4.3 开发时将基线设置为 4.2。API 工具将帮助您使 4.3 成为所有当前 4.2 用户的享受。

请注意，API 工具是供其他人使用的插件的开发人员使用的。这些插件的用户没有解决它们。

于 2016-11-09T16:23:26.597 回答
7

从PDE API 工具用户指南：

API 基线定义了您希望将开发工作区包与二进制兼容性、包版本号和@since 标记进行比较的状态。例如，如果您正在为 Eclipse 3.4 开发包，您将使用 Eclipse 3.3 作为您的基线。

于 2011-11-20T01:28:22.823 回答