01EAS-BOS开发新手入门-开发环境安装配置

01EAS-BOS开发新手入门-开发环境安装配置LtDKINGDEE第3页共34页EASBOS开发新手入门——开发环境安装配置EAS制造系统部邓文强导读本文档面向设计、开发人员，描述EAS的开发过程中的环境的搭建、配置。EAS的环境配置一直是新手入门的第一道坎，很多新员工都是直接拷贝导师或者其他开发人员的生产环境。对整个EAS目录结构，环境的配置不熟悉，本文档将尽可能详细的介绍环境安装过程，以及开发中会用到的配置文件修改。目的和范围本文档面向设计、开发人员，描述EAS的开发过程中的环境的搭建、配置。EAS的环境配置一直是新手入门的第一道坎，很多新员工都是直接拷贝导师或者其他开发人员的生产环境。对整个EAS目录结构，环境的配置不熟悉，本文档将尽可能详细的介绍环境安装过程，以及开发中会用到的配置文件修改。目录结构EAS6.1的开发环境目录，workplace、workplace_src分别用于存放BOSStudio工程，Eclipse工程。可以根据实际情况，在BOSStudio和Eclipse中更改工作目录。下图是实际开发的一个目录结构：环境安装与配置拷贝安装第一步拷贝目录直接从其他已配置好环境的电脑中将整个目录拷贝到本地磁盘中。这个过程会耗时比较长，但是所需的文件可EAS库表都是最完整的，只需做简单配置就可以启动运行。目录结构如下：第二步制作虚拟盘制作虚拟盘，EAS的运行环境使用了虚拟盘，将EAS所在文件夹映射为W盘。在切换EAS目录时需要重新执行虚拟盘命令。有些项目组还将W:\eas\Server\server\lib虚拟为另一个盘，便于开发环境引用JAR包。Substw:D:\EAS61substv:W:\eas\Server\server\lib虚拟盘W的目录结构是与D:\EAS61目录一致的。可以将此脚本做成bat批处理，在操作系统启动时执行，这样就可以自动创建虚拟盘。注意：虚拟盘必须是W盘，因为EAS中很多脚本、配置文件都直接引用了W盘符，如果本地磁盘有多个EAS版本，每次只能虚拟其中一个版本的目录。PT安装第一步安装admin工具和虚拟磁盘首先，在本地磁盘创建目录，假设是D:\EAS61，同时作为虚拟盘对应的目录，并保证该盘的空间足够大。进入\\7\服务器选取具体的PT环境，只需要拷贝setup.bat文件到本地磁盘D:\EAS61，直接执行就能生成基本的目录结构。与服务器上的PT目录中的文件夹目录结构类似，同时已经完成了虚拟盘W:的创建。注意：如果已经存在W盘，执行过程将卸载虚拟盘，按照新的目录重新虚拟W盘。第二步PT安装执行完成后，进入在w:\admin\pt.bat即可运行pt.bat，开始PT安装。PT主界面出现后，输入1，进入Install菜单输入2（或3）。这一步将安装设计师和开发人员默认的所需工具。如果你只是想安装部分工具，请根据菜单输入相应工具的序号。设计师和开发人员默认将安装Apusic、JDK、Jbuilder、Together、BosStudio、Ant、Junit、eas。同时安装多个工具时，可以为每个工具的安装打开一个PT进程。开发环境中如果需要生成新的库配置文件，需要输入4，在输入6，重新生成EAS库列表。主要用于ECLIPSE开发环境引用。部署运行License导入部署环境的第一步就是导入License，虽然不影响应用服务器的启动，但是会影响客户端的登录和使用。可以进入\\88\无控制Licnese包获取开发用的无控制License包。例如，BOS6.2的License包，可以进入\\88\无控制Licnese包\BOS620_1无控制license\release，直接拷贝Client、Server包覆盖W:\eas中的相应文件。注意：请根据具体的BOS平台版本获取License包，如果没有合适的，可以找部门经理申请。生成EAS库文件生成开发需要的EAS库文件，进入PT安装，执行4->6步骤即可生成，生成的文件如下图所示。在Eclipse环境中导入。客户端设置（非必须）进入W:\eas\Client\client\deploy\client目录，打开perties编辑该配置文件，修改metadata.path加入以下配置：metadata.path=w:/apusic/metas;W:/eas/Server/server/metas/bos/*.jar;W:/eas/Server/server/metas/eas/*.jar;W:/eas/Server/server/metas/mri/*.jar;主要目的是引入w:/apusic/metas目录，该目录用于在开发过程中优先引用BOSStudio发布的元数据。w:/apusic/metas目录可以根据实际情况调整，只要在perties中配置了就可以正确读取。服务器端设置数据源配置进入W:\eas\Server\server\properties目录，配置数据中心，也就是连接的数据库。主要目的是快速将其他同事发过来的数据中心配置导入。<?xmlversion="1.0"encoding="UTF-8"?><datacenters><datacenterid="eas_maf_61_2"version=""disable="false"bindebgateway="false"bindoa="false"ksql="true"tracetype=""encodeurl="true"dbtype="oracle"dbversion=""dbname="easmaf61"dbuser="e6gold61"dbpassword="ksqle:5gPmXywAaTOsArYHTY9yBqa4bGKgosp7"datasource="40:1521"><namelocale="zh_TW">eas_maf_61_2</name><namelocale="zh_CN">eas_maf_61_2</name><namelocale="en"/></datacenter></datacenters>基础设置Bosconfig.xml包含大多数的基础配置，一般不需要更改。listenerconfig.data监听器设置，确保所需要的服务监听器打开了，例如工作流监听器，否则具体功能不能正常使用。<config> <configitemname="listenerconfig"> <listenername="com.kingdee.bos.management.ManagementServletListener"enable="true"failOnError="false"/> <listenername="mon.app.MetaDataLoaderListener"enable="true"failOnError="true"/> <listenername="mon.DCListListener"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.orm.impl.server.ORMRPCServer"enable="true"failOnError="true"/> <listenername="com.kingdee.bos.service.message.agent.BOSMessageService"enable="false"failOnError="false"/> <listenername="com.kingdee.bos.workflow.service.WfServerListener"enable="false"failOnError="false"/> <listenername="com.kingdee.bos.service.scheduler.BOSSchedulerService"enable="false"failOnError="false"/> <listenername="com.kingdee.eas.base.usermonitor.app.UserMonitorRegisterListener"enable="true"failOnError="false"/> <listenername="ctrl.app.NetCtrlListener"enable="true"failOnError="false"/> <listenername="com.kingdee.eas.base.log.app.LogServiceListener"enable="true"failOnError="false"/> <listenername="mon.app.ServiceRegisterListener"enable="true"failOnError="false"/> <listenername="mon.app.ConfigVerifyListener"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.webservice.WSConfigListener"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.ebgateway.server.EbgatewayServerListener"enable="true"failOnError="false"/> <listenername="com.kingdee.eas.framework.bireport.app.servo.BIServoListener"enable="true"failOnError="false"/> <listenername="com.kingdee.eas.base.uiframe.app.LoginContextListener"enable="true"failOnError="false"/> <listenername="com.kingdee.eas.cp.autoupdater.servlet.CreateJnlpListener"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.ctrl.analysis.web.solution.BISolutionListener"enable="true"failOnError="false"/> <listenername="com.kingdee.eas.framework.db.TempTableServerListener"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.config.ServerConfigServiceInitializer"enable="true"failOnError="false"/> <listenername="com.kingdee.bos.event.adapter.BOSEventListener"enable="true"failOnError="false"/> </configitem></config>perties在该文件中加入元数据路径，与客户端原理相同。设置metadata.path参数。metadata.path=w:/apusic/metas;${EAS_HOME}/server/metas/sp-bim-metas.jar;${EAS_HOME}/server/metas/sp/*.jar;${EAS_HOME}/server/metas/industry/*.jar;${EAS_HOME}/server/metas/bos/*.jar;${EAS_HOME}/server/metas/eas/*.jar;${EAS_HOME}/server/metas/mri/*.jar源代码编译目录设置进入W:\eas\dev目录，修改server-user.liblist、client-user.liblist文件，修改为具体的源代码编译目录，例如W:\workspace_src\maf60\bin。改设置的用途是在EAS启动运行过程中，优先引用编译好的class文件，达到开发过程中的实时要求。开发工具BOSStudio简介BOSStudio是基于Eclipse技术，以Eclipse为开发与运行平台，充分利用了Eclipse开放性、平台性、集成性等特性而开发的一套完整的BOS元数据编辑与展现工具，并与Eclipse提供的代码编辑、编译、调试等功能有机结合，从而实现了BOS设计期建模、BOS元数据校验与发布、源代码的编辑、编译、调试、运行等各环节统一在BOSStudio环境中顺利完成。EAS系统是基于BOS平台建立的，因此，原型设计采用BOSStudio，在拷贝开发环境时，已经内置在EAS目录中，位于BOSModular目录。具体使用可以参考BOS开发指南。License导入如果打开BOS时提示没有License，可以自行导入内部开发用的License包。进入\\88\无控制Licnese包\BOSModular无控制license包\6.x将以下文件拷贝到W:\BOSModular\boscommon\eclipse\plugins\com.kingdee.bos.boslicense_6.1.0，将已有文件覆盖即可。Eclipse简介Eclipse是业界著名的工具开发与运行平台，它最初由IBM发起，并逐步发展成不受任何商业机构控制的开源组织。Eclipse是一套强大的、商业质量的工业级整合式开发环境，它由三部分组成：EclipseProject，EclipseToolsProject与EclipseTechnologyProject，每一个Project又都包含各自的子工程，并遵循CPL协议。详细信息请参考Eclipse官方网站：必备插件SVN：Subversive、Subclipse。目前项目组大多数使用Subversive，改插件同时依赖connectorSubversive/subversive/downloads.phpSubclipse/servlets/ProjectProcess?pageID=p4wYuAKBS：直接拷贝W:\BOSModular\kbs\eclipse\plugins目录中的com.kingdee.kbs_2.0.9.jar文件至Eclipse目录中的plugin文件下。该工具用于提交构建，在Eclipse中安装该插件就可以不进入BOS提交构建。Eclipse客户端调试设置Eclipse环境中进行调试时需要配置DEBUG。com.kingdee.eas.base.uiframe.client.LoginFrame注意虚拟机参数设置，必须按照下列顺序，否则启动GUI界面会出错：-DEAS_HOME=w:\eas\Client-DEAS_SERVER=tcp:\\localhost:11034-ms128m-mx256m-Dlog4j.configuration=file:W:\eas\Client\client\deploy