Eclipse PDT中的“API基线”是什么

Question

自从升级到Eclipse 3.7以来，Eclipse PDE插件希望我指定一个＆＃39; API Baseline＆＃39;对于我所有的Eclipse插件项目。

然而，似乎没有文件实际上解释了什么＆＃39; API Baseline＆＃39;代表这里，它用于什么。

有人可以解释一下吗？

Answer 1

来自the PDE API Tools User Guide：

  

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

Answer 2

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版。
4. 数百万人可以在他们的应用程序中更新您的插件，因为新的插件版本与之前的插件是二进制兼容的。
5. 您声明插件的第2版....

摘要

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

为社区开发插件时，请执行以下操作： G。 eclipse插件本身，必须将API不兼容性保持在最低限度。然后，当您开发4.3时，您将遵循建议并将基线设置为4.2。 API工具将帮助您为所有当前4.2用户提供4.3。

请注意，API工具适用于其他人将使用的插件开发人员。这些插件的用户不会解决这些问题。

Answer 3

看看它可以帮助你：

1. API Tools in Eclipse: An introduction