Eclipse PDT中的"API基线"是什么

Question

自升级到Eclipse 3.7以来,Eclipse PDE插件希望我为所有Eclipse插件项目指定"API Baseline".

然而,似乎没有文件实际上解释了什么'API Baseline'在这里代表什么,以及它用于什么.

有人可以解释一下吗？

Answer 1

从PDE API工具用户指南:

API基线定义了您希望将开发工作区捆绑包与二进制兼容性,包版本号和@since标记进行比较的状态.例如,如果要为Eclipse 3.4开发软件包,则将使用Eclipse 3.3作为基准.

Answer 2

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

问题：

1. 您创建插件并将版本1公开发布。
2. 数百万人将使用您的插件，并根据插件的API创建自己的代码。
3. 您将版本2公开发布。错误地更改了插件的API。
4. 数以百万计的人更新到新版本，并且不得不修改他们的代码。成千上万个程序失败。人们很难过。

解决方案：

1. 您可以创建插件，注释其API并向公众发布版本1。
2. 数百万人将使用您的插件，并根据插件的API创建自己的代码。
3. 您将插件的版本1声明为API基线，您的代码更改将自动与此API进行比较。在释放插件或运行测试之前，会向您显示API中的任何中断。您发布版本2，而没有任何API更改。
4. 数以百万计的人可以在其应用程序中更新您的插件，因为新的插件版本与上一个版本具有二进制兼容性。
5. 您声明了插件的版本2...。

摘要

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

当您为社区开发插件时，例如eclipse插件本身，必须将API不兼容程度降至最低。然后，您将遵循建议并在为4.3开发时将基线设置为4.2。API工具将帮助您为当前所有4.2用户带来4.3的乐趣。

请注意，API工具是供他人使用的插件开发人员使用的。这些插件的用户未解决这些问题。