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

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

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

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

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  

再次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格式。

		<mail.version>1.0.0</mail.version>
		<mail.timestamp>${maven.build.timestamp}</mail.timestamp>
		<maven.build.timestamp.format>yyyyMMddHHmm</maven.build.timestamp.format>

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

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>com.chnic.tycho.mail</groupId>
    <artifactId>com.chnic.tycho.mail.parent</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <relativePath>../com.chnic.tycho.mail.parent/pom.xml</relativePath>
  </parent>
  
  <artifactId>com.chnic.tycho.mail.product</artifactId>
  <packaging>eclipse-repository</packaging>
  
  <build>
    <plugins>
      <plugin>
        <groupId>org.eclipse.tycho</groupId>
        <artifactId>tycho-p2-repository-plugin</artifactId>
        <version>${tycho.version}</version>
        <configuration>
          <includeAllDependencies>true</includeAllDependencies>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.eclipse.tycho</groupId>
        <artifactId>tycho-p2-director-plugin</artifactId>
        <version>${tycho.version}</version>
        <executions>
          <execution>
            <id>materialize-products</id>
            <goals>
              <goal>materialize-products</goal>
            </goals>
          </execution>
          <execution>
            <id>archive-products</id>
            <goals>
              <goal>archive-products</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
	      <products>
	        <product>
	          <id>Mail</id>
	          <archiveFileName>Mail_${mail.version}_${mail.timestamp}-client</archiveFileName>
	        </product>
	      </products>
	    </configuration>
      </plugin>
    </plugins>
  </build>
</project>

这里我们添加了两个属性：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，添加如下配置

<settings>
 <mirrors>
  <mirror>
   <id>Luna_mirror</id>
   <mirrorOf>Luna</mirrorOf>
   <name>Luna Local p2 repository</name>
   <url>file://C:/repository/luna/</url>
   <layout>p2</layout>
   <mirrorOfLayouts>p2</mirrorOfLayouts>
  </mirror>
 </mirrors>
</settings> 

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

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

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

			<plugin>
				<groupId>org.eclipse.tycho</groupId>
				<artifactId>tycho-versions-plugin</artifactId>
				<version>${tycho.version}</version>
			</plugin>

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

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

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

<plugin>
	<groupId>org.eclipse.tycho</groupId>
	<artifactId>tycho-compiler-plugin</artifactId>
    <version>${tycho.version}</version>
    <configuration>
		<compilerArgs>
			<arg>-warn:-raw,unchecked</arg>
		</compilerArgs>
	</configuration>
</plugin>

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