java - 在 Eclipse 中添加 API 基线

Question

在eclipse源码库中编译。我有“尚未设置 API 基线...”错误。

我尝试添加 API Baseline，但我不知道如何制作或添加它。

API Baseline 的用途是什么，如何添加或制作？

Answer 1

我尝试回答问题的“API 基准是什么，......”部分。

API Baseline 是 PDE Tools/API Tools 的一个概念。它们旨在帮助您维护其他人可以使用的插件。它们可帮助您创建兼容的 API 版本。

问题:

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

解决方案:

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

总结

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

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

请注意，API 工具是供其他人使用的插件的开发人员使用的。它们不是针对这些插件的用户的。