Eclipse开源政策系列 – 13 – 测试和构建依赖库

原文链接:

http://wiki.eclipse.org/Development_Resources/IP/Test_and_Build_Dependencies

 

测试和构建依赖包是指那些不会被作为发布贡献的第三方库和工具。也就是说项目组不会通过任何eclipse.org官方渠道对这些库进行积极的发布。例如,这些库和工具可能会被存放在仅对Eclipse提交者可用的构建服务器上;再例如,它们可能不会被存放到eclipse.org的下载或存档服务器、Web服务器或者任何源码库上。通过eclipse.org源码库发布的Eclipse项目和脚本可能会包含对这些库和工具的引用(但并不是对应的库/源码本身)。项目文档应该列出这些依赖包,它们是被如何取得的(手工或者通过脚本自动),以及其它问题(尤其是许可证)。

2016010601本文档仅适用于那些专门用于帮助构建和测试的依赖库。任何Eclipse software的下游消费者所必需的依赖库(例如,它们是根据第三方软件评审指南( Guidelines for the Review of Third-party Software)来定义的必备依赖包)都必需通过独立的CQ检查后方可准入。本文档仅适用于开源库和工具;它不适用于对具有专利的工具的使用。对专利工具的使用在董事会决议(Board resolution中进行了描述。

测试和构建依赖库可能会被汇集到一个贡献问卷(CQ,Contribution Questionnaire)中,根据第三方软件评审指南中的第一条定义,它们被称为“共事(works with)”依赖库:

Eclipse software并不要求第三方软件一定即时可用。如果对应的第三方软件正好是即时可用的,则Eclipse software可能会调用它。

例如:如果一个Web浏览器是即时可用的,则在Eclipse中点击URL则会使用用户配置的Web浏览器来打开对应的URL。

要声明测试依赖库,请使用项目管理基础设施( Project Management Infrastructure)来为你的项目创建一个新的CQ(http://wiki.eclipse.org/Project_Management_Infrastructure/Creating_A_Contribution_Questionnaire):

● 选择[request]来使用、引用、或者发布在其它地方(尚未在Orbit中)维护的第三方代码。

● 如果之前审批过的CQ没有一个能匹配,则按照工作流程来为第三方代码[enter]一个新的CQ。

● 输入一个带有关键词test-only dependencies,或者build-test-only dependencies(诸如此类)的标题 。

● 输入一个描述来表明对应的CQ是专用于测试/构建的依赖库的,并且输入一个申请来声明对应的“works with”依赖库,并列出所有的第三方依赖——每行一个——带有版本信息;例如:

这是一个针对Tycho项目的所有依赖库的带保护性CQ,它只被Tycho用于编译和执行单元测试以及综合测试

这个产物是不会被Tycho的项目进行再分发的,并且严格限定只允许被用于编译和运行tycho项目范围内测试;

以下的组件是tycho的只用于测试的相关依赖(来源于orbit)

依赖库列表:

 

Bundle-SymbolicName : Bundle-Version

=============================================

com.ibm.icu:4.2.1.v20100412

javax.xml:1.3.4.v201005080400

org.apache.ant:1.7.1.v20090120-1145

org.junit:3.8.2.v20080602-1318

org.junit:3.8.2.v20090203-1005

(注意,如果清单很长,在CQ创建之后,将它们包含到注释中可能会更简单些)

● 认真填写License、Source/Binary以及其它信息域。这些不能够留空,但是似乎并没有一个严格正确的选项(如果包含了多个license,则可以在信息域中输入“various”

你可以创建多个测试和构建CQ(也就是说开始时你不需要确保这些是严格正确的)。

你可能会收到一个或多个将源代码附到CQ中的请求。请忽略这些请求。

Test-only依赖包不得以任何形式检入Eclipse SCM中。它们也不得从download.eclipse.org处进行分发。

你需要PMC进行审批。如果你在创建CQ之前与PMC共同开展工作并使其理解了你的需求,你的审批进程将会得到加速。如果你有任何疑问或担忧,请联系EMO

该文档内容由 EMO进行调整;

打赏一下
支付宝
微信
除非注明,博客文章均为原创,转载请标明文章地址
本文地址: http://www.javafxchina.net/blog/2016/01/eclipse-policy-13-test-and-build-dependencies/
百度已收录