安装运行 SWT Examples 应用程序以及查看 SWT Example Source
获取 Eclipse projects 的 source 的方式有很多种,大多数开发人员在开发 plug-in 的过程中,会在调试的过程中查看 Eclipse 的 source 。这种情况可以通过在线 CVS repository 或者下载 Eclipse Classic 版本 ( 该版本中包含了 SDK Java 工具使用的 jar 文件的 source) 。例如在 Eclipse Classic 3.5 版本中,对应
$eclipse.home/plugins/com.ibm.icu_4.0.1.v20090415.jar 文件的 source 文件为
$eclipse.home/plugins/com.ibm.icu.source_4.0.1.v20090415.jar ,对应
$eclipse.home/plugins/org.apache.ant_1.7.1.v20090120-1145 插件的 source 文件为
$eclipse.home/plugins/org.apache.ant.source_1.7.1.v20090120-1145.jar 。
而对应 Eclipse SWT 的插件和其 source 文件是和操作系统平台有关的,笔者的操作系统为 win32.x86 的平台,所以对应的文件为:
org.eclipse.swt.win32.win32.x86_3.5.0.v3550b.jar
org.eclipse.swt_3.5.0.v3550b.jar
org.eclipse.swt.win32.win32.x86.source_3.5.0.v3550b.jar
但是 SWT Examples 不包含在 Classic 版本和其他标记的版本中。需要进行下载和安装。
下载安装的方法如下:
通过更新管理器进行安装:
可以在 Eclipse project 的更新站点上找到 Eclipse SDK 的例子程序,可以通过下面的步骤进行定位和安装:
1. 打开 Eclipse ,依次选择 Help > Software Updates > Find and Install 。
2. 选择 Search for new features to install ,然后点击 Next 。
3. 选择 Eclipse Project Updates site 。
4. 点击 Next 然后等待检索结果。
5. 选择 Eclipse SDK 的版本,展开 category 。
6. 选择 Eclipse SDK Examples ,点击 Next 。
7. 接受许可协议,点击 Next 。
8. 选择将 examples 安装的目录,然后点击 Next 。
9. 点击 Install 。
10. 安装完成后重新启动 Eclipse 。
手动安装:
通过 standalone 的 zip 文件进行安装:
1. 在 Eclipse project 站点下载 Eclipse SDK Example 的 zip 文件。
首先进入 Eclipse 下载页面 (http://download.eclipse.org/eclipse/downloads/ ) ,选择最新的或者是 stable 的 build release ,点击 release 版本号,例如 Build Name 3.5 ,进入该 release 的下载画面:
http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/index.php
拖动滚动条,查找到 ”Examples Plug-ins” ,下载对应操作系统平台的 SDK Examples 。例如 eclipse-examples-3.5-win32.zip(for windows) 文件或者 eclipse-examples-3.5.zip(All other platforms) 。
2. 将 zip 文件解压缩到本地目录。
3. 在 Eclipse 中一次选择 Help > Software Updates > Manage Configuration 。
4. 选择 Add an Extension Location.
5. 选择步骤 2 中本地目录中的 eclipse 目录。
6. 重新启动 Eclipse 。
安装完 Example 之后,就可以通过 File > New > Example 中查看 SDK Example 。
对于 SWT(Standard Widget Toolkit) 而言, Examples 中包含了很多实际的例子,其中 Controls Example 中包含了很多 widget 的实际例子。
但是如果要学习如何使用 SWT 的话,最好可以看到这些例子的 source ,这就需要下载 SWT Examples 的 source 了。
下面说明一下如何使用 CVS 客户端 (Eclipse built-in) 获取 Eclipse Project 的 source 。也可以通过 SVN 获取 Eclipse source ,但是目前发布的 Eclipse 中版本控制工具为 CVS ,如果要使用 SVN ,还需要安装 plug-in ,所以笔者以 CVS 为例说明。如何使用 SVN 获取 Eclipse source ,请查看参考资料。
可以通过在线 CVS(http://dev.eclipse.org/viewsvn/index.cgi/ ) 查看 Eclipse project source 的结构,可以通过两种类型的用户获取 Eclipse source :
匿名用户 :适用于想要查看 Eclipse source 或者修改 Eclipse source ,但是不要求 commit 的用户, Eclipse 的所有内容都可以通过匿名用户访问。这对于查看 Eclipse 的 feature 或者进行 bug 调试是非常方便的。匿名用户的 CVS 连接设置如下:
Host dev.eclipse.org
Repository Paths 查看下面的 repository 说明
User anonymous
Password (leave blank)
Connection Type pserver
然后就可以浏览 repository 上面的项目,并添加到本地的 workspace 中。
提交用户:具有提交权限的开发人员拥有各自的用户 id 和密码。提交用户可以使用 SSH 来连接 CVS repository ,提交用户的 CVS 连接设置如下:
Host dev.eclipse.org
Repository Paths 查看下面的 repository 说明
User (your committer user id)
Password (your committer password)
Connection Type extssh
repository 说明: ( 其中 SWT Examples 就包含在 Eclipse platform project 中 )
/cvsroot/eclipse The Eclipse platform project
/cvsroot/tools Tools project
/cvsroot/webtools Web Tools Platform project
/cvsroot/birt BIRT project
/cvsroot/technology Technology project
/cvsroot/rt Runtime project
/cvsroot/tptp TPTP project
/cvsroot/dsdp DSDP project
/cvsroot/datatools Data Tools project
/cvsroot/stp STP SOA tools project
/cvsroot/modeling Modeling project
Other repository paths:
/cvsroot/org.eclipse eclipse.org web sites
其中 SWT Example 项目的部分如下所示:
org.eclipse.swt.examples
org.eclipse.swt.examples.browser
org.eclipse.swt.examples.browser.demos
org.eclipse.swt.examples.controls
org.eclipse.swt.examples.graphics
org.eclipse.swt.examples.launcher
org.eclipse.swt.examples.layouts
org.eclipse.swt.examples.ole.win32
org.eclipse.swt.examples.paint
如果要查看各个控件的使用方法,只添加 org.eclipse.swt.examples 即可。
导入之后,如果有编译错误,那么修改 project 的 build path 属性,将 $eclipse.home/plugins/ org.eclipse.swt.win32.win32.x86_3.5.0.v3550b.jar 添加到 build path 中,或者使用 dependent project 进行依赖。
参考:
Eclipse Download Page: http://www.eclipse.org/downloads/index.php
Get Eclipse Source Code by CVS: http://wiki.eclipse.org/index.php/CVS_Howto
Get Eclipse Source Code by SVN: http://wiki.eclipse.org/SVN_Howto
Installing SDK Examples:
http://help.eclipse.org/stable/index.jsp?topic=/org.eclipse.platform.doc.isv/samples/samples.html