【手册】向原生XPages说byebye，安装并配置XPages Extension Library
资料简介：
在安装并配置XPages Extension Library之前，我们首先应该了解和清楚3个问题：
1、XPages Extension Library是什么？
回答：XPages Extension Library是OpenNTF上最大和最卓越的一个项目，该项目事实上已经得到了IBM的官方支持，在8.5.3里IBM已经使用了XPages Extentsion Library的内容，如果说XPages是Domino开发技术的一个开发框架，那XPages Extension Library就是XPages这个框架之上的框架，Victor喜欢把没有打XPages Extension Library包的开发方式叫做原生XPages，而打上XPages Extension Library后的开发方式叫做XPages+，从某种程度上来说，举个不是很恰当的例子，Domino开发可以理解为Java，XPages可以理解为是J2EE方向，而XPages Extension Library是Struts。
2、XPages Extension Library的能做什么？
使用过jQuery或者dojo的同学应该对这种JS框架有比较直观的了解，很大程度上XPages Extentsion Library就是在做类似于jQuery和dojo这样的工作，以jQuery为例，jQuery主要是提供了3大类：Core+UI+Plugins，dojo的话是dojo+dijit+dojox，尽管dojox更准确的定位是未完全成熟的控件，但就目前来说基本上也是一个Core+UI+Plugins的模式，而XPages Extension Library实际上是做了UI+Plugins的工作，Core方面目前应该来说还没有涉及到，但XPages本身是不是就可以理解为是Core呢？不知道大家怎么想，Victor是希望有类似于dojo这样的更加强大的扩展出现，这不是没有可能的，因为XPages是基于JSF的，另外Managed Bean是否会成为我理解中的Core呢？关于这方面的问题，我们可以后续讨论，总之XPages Extension Library使得我们可以从UI和Plugins的设计开发工作中得到大大的解脱，这就是XPages Extension Library最大的作用，请千万不要以为XPages Extension Library就是一款SKIN，XPages Extension Library的很多Plugins都是功能性的，几乎拿来就可以实现一个功能需求。
3、原生XPages和打上XPages Extension Library之后的差距有多大？
首先是UI层面来说XPages Extension Library有IBM这种大公司设计的UI，它不仅仅是解决了漂不漂亮的问题，更是解决了布局科学化和浏览器兼容这两个不投入很大功夫很难做到的难题，直接使用和再修改XPages Extension Library的UI的成本很低，我相信XPages Extension Library默认提供的UI设计，很多国内的公司都还做不到，更不要说是以个人或者小全队的层面来说了。
Plugins层面的话，对于XPages来说就是Custom Control，打上XPages Extension Library之后会多出大量有用的CC，而且OpenNTF上还有不少急于XPages Extension Library开发的CC，可以说有没有XPages Extension Library，你实现某一种功能所需的时间差距会很大，而且你是否考虑过稳定性和浏览器的兼容性？XPages Extension Library由于出自专业团队，因此这些问题都被考虑了进去（尽管不能说完全杜绝，但是绝对比咱们使用原生XPages的结果要好很多了。）
在进入正题之前我们通过4张图片的对比来看看差距到底有多大？
图一、原生XPages提供的Control只有这么两大类，加起来也就20不到，方便是方便一些，但是离解决业务问题还差很远
图二、打了XPages Extension Library之后，右边的空间栏都不够用了...
图三、XPages Extension Library的Demo库，你看到的这张页面上的所有元素和布局都是靠Control完成的，只需要大概5分钟就可以自己做一个。
图四、OneUILayout布局控件，来自于IBM专业的UI布局设计，你现在直接就可以用了。
不知不觉为了说明XPages Extension Library，Victor又多说了好多废话，现在言归正传，我们来说说如何安装和配置XPages Extension Library!
步骤一、下载项目压缩包地址是：http://www.openntf.org/internal/home.nsf/releases.xsp?action=openDocument&name=XPages%20Extension%20Library&documentId=523C4281B0889F12862577910060E232
需要特别注意的是，请一定要和自己的Domino及Designer配套（因此你的Domino和Designer版本最好也是一样的），目前是有852和853两条线，请选择自己合适的版本下载最新的即可（如果是851和850，推荐想办法升级上来），其实下载完成后，里面就有非常详细的介绍和安装配置文档，不过是英文的，所以Victor现在给大家一份中文本地化的。
步骤二、XPages Extentsion Library在Lotus Designer的安装配置步骤（以852为例）
1、首先确认安装完毕Lotus Designer 8.5.2。
2、由File-Preference打开Preference对话框，并选择Domino Dsigner，得到以下界面，勾选Enable Eclipse plug-in install选项
3、此时File-Application-Install会被开启，点击Install并得到以下界面，选择Search for new feature to install
4、通过Add Zip/Jar Location按钮选择updateSite.zip的位置，该zip包可以从附件中解压获得
5、安装过程完成后会出现提示重启Designer，请点击重启，重启后请点击Help-About Domino Designer，点击plug-in detail按钮，确认下列4项已经存在。
6、手工解压updateSite.zip包，并将解压内容安装到Lotus Client端的如下位置（注意图片里的地址），并再次重启Designer，到此安装完毕。
步骤三、XPages Extentsion Library在Lotus Domino的安装配置步骤（以852为例）
1、解压附件updateSite.zip文件包，并获得updateSite文件夹，内含features和plugins两个文件夹，以及一个XML文件:site.xml；
2、将features和plugins文件夹，连同site.xml上传至服务器，并放置于以下路径（请按照图示中的层次放置）
3、重启Domino服务器（命令：res s）
4、Domino服务器所有服务启动完毕后，请输入命令：tell http osgi ss com.ibm.xsp.extlib，如果像下图一样获得所有plug-ins的状态（state列）都为"resolved".
最后补充一下，在安装方面852和853的XPages Extension Library安装是大同小异的，但是853的XPages Extension Library里的内容会更多，特别是区分了Domino上和Designer上的updateSite包，不过通过名称还是能直接看出来的：
852版的XPages Extension Library
853版的XPages Extension Library（不要被多出来的东西吓到了，其实应该高兴，因为不仅白送了好几个模板是开包即用的，而且还区分了不同的包是装在Domino上还是Designer上，注意看名称即可快速识别，除了选包的时候稍微留意一下名称外，安装配置步骤和852完全一样）
最后不论是852还是853，将里面的XPagesExt.nsf拷贝到你的服务器上，然后签名，设置好ACL，试着用浏览器赶快看看Demo库吧，如果不过瘾，再去www.openntf.org搜一些应用和控件来看看？（不少是基于XPages Extension Library852或853开发的，因此你如果想使用必须安装了XPages Extension Library，而且要对应好版本）
好了，现在你可以向Domino传统开发Say Goodby，向原生XPages说byebye了，XPages+的广阔天地从此开启！
1、XPages Extension Library是什么？
回答：XPages Extension Library是OpenNTF上最大和最卓越的一个项目，该项目事实上已经得到了IBM的官方支持，在8.5.3里IBM已经使用了XPages Extentsion Library的内容，如果说XPages是Domino开发技术的一个开发框架，那XPages Extension Library就是XPages这个框架之上的框架，Victor喜欢把没有打XPages Extension Library包的开发方式叫做原生XPages，而打上XPages Extension Library后的开发方式叫做XPages+，从某种程度上来说，举个不是很恰当的例子，Domino开发可以理解为Java，XPages可以理解为是J2EE方向，而XPages Extension Library是Struts。
2、XPages Extension Library的能做什么？
使用过jQuery或者dojo的同学应该对这种JS框架有比较直观的了解，很大程度上XPages Extentsion Library就是在做类似于jQuery和dojo这样的工作，以jQuery为例，jQuery主要是提供了3大类：Core+UI+Plugins，dojo的话是dojo+dijit+dojox，尽管dojox更准确的定位是未完全成熟的控件，但就目前来说基本上也是一个Core+UI+Plugins的模式，而XPages Extension Library实际上是做了UI+Plugins的工作，Core方面目前应该来说还没有涉及到，但XPages本身是不是就可以理解为是Core呢？不知道大家怎么想，Victor是希望有类似于dojo这样的更加强大的扩展出现，这不是没有可能的，因为XPages是基于JSF的，另外Managed Bean是否会成为我理解中的Core呢？关于这方面的问题，我们可以后续讨论，总之XPages Extension Library使得我们可以从UI和Plugins的设计开发工作中得到大大的解脱，这就是XPages Extension Library最大的作用，请千万不要以为XPages Extension Library就是一款SKIN，XPages Extension Library的很多Plugins都是功能性的，几乎拿来就可以实现一个功能需求。
3、原生XPages和打上XPages Extension Library之后的差距有多大？
首先是UI层面来说XPages Extension Library有IBM这种大公司设计的UI，它不仅仅是解决了漂不漂亮的问题，更是解决了布局科学化和浏览器兼容这两个不投入很大功夫很难做到的难题，直接使用和再修改XPages Extension Library的UI的成本很低，我相信XPages Extension Library默认提供的UI设计，很多国内的公司都还做不到，更不要说是以个人或者小全队的层面来说了。
Plugins层面的话，对于XPages来说就是Custom Control，打上XPages Extension Library之后会多出大量有用的CC，而且OpenNTF上还有不少急于XPages Extension Library开发的CC，可以说有没有XPages Extension Library，你实现某一种功能所需的时间差距会很大，而且你是否考虑过稳定性和浏览器的兼容性？XPages Extension Library由于出自专业团队，因此这些问题都被考虑了进去（尽管不能说完全杜绝，但是绝对比咱们使用原生XPages的结果要好很多了。）
在进入正题之前我们通过4张图片的对比来看看差距到底有多大？
图一、原生XPages提供的Control只有这么两大类，加起来也就20不到，方便是方便一些，但是离解决业务问题还差很远
图二、打了XPages Extension Library之后，右边的空间栏都不够用了...
图三、XPages Extension Library的Demo库，你看到的这张页面上的所有元素和布局都是靠Control完成的，只需要大概5分钟就可以自己做一个。
图四、OneUILayout布局控件，来自于IBM专业的UI布局设计，你现在直接就可以用了。
不知不觉为了说明XPages Extension Library，Victor又多说了好多废话，现在言归正传，我们来说说如何安装和配置XPages Extension Library!
步骤一、下载项目压缩包地址是：http://www.openntf.org/internal/home.nsf/releases.xsp?action=openDocument&name=XPages%20Extension%20Library&documentId=523C4281B0889F12862577910060E232
需要特别注意的是，请一定要和自己的Domino及Designer配套（因此你的Domino和Designer版本最好也是一样的），目前是有852和853两条线，请选择自己合适的版本下载最新的即可（如果是851和850，推荐想办法升级上来），其实下载完成后，里面就有非常详细的介绍和安装配置文档，不过是英文的，所以Victor现在给大家一份中文本地化的。
步骤二、XPages Extentsion Library在Lotus Designer的安装配置步骤（以852为例）
1、首先确认安装完毕Lotus Designer 8.5.2。
2、由File-Preference打开Preference对话框，并选择Domino Dsigner，得到以下界面，勾选Enable Eclipse plug-in install选项
3、此时File-Application-Install会被开启，点击Install并得到以下界面，选择Search for new feature to install
4、通过Add Zip/Jar Location按钮选择updateSite.zip的位置，该zip包可以从附件中解压获得
5、安装过程完成后会出现提示重启Designer，请点击重启，重启后请点击Help-About Domino Designer，点击plug-in detail按钮，确认下列4项已经存在。
6、手工解压updateSite.zip包，并将解压内容安装到Lotus Client端的如下位置（注意图片里的地址），并再次重启Designer，到此安装完毕。
步骤三、XPages Extentsion Library在Lotus Domino的安装配置步骤（以852为例）
1、解压附件updateSite.zip文件包，并获得updateSite文件夹，内含features和plugins两个文件夹，以及一个XML文件:site.xml；
2、将features和plugins文件夹，连同site.xml上传至服务器，并放置于以下路径（请按照图示中的层次放置）
3、重启Domino服务器（命令：res s）
4、Domino服务器所有服务启动完毕后，请输入命令：tell http osgi ss com.ibm.xsp.extlib，如果像下图一样获得所有plug-ins的状态（state列）都为"resolved".
最后补充一下，在安装方面852和853的XPages Extension Library安装是大同小异的，但是853的XPages Extension Library里的内容会更多，特别是区分了Domino上和Designer上的updateSite包，不过通过名称还是能直接看出来的：
852版的XPages Extension Library
853版的XPages Extension Library（不要被多出来的东西吓到了，其实应该高兴，因为不仅白送了好几个模板是开包即用的，而且还区分了不同的包是装在Domino上还是Designer上，注意看名称即可快速识别，除了选包的时候稍微留意一下名称外，安装配置步骤和852完全一样）
最后不论是852还是853，将里面的XPagesExt.nsf拷贝到你的服务器上，然后签名，设置好ACL，试着用浏览器赶快看看Demo库吧，如果不过瘾，再去www.openntf.org搜一些应用和控件来看看？（不少是基于XPages Extension Library852或853开发的，因此你如果想使用必须安装了XPages Extension Library，而且要对应好版本）
好了，现在你可以向Domino传统开发Say Goodby，向原生XPages说byebye了，XPages+的广阔天地从此开启！
2012-08-23
浏览16998
下载44
已下载用户的评价7.73分
您还未下载该资料，不能发表评价；
查看我的 待评价资源
查看我的 待评价资源
没用
[b]回复 [url=http://www.lotuschina.net/club/redirect.php?goto=findpost&pid=74469&ptid=3023]52#[/url] [i]shelleychen[/i] [/b] 版主，帮忙解答一下这几个问题，谢谢！
[b]回复 [url=http://www.lotuschina.net/club/redirect.php?goto=findpost&pid=74469&ptid=3023]52#[/url] [i]shelleychen[/i] [/b] 版主，帮忙解答一下这几个问题，谢谢！
没用
[b]回复 [url=http://www.lotuschina.net/club/redirect.php?goto=findpost&pid=9898&ptid=3023]1#[/url] [i]victor_armin[/i] [/b] 我在安装8.5.3的Xpage时，遇到如下问题： 1.我下载的是 853.20130315-0724，最新版本如下图所示： [attach]220571[/attach] [attach]11037[/attach] 2。步骤二的第6点“手工解压updateSite.zip包，并将解压内容安装到Lotus Client端的如下位置（注意图片里的地址），并再次重启Designer，到此安装完毕。”，这样做的目的是什么？我下载的安装包里没有updateSite.zip包，如下图所示： [attach]11039[/attach] 3.我安装完之后，缺少“Extended Controls”,"Other Controls"和"Custom Controls"。要怎样所那3个模块加上去？如下图所示： [attach]11041[/attach] 谢谢！
[b]回复 [url=http://www.lotuschina.net/club/redirect.php?goto=findpost&pid=9898&ptid=3023]1#[/url] [i]victor_armin[/i] [/b] 我在安装8.5.3的Xpage时，遇到如下问题： 1.我下载的是 853.20130315-0724，最新版本如下图所示： [attach]220571[/attach] [attach]11037[/attach] 2。步骤二的第6点“手工解压updateSite.zip包，并将解压内容安装到Lotus Client端的如下位置（注意图片里的地址），并再次重启Designer，到此安装完毕。”，这样做的目的是什么？我下载的安装包里没有updateSite.zip包，如下图所示： [attach]11039[/attach] 3.我安装完之后，缺少“Extended Controls”,"Other Controls"和"Custom Controls"。要怎样所那3个模块加上去？如下图所示： [attach]11041[/attach] 谢谢！