在Eclipse中添加API基线

Question

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

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

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

Answer 1

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

所以基本上这意味着你正在构建需要其他捆绑包的插件（一个插件项目，它是一个OSGi包或一个Eclipse插件）（依赖包/插件+ OSGi框架（核心和汇编API /服务）） ），您通过“API Baseline”指定它，它保证它们（依赖关系）的存在类似于“profile”（例如IBM WAS中的Liberty配置文件）。

作为解决方法，您可以通过“插件首选项”避免为工作区设置API基线，将其设置为“警告”或“忽略”。这允许您编译插件（OSGi）项目。

价： http://help.eclipse.org/luna/index.jsp?topic=%2Forg.eclipse.pde.doc.user%2Freference%2Fapi-tooling%2Fpreferences%2Fref-baselines.htm

Answer 2

有关API基准的更多信息，请参阅此文章：http://eclipse-tips.com/tutorials/26-api-tooling-tutorial

Answer 3

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

摘要

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

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

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

Answer 4

您也可以“忽略”它：http://exploreeclipse.blogspot.ch/2014/01/eclipse-error-api-baseline-has-not-been.html

“Windows＆gt;首选项＆gt;插件开发＆gt; API基线＆gt;选项＆gt;缺少API基线 然后，在下拉列表中将“错误”更改为“忽略”。“

请记住，根据用例，忽略可能是错误的做法：

• 如果您必须处理源代码甚至提交项目，忽略API Baseline可能不是一个好主意。
• 如果您只是使用它们作为依赖项导入bundle，例如通过Git（可能更容易提取新更改或切换到另一个分支），您可以忽略API Baseline