使用Tycho来构建你的RCP程序(六) —— Configuration

经过前面的五篇之后，我相信你已经可以熟练的操作使用Tycho来构建你的RCP程序了。RCP开发其实在Java开发当中是非常非常小众的东西。小众的东西注定了资料少而且即便有也是英文的，这一篇会介绍Tycho的一些general configuration，希望能帮到有需要的朋友。

 

1.在Tycho build当中我们在控制台上发现很多的关于enconding的warning

写道

[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!

 

乱码问题想必大家都遇见过，如果在Tycho里使用UTF-8编码而不是现在的GBK呢？很简单只需要在你的parent pom的properties节点下添加如下配置文件

UTF-8  

 

再次build，所有的enconding的warning都已经消失不见了。

 

 

2.对于plugin项目来说，Tycho会把他build成为一个jar文件；但是如何build成一个native plugin，也就是文件夹的形式呢？

 

方法同样很简单，我们需要更改一下MANIFEST.MF文件，在其中添加一句配置。

Eclipse-BundleShape: dir

 

再次build，原来的plugin在product的plugins文件夹内会以一个文件夹而非jar包的形式存在。

 

 

3. 如何更改product build出的文件名？我希望添加版本号或者时间戳。

 

你也许会说用maven-antrun-plugin不就可以做到。没错，ant当然可以做得到，但是其实Tycho也提供了他自己的方法。首先我们需要在parent pom当中定义我们的版本号和timestamp格式。

		1.0.0
		${maven.build.timestamp}
		yyyyMMddHHmm

maven.build.timestamp.format是Maven内置的一个properties，因为Tycho在build中识别不了Maven内置的properties（这是Tycho的一个bug）。因此我们需要再多定义个mail.timestamp来引用他。之后，我们需要更改一下product项目中的pom，添加一段archiveFileName的配置

 

  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
            
          
        
        
	      
	        
	          Mail
	          Mail_${mail.version}_${mail.timestamp}-client
	        
	      
	    
      
    
  

  

这里我们添加了两个属性：id和archiveFileName。archiveFileName很好理解，就是我们build出的文件名，那么id是什么呢？其实这里的id就是我们在Mail.product文件里定义的id，两者必须一致。配置完成之后再次build，build出的文件名已经改变。

 

 

4. 如果我的RCP项目有许多开发人员，我能不能在本地做一个eclipse sdk的镜像让大家共享，而不是每次每个人都从网上下载所需要的dependency呢？

 

Eclipse和Tycho其实也提供这种机制，以我们使用的eclipse 4.4版本luna为例，首先我们需要在本机创建一个他的p2 repository。确保在你本地有一个eclipse，然后eclipse里包含org.eclipse.equinox.p2.artifact.repository这个bundle。之后，我们CMD打开控制台，一路CD到eclipse的安装根目录。运行如下命令

eclipse.exe -application org.eclipse.equinox.p2.artifact.repository.mirrorApplication -source http://download.eclipse.org/releases/luna -destination file:C:\repository\luna

 

C:\repository\luna这个目录就是我们的p2的repository目录，你会发现这个目录中的文件会逐渐增多。下载完成之后，我们更改Maven的settings.xml，添加如下配置

 
  
   Luna_mirror
   Luna
   Luna Local p2 repository
   file://C:/repository/luna/
   p2
   p2
  
 
 

 

这里mirrorOf和我们parent里配置的repository相对应，也就是说在bulid resolving dependencies的时候，如果在settings.xml里能找到对应的mirror的话，所有的dependency便会从本地下载，反之则是继续通过你配置的url来下载。

 

 

5. 如果更改了一个plugin并在MANIFEST.MF里更新了版本号，我如何能批量的更新POM文件，让之与其对应呢？

 

这个时候你就需要tycho-versions-plugin来帮你了。在parent目录中，我们把这个plugin添加进pom中

			
				org.eclipse.tycho
				tycho-versions-plugin
				${tycho.version}
			

 

添加完成之后，在我们的build项目中执行maven -> build并在goals中加入tycho-versions:update-pom，运行Maven。Maven运行完之后你会发现所有的POM文件都已经根据他的plugin或者feature的版本号进行更新了。

 

 

6. 如何移除build中的wanring信息呢？

 

依然需要显示的配置tycho-compiler-plugin插件，并且提供忽略warning message的配置。在parent pom当中添加如下配置

	org.eclipse.tycho
	tycho-compiler-plugin
    ${tycho.version}
    
		
			-warn:-raw,unchecked
		
	

 

再次build，所有的warning信息都已经被忽略。