Dev_from_Zero

从零开始编译yuchberry

首先这篇文档不是写给高手看的，是写给小白看的。原因有二：首先，我不是高手，更不可能是高手中的高手；其二，小白看得懂的话，高手就更不用说了。

还有个前提，你的系统得是Windows的，因为我不知道RIM是否有针对Linux出过SDK和模拟器，所以首先得找台WindowsXP的系统作为你的开发用机。

服务器的最新代码可能有加入更多的库，可能文档不会实时的更新。同时我有时候会把编译不过的代码签入到Google Project Hosting上面，所以如果大家编译不过的时候，请耐心等一下，我更新新的文档和代码。

现在，怎么把大象装进冰箱呢？

签出代码

安装SVN

你可以选择命令行的方式签出代码SlikSVN，也可以选择 TortoiseSVN 这个图形配置界面（推荐），如果你不知道什么是SVN，签出完代码之后请自行搜索，补充知识。

签出语盒主版本代码

点击Google Project Hosting 的Source 来到这个页面 然后找到签出的地址：

http://yuchberry.googlecode.com/svn/trunk/@1633 yuchberry-read-only 

然后如图建立自己的工作目录，签出自己代码。建议放在D盘，图片上的不对，因为我的配置文件会提交同步到google code上面，如果目录不同，会导致代码编译不过。如果你知道为什么编译不过，那么就可以随意设置，同时自己排查原因了。
@1633这个数字是每次发布版本的稳定版，比如1.11.1633 版本，后面的数字就是SVN版本，需要下载稳定版本，才能mod，不然就会出问题。现在我没有开发合作者，所以还不需要branches进行开发。

[]

准备Eclipse开发环境

下载一堆东西先

• 下载 Eclipse Java IDE 解压到一个地方，比如D盘的eclipse文件夹。
• 下载 JavaMail Dom4J HTMLParser三个库，解压到eclipse的目录下面的plugins目录下面
• 下载 weibo4j，解压放到签出的目录下面的 server\src 下面，例如 D:\Java_Project\yuchberry\server\src\weibo4j
• 下载 Blackberry Java Development for Eclipse Plugin1.1 这个只有黑莓5.0系统的开发包。
• 继续下载 4.5 4.6 4.7 6.0 7.0 7.1的开发包。统统下完之后，用解压缩工具（7zip 或者WinRAR）打开，解压到 eclipse\plugins 目录底下。

• 一段很长的下载时间过去之后。。。*

配置Eclipse开发环境及语盒服务器工程

• 运行之前下载好的 Blackberry Java Development for Eclipse Plugin1.1，然后指定你的Eclipse目录作为安装路径，进行安装（图就不截了，相当简单）。
• 打开Eclipse，点击 File -> Switch Workspace -> Ohter... 指定工作空间到你签出代码的地方，比如D:\Java_Project\yuchberry\
• 点击 File -> New -> Java Project 然后如下图设置，配置好语盒 server工程（我的截图的路径可能有些出入）
  []
  
• 点击Project -> Propertise 然后如下图
  []
  点击“Add External JARs”以此添加之前下载库：
• javaMail 解压目录下面的 mail.jar
• weibo4j 解码目录lib中的四个jar文件
• dom4j 解压目录中的dom4j-1.6.1.jar 文件
• htmlParser 解压目录 lib 中的 htmlparser.jar 和 htmllexer.jar 文件。
• 点击 File -> Export -> Java -> Runnable JAR file 然后如下图配置
  []
  点击Finish按钮，就能生成传说中的svr.jar文件了。

配置语盒客户端

• 点击 File -> New -> Java Project 然后如下图配置安装5.0OS工程
  []
  
• 在Package Explorer 界面中
  [![](http://i.imgur.com/zfmNy.jpg]
  选中client，右键，然后依次点击 Propertise -> Run/Debugging -> client -> Edit... ->JRE -> Installed JREs，配置其他Blackberry系统的开发包
  [http://i.imgur.com/iv5nT.jpg]
  然后点击Add 添加ee类型的文件
  [http://i.imgur.com/xLjRE.jpg]
  [http://i.imgur.com/f8acG.jpg)]
  在之前下载并解压的4.5jar文件目录，例如：D:\eclipse\plugins\net.rim.ejde.componentpack4.5.0_4.5.0.21\components 下面找到 BlackBerry.ee 文件，并添加上。
• 依次添加其他系统平台的ee文件，配置好4.6 4.7 6.0 的开发环境（5.0的在 Blackberry Java Development for Eclipse Plugin 安装的时候就已经添加）。
• 依次用File -> New -> Java Project 的方法，添加已有的各个客户端工程，如下图
  []
  
• 如果你的系统默认的语言是中文（有点像废话），由于RIM的一个bug，必须拷贝 eclipse\plugins\net.rim.ejde.componentpack6.0.0_6.0.0.29\components\bin\preverify.exe 到 4.5、4.6、4.7、5.0的相同位置下面覆盖相同的文件，不然会编译不过。这个方法解决 local 问题，在网上也能搜到。 这样所有语盒客户端版本的开发环境就已经架设完毕。

编译并在模拟器运行语盒

首先你** 非常了解语盒** ，使用过一段时间，知道如何填写config.xml文件，同时知道如何设置客户端。如果作为一个开发者，连自己的产品配置都不了解，那一定是不合格的。

• 上面的添加ee文件的时候看到过一个界面：在Package Explorer 选中client45工程，然后右键菜单中选择 Propertise 然后 Run/Debugging -> client45 -> Edit...
  []
  然后可以变换模拟器的机器型号。
• 如果你选择运行8310的客户端，那么就用打开 eclipse\plugins\net.rim.ejde.componentpack4.5.04.5.0.21\components\simulator\8310.xml 文件，在后面加上

  net.rim.blackberry.lang.zh_CN_Pinyin

  net.rim.blackberry.lang.zh

  CN.renderingSupport此举是为了让模拟器能用上中文。
• 前面有生成过svr.jar，那么打开config.xml配置好自己的邮件帐户，删除无用信息。运行runsvr.bat，等待服务器启动。
• 在Package Explorer 中选择client45，然后按F11（debug的快捷键），就可以看到一连串的编译，确认，然后客户端模拟器就运行起来了，在等待一会儿，就会出现熟悉的界面，进入语盒，填写上你的IP地址，** 不能是127.0.0.1** ，必须是你机器的内网IP，例如192.168.10.20
  []

在移动设备上运行语盒

编译出来的语盒客户端不能直接运行手机上，这个就是传说中黑莓代码授权，RIM解释说，他们需要监控API的使用情况。于是，我们就不得不花费$20买一个授权，才能在手机上运行。此时，如果你花费了大量时间弄好了语盒代码，准备编译一个myberry放到手机上运行一下，欣赏一下，这个结果可能让你十分失望吧...

Mod 语盒客户端

看到这里，首先你要先学习Java，这个过程对任何人都是不一样的，有些人需要0天（他已经是高手了），有些人需要20天速成，有些人需要100天系统的学习。