java - Eclipse PDT 中的 'API Baseline' 是什么

Question

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

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

谁能解释一下？

Answer 1

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

问题:

1. 您创建插件并向公众发布版本 1。
2. 数以百万计的人将使用您的插件并创建他们自己的代码，这些代码取决于您的插件的 API。
3. 您向公众发布了版本 2。 您错误地更改了插件的 API。
4. 数以百万计的人更新到新版本并且不得不调整他们的代码。数以千计的程序失败。人们很难过。

解决方案:

1. 您创建自己的插件，注释其 API 并向公众发布版本 1。
2. 数以百万计的人将使用您的插件并创建他们自己的代码，这些代码取决于您的插件的 API。
3. 您将插件的版本 1 声明为 API 基线，您的代码更改会自动与之进行比较。 API 中的任何中断都会在您发布插件或运行测试之前呈现给您。您发布版本 2，无需任何 API 更改。
4. 数以百万计的人可以在他们的应用程序中更新您的插件，因为新的插件版本与以前的版本二进制兼容。
5. 您声明插件的版本 2 ....

总结

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

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

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