工欲善其事必先利其器,做开发首先要有个好用的开发工具。在这里推荐一个开源工具 Eclipse 集成开发平台。本文介绍如何手动配置 Eclipse 开发环境,以便于快速开发 Smartbi 扩展包,尤其是用于调试后端 Java 代码。
文档目录: |
在这里假设您已经下载并配置好了 Eclipse 开发工具。然后从这里下载 SmartbiPluginApp 项目,将其解压到自己的代码开发工作目录下。启动 Eclipse 工具,然后在“Package Explorer”窗格上点击右键“Import...”,导入刚刚解压的 SmartbiPluginApp 项目。如下图所示。
开发调试环境的原理是这样的:上一步我们在 Eclipse 中加载的 SmartbiPluginApp 项目包含了 apache-tomcat-7.0.42,在其下部署了 smartbi 应用。该 smartbi 应用在运行时,会加载其它扩展包项目,从而让开发人员对其它扩展包项目的代码进行调试。接下来我们需要进行配置,让该 smartbi 正常运行起来。
首先需要从思迈特处申请一个开发用的 Smartbi-License 文件。将取得的 Smartbi-License.xml 文件直接覆盖 /SmartbiPluginApp/apache-tomcat-7.0.42/bin/smartbi/ 目录下的同名文件。
该开发环境下的 smartbi 需要有个知识库,修改 /SmartbiPluginApp/apache-tomcat-7.0.42/bin/smartbi/smartbi-config.xml 文件,设置知识库连接信息,主要修改<dao/>这一段。
<dao> <database-type>MYSQL</database-type> <server-name>localhost:6688</server-name> <database-name>smartbi-dev-ide</database-name> <username>admin</username> <pass>admin</pass> <encrypt-type>0</encrypt-type> <max-count>100</max-count> <init-count>2</init-count> </dao> |
SmartbiPluginApp 项目下已经添加了一个 Run_SmartbiPluginApp 启动配置文件,可以直接在“Debug”、“Run”模式下启动它。
下载回来的 SmartbiPluginApp 项目虽然自带了一个 smartbi,但是其版本比较早。在开发调试时,要求开发所基于的smartbi版本,应该与未来生产环境部署的smartbi版本一致。因此我们还需要升级 /SmartbiPluginApp/apache-tomcat-7.0.42/webapps 路径下的 smartbi,具体升级过程可以参考:Smartbi版本更新。