使用Tycho来构建你的RCP程序(三) —— Product

阅读更多

在之前的两篇文章中,我们已经学会了如何如何用Tycho来build plugin和feature。在通常RCP项目当中,仅仅有plugin和feature是不够的,plugin提供着RCP程序中最小的逻辑功能,而feature则把这些功能点包装成一个单独的逻辑单元。但如果一个RCP的程序需要很多的features时怎么办?你可以说我可以feautre里面套feature。但如果客户要求这个RCP的程序需要在windows,linux和Mac oc都有客户端时,feature就已经明显满足不了我们的需求了。这个时候就需要引入RCP中product的概念了。

 

对于Product,官方的解释是这样的:

写道
An Eclipse based product is a stand-alone program built with the Eclipse platform. A product may optionally be packaged and delivered as one or more features, which are simply groupings of plug-ins that are managed as a single entity by the Eclipse update mechanisms.

Products include all the code and plug-ins needed to run them. This includes a Java runtime environment (JRE) and the Eclipse platform code. The plug-in code, JRE, and Eclipse platform are typically installed with a product-specific installation program. Product providers are free to use any installation tool or program that is appropriate for their needs.

 http://help.eclipse.org/luna/index.jsp?topic=/org.eclipse.pde.doc.user/concepts/product.htm

 

简单点说,product就是一个standalone的可执行程序,他可以包含很多的plugin和feautre,也可以针对于不同的平台定制不同的参数。关于product,feauture和plugin的关系,个人觉得下面的这句话是概括的最好的。

写道
plugins can be grouped in features which can be packaged as an executable unit called product.

 

 对Product的概念有了一定的了解之后,我们便可以开始创建product项目了:

 

1. 首先还是 New -> Project -> General -> Project

2. 在接下来的对话框中输入我们的项目名称,这里我们用com.chnic.tycho.mail.product

3. 项目创建完成之后我们需要创建product文件,还是New -> Other -> Plug-in Development -> Product Configuration -> Next

4. 在接下来的对话框中,选中我们刚刚创建的product项目,然后在下面的File Name里输入我们的product文件名,这里我们用Mail.product  -> Finish

5. 在Mail.product配置的overview tab界面中,给出相应的信息。值得一提的是,我们需要选择这个product是based on在features上的。其次,ID是必须填写的,因为Tycho会使用ID加上你build的平台后缀组合成一个完成的文件名。其他的配置不多赘述。

 

使用Tycho来构建你的RCP程序(三) —— Product_第1张图片
 

6. 在Dependencies tab界面中,把我们之前创建的feature添加进来。


使用Tycho来构建你的RCP程序(三) —— Product_第2张图片
 

7. 接下来在Configuration tab中,我们需要添加Start Levels。这么做是因为,在传统的PDE build过程中,PDE会自动添加start levels。但是Tycho不会自动添加这些配置,所以就需要我们手动添加。否则Tycho就会在build过程中出错。因为我们这里只是个demo程序,所以不做过多的考虑,直接点击Add Recommanded,使用系统推荐配置即可。

假如你添加完成之后用Tycho build发现还是有start levels的问题,那么试一下切换到overview tab然后用Eclipse Product export wizard来导出你的product,在你导出的文件夹中找到configuration/org.eclipse.equinox.simpleconfigurator/bundles.info这个文件,文件中的每一行是由bundle_name, version, location, startlevel, autostart组成的,筛选出所有autostart是ture的行,然后根据他的startlevel把他们加到你的Mail.product配置文件中来。

 


使用Tycho来构建你的RCP程序(三) —— Product_第3张图片
 

至此我们便完成了Product项目的创建,其实这个时候我们的product项目是run不起来的。(除非你在Run Configurations的Plug-ins选项卡里点击Add Required Plug-ins添加所需要的依赖)这是因为我们还缺少一些RCP程序所需要target platform级别的plugin。这些plugin添加到我们的feauture项目当中,因为我们这里主要关注的是Tycho,我们只需build出一个应用程序即可,在此我就不多赘述RCP相关的内容。

 

在接下来我们就需要把我们刚创建好的Product项目变成一个支持Tycho的Maven项目。还是右键product项目名,然后把他转换成一个Maven项目,在Maven的配置框中,其他的属性和我们之前介绍的plugin和feature的命名规范类似,唯一不同的一点就是packaging变成了eclipse-repository。


使用Tycho来构建你的RCP程序(三) —— Product_第4张图片
 

在生成的POM文件中,添加parent属性,让他继承我们之前创建的parent项目。然后添加Tycho product build相关的插件。


  4.0.0
  
    com.chnic.tycho.mail
    com.chnic.tycho.mail.parent
    1.0.0-SNAPSHOT
    ../com.chnic.tycho.mail.parent/pom.xml
  
  
  com.chnic.tycho.mail.product
  eclipse-repository
  
  
    
      
        org.eclipse.tycho
        tycho-p2-repository-plugin
        ${tycho.version}
        
          true
        
      
      
        org.eclipse.tycho
        tycho-p2-director-plugin
        ${tycho.version}
        
          
            materialize-products
            
              materialize-products
            
          
          
            archive-products
            
              archive-products
            
          
        
      
    
  

 

