E3 SDK 安装説明 (二次开发环境建置)E3二次开发环境包含了一套E3单机版，iReport报表设计工具及演示客制项目(原始码)， 开发问题可以在论坛上做讨论。下面会说明如何配合Eclipse环境开发。作业平台：Linux、MS-Windows、Mac ...等 数据库：支援 MySQL，PostgreSQL，MSSQL 必需环境：要先安装好 JAVA JRE，数据库系统 版本版序：V140
E3 SDK安装及设定１：E3 SDK安装档名为 e3-sdk.jar，直接用鼠标在 e3-book.jar 上点二下。 如果无法开启安装画面，而且确定有装JAVA时， 可以用鼠标停在安装档上，再点鼠标右键操作选单 [开启文件] / [Java(TM) PlatForm SE binary] 的方式来启动安装程序。这里可以选择 繁体中文、简体中文、以及英文；三种语言显示画面。
２：按下 [是]，出现设定安装位置的画面。建议不改用默认位置。 再按下 [安装]，会开始复制文件到指定的位置。复制完成后再按下 [确定] 来结束安装。 
３：复制好后，要加入 JAVA_SDK_PATH 的Windows环境变数。 因为SDK中的批次档会以 JAVA_SDK_PATH 指定的路径运行JAVA指令。 环境变数加入方式： ３-1：在桌面上 [我的电脑] 用鼠标右键按一下，再按 [内容]。 ３-2：再按 [进阶]，再按 [环境变数]。  ３-3：按一下 [新增] 以新增变数名称和值。 
４：接下来运行 C:\dasamx_dev\setup.bat 批次档。 进行开发工作数据库新建设定，各参数设定可以参考E3安装设定。 
回到上一页 我要到E3讨论区 Eclipse开发建置１：启动 Eclipse，建立新的Eclipse工作区；例如 dasamx_eclipse。
２：新增一个名称为 e3_jars 的项目参照用E3程序库。 按选单 [Window / Preferences / Java / Build Path / User Libraries] 中设定。 新增 C:\dasamx_dev\pub\web\xclient\，C:\dasamx_dev\pub\web\WEB-INF\lib 二个目录的所有jar档。 注意！不要勾选 System Library。 
３：接下来建立 Eclipse 项目。按主选单 [File / New / Java Project] 出现项目画面， 选取 [Create project from existing source]。 Project name 填写 cmz_001 Directory 选取 C:\dasamx_dev\project\cmz_001 目录 接下来按 [Finish] 键结束画面。 
４：接下来做项目设定；按选单 [Project / Properties] 会出现项目属性窗口。 ４-1：[Resource / Text file encoding] 选 Other 设定用 UTF-8 码。 ４-2：[Java Build Path / Libraries / Add Library]，加入自定库 e3_jars。 
４-3：[Java Build Path / Libraries / Add Class Folder]，加入项目resource目录 ４-4：[Java Build Path / Order and Export]，把4-3加入的resource目录， 移到介於 src 和 e3_jars 之间，否则会无法链接客制套件。 
设好后按下 [OK]，结束设定。
５：设定项目工作参数；修改项目下的 resource/xconfig.cfg 档， 每个项目都要个别设定，确定项目连接的数据库名称、使用者、密码。 以及各暂存目录的路径，路径不必手动建立，E3运行时系统会自动建立。 ６：接下来运行E3；按一下 com.dasam.e3010001.client.MainFrame.java， 再按选单 [Run / Run] 会出现E3登录画面。 PosFrame.java 启动前台POS程序。 
在原始码窗口有使用 static member 的黄色 Warnings, 可以在 [Window / Preferences / Java / Compiler / Errors/Warnings / Non-static access...] 中设定。
７：进入E3后，要打开所有的选单，请看E3启动说明。 更多操作细节请看E3手册。 开启完整选单后，可以看到 [客制] 的选单区块，这些功能就是 cmz_001 项目的客制程序。 
８：运行 cmz_001 的客制项目，还要先更新MySQL针对这个项目做的异动。 运行E3选单 [系统管理 / 系统维护管理 / 指令维护工作] 再打入 database.update.cmz 后再按 [运行]。 会运行 C:\dasamx_dev\project\cmz_001\resource\cmz.sql 的SQL指令档(UTF8文档)。 完成后，可以运行客制的程序功能了。 
E3网络版主机可以copy到 C:\dasamx\e3010001\web\WEB-INF\classes\cmz.sql 再运行指令。客制项目原始码的基本延伸设计主要是 com.dasam.e3010001.client.SystemDataCmz.java 这支程序原始码；所以看项目原始码建议从这支程序码开始看起。 回到上一页 我要到E3讨论区 iReport报表设计先设定好 JAVA_SDK_PATH 的系统环境变数。再运行 C:\dasamx_dev\ireport.bat 可以开启 iReport 的报表设计工具。 项目中的报表格式档为 fmt 副档名， 放在 cmz_001\resource\com\dasam\e3010001\client\rpt\fmt 目录中， 建议不要改变存放位置。 
回到上一页 我要到E3讨论区 建立客制新项目１：复制 project\cmz_000 目录。２：更改目录名称，例如 cmz_002。 ３：修改 client_jar.bat，server_jar.bat；把文档里 cmz_000 为 cmz_002。 ４：修改 resource/xconfig.cfg 的 system.database_connect 参数，修改数据库连线。 
回到上一页 我要到E3讨论区 客制JAR档封装发行client_jar.bat，server_jar.bat 可以分别封装 Client，Server 的二个jar档。client_jar.bat： 封装 e3010001_cusxc.jar，复制到 C:\dasamx\e3010001\web\xclient server_jar.bat： 封装 e3010001_cusxs.jar，复制到 C:\dasamx\e3010001\web\WEB-INF\lib 
上线中的网络版项目发行步骤： １：开启正式版E3的 [系统管理 / 系统维护管理 / 指令维护工作] ２：运行指令 upload.cmz.client (上传e3010001_cusxc.jar) ３：运行指令 upload.cmz.server (上传e3010001_cusxs.jar) ４：停止 Tomcat Server (可以修改jar_update.bat自动停止和启动) ５：运行主机批次档 C:\dasamx\e3010001\util\jar_update.bat 回到上一页 我要到E3讨论区 |
|||