这个时候我们虽然告诉Tycho如何去build这个product项目了,但是我们还没有提供我们build出的程序应当支持那种平台的信息。返回parent项目,修改POM文件,添加target-platform-configuration插件


  4.0.0
  com.chnic.tycho.mail
  com.chnic.tycho.mail.parent
  1.0.0-SNAPSHOT
  pom
  
    
		0.22.0
		http://download.eclipse.org/releases/luna
	
	
	
		
			luna
			${luna-repo.url}
			p2
		
	
	
	
		
			
				org.eclipse.tycho
				tycho-maven-plugin
				${tycho.version}
				true
			
			
			
				org.eclipse.tycho
				target-platform-configuration
				${tycho.version}
				
					
						
						
							win32
							win32
							x86
						
						
					
				
			
		
	  

 

添加完成之后我们会发现,parent的pom中多了很多的平台信息,因为我们只需要build出来的程序是一个win32.x86的程序,所以在这里我们注释掉其他的平台信息。这个时候你也许会问,我们可以直接build product了么?答案是否定的,因为你的product项目只有一个孤零零的product文件,他最终依赖的仍然是你的feature和plugin。所以我们需要在运行时提供这些依赖。还记得第二篇文章中我们最后提出的问题么?如果一个feature包含非常多的plugin,然后plugin A依赖plugin B,plugin B依赖plugin C的时候,这个时候我们怎么办?难道要按照依赖关系一个一个来构建么?很显然,全部手动是一种反人类的做法。更何况你在build product的时候即便全部手动也不一定能够build成功。这个时候,我们就需要一个聚合器,偏巧我们的Maven也支持这样的做法。

 

到目前为止,我们已经有了parent, pulgin, feature, product这四个项目,要聚合这四个项目,我们还需要另外的一个项目:com.chnic.tycho.mail.build。最终我们的Mail这个demo的目录结构会是这样:

 

com.chnic.tycho.mail RCP Project

|

|----com.chnic.tycho.mail.build

|----com.chnic.tycho.mail.feature

|----com.chnic.tycho.mail.parent

|----com.chnic.tycho.mail.plugin

|----com.chnic.tycho.mail.product

 

com.chnic.tycho.mail.build依然是一个普通的项目,创建完成之后我们仍然需要把他convert成一个Maven项目。因为他是一个聚合项目,所以packaging的方式依然是pom


使用Tycho来构建你的RCP程序(三) —— Product_第5张图片
 

转化完成之后,我们依然让build的项目继承parent项目,然后把plugin, feature和product加入build的pom当中,让他们变成build项目的modules。


  4.0.0

  
    com.chnic.tycho.mail
    com.chnic.tycho.mail.parent
    1.0.0-SNAPSHOT
    ../com.chnic.tycho.mail.parent/pom.xml
  
  
  com.chnic.tycho.mail.build
  pom
  
  
  	../com.chnic.tycho.mail.feature
  	../com.chnic.tycho.mail.plugin
  	../com.chnic.tycho.mail.product
  

 

完成之后clean install com.chnic.tycho.mail.build这个项目,控制台上面的信息告诉我们build成功。

写道
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] com.chnic.tycho.mail.plugin ........................ SUCCESS [ 1.563 s]
[INFO] com.chnic.tycho.mail.feature ....................... SUCCESS [ 0.186 s]
[INFO] com.chnic.tycho.mail.product ....................... SUCCESS [ 8.189 s]
[INFO] com.chnic.tycho.mail.build ......................... SUCCESS [ 0.063 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 25.715 s
[INFO] Finished at: 2015-04-14T15:21:46+08:00
[INFO] Final Memory: 74M/178M
[INFO] ------------------------------------------------------------------------

 

Build成功之后我们刷新一下product项目,会发现在target/products目录下已经多了Mail-win32.win32.x86.zip这个zip文件。这个文件就是我们这个demo的可执行文件的压缩包。至此,我们也完成了product项目的构建工作。

 

Demo的代码在此给共享给大家。

  • 使用Tycho来构建你的RCP程序(三) —— Product_第6张图片
  • 大小: 42.4 KB
  • 使用Tycho来构建你的RCP程序(三) —— Product_第7张图片
  • 大小: 21.7 KB
  • 使用Tycho来构建你的RCP程序(三) —— Product_第8张图片
  • 大小: 39 KB
  • 使用Tycho来构建你的RCP程序(三) —— Product_第9张图片
  • 大小: 31.5 KB
  • 使用Tycho来构建你的RCP程序(三) —— Product_第10张图片
  • 大小: 31.8 KB
  • com.chnic.tycho.mail.zip (108.8 KB)
  • 下载次数: 56
  • 查看图片附件

你可能感兴趣的:(RCP,Build,Maven,Tycho,Product)