软件用户手册（软件使用说明书）

Size: px

Start display at page:

Download "软件用户手册（软件使用说明书）"

窗货苍
7 years ago
Views:

1 WebXone 网络开发平台使用指南 ( ) 碧树西风工作室 QQ 讨论群 : 百度贴吧 :

2 目录 1. 概述目标功能特点使用说明部署网络服务器环境采用 Delphi 开发 WebXone 应用网络访问免费使用开发模式 C++ Builder 开发 WebXone 应用 Visual C++ 开发 WebXone 应用相关系统支持浏览器支持客户端操作系统支持开发工具支持服务器操作系统支持服务器服务程序支持数据库系统支持三层中间件支持常见问题...21 注册用户是否支持后续版本升级? 客户端是否支持移动平台? 后续是否有移动平台支持开发计划? 能不能在 Linux 服务器上部署?...21 是否支持几百人甚至更多用户同时在线? 为什么载入失败, 出现 126 错误? 采用 IIS 网络服务, 为什么提示找不到 wxo? 如何通过 wxoconfig 打包多个文件 ( 包括一些配置文件和动态链接库 )? 如何通过 URL 传递参数? 应用程序比较大, 客户端是否会因每次都要加载, 造成启动时间长? WebXone 应用是否可以读取本地端口, 如操作串口或操作打印机?...23 如何修改页面标题?...23 如何关闭页面?...23 是否支持 MDI? 如何使 URL 更短?...24 是否可以自定义安装目录? 是否可以对 setup.exe 中的相关信息进行定制? 最近更新使用协议免费使用标准版...27

3 1.3 企业版...28 附件 : IIS 使用时报找不到 WXO 时的解决办法 Win7 非管理员用户关闭 UAC 操作打包部署工具 wxoconfig 简介... 30

4 1. 概述 WebXone 是一个面向 RIA(Rich Internet Applications, 富互联网应用 ) 的快速开发平台是集桌面应用程序的最佳用户界面功能与 Web 应用程序的普遍采用和快速低成本部署及互动多媒体通信的实时快捷于一体的新一代网络应用程序采用 WebXone 技术, 可以用 Delphi/CBuilder/VC 等常用桌面应用程序工具快速开发出适用于网络的应用程序系统 WebXone 基于 Delph/CBuilder/VC 等成熟的开发平台, 兼容所有 VCL 控件, 并采用统一的系统接口, 可以快速构建高效运行的网络应用系统 WebXone, 让网络开发快捷高效! 让网络应用运行如飞! 1.1 目标使用户能够采用 Delph/CBuilder/VC 轻松实现 B/S 编程 1.2 功能特点直接采用 Delph/CBuilder/VC 等编程工具开发网络程序兼容所有 Delph/CBuilder 的 VCL 控件支持直接转换 C/S 程序到 B/S 程序极高的运行效率, 媲美 C/S 程序简单快捷的网络部署方法

兼容所有主流浏览器, 包括 IE Chrome FireFox Safari 和 Opera Maxthon 360 浏览器猎豹浏览器等 ; 2. 使用说明 2.1 部署网络服务器环境 (1) 下载开发包开发包下载 :http://www.web0000.

5 兼容所有主流浏览器, 包括 IE Chrome FireFox Safari 和 Opera Maxthon 360 浏览器猎豹浏览器等 ; 2. 使用说明 2.1 部署网络服务器环境 (1) 下载开发包开发包下载 : (2) 解压并复制解压 webxone.zip, 将其中 WWW 目录复制到 C 盘根目录 ( 此处可复制到任意目录, 仅以 C 盘根目录为例说明 ), 如图 (3) 运行服务器程序运行开发包自带的服务器程序 WebServ.exe, 如图 :

6 选择解除阻止后, 运行界面如下此时,WebXone 的网络环境就已经搭建完成注 :WWW 目录不是必须在 C 盘根目录 ; 也可以采用 IIS 或 Apache 代替 WebServ 不过为了更好地说明问题, 防止歧义, 建议初学者尽量采用同样的设置

$然后保存工程为 hello.dpr, 文件目录为 C:\hello ( 暂时不要写别的代码 ) (2) 改造成 WebXone 应用复制 WebXone 开发包中的 public 目录的 wxounit.pas 和 wxoexec.pas 到 C:\hello, 如图$

7 2.2 采用 Delphi 开发 WebXone 应用以 Delphi 7 为例介绍开发流程 (1) 开发普通 Delphi 应用程序新建一个 Application, 然后在 form1 中放置一个 label1, 设置其 Caption 为 Hello,World! 然后保存工程为 hello.dpr, 文件目录为 C:\hello ( 暂时不要写别的代码 ) (2) 改造成 WebXone 应用复制 WebXone 开发包中的 public 目录的 wxounit.pas 和 wxoexec.pas 到 C:\hello, 如图

8 在 unit1.pas 中增加对 wxoexec 和 wxounit 的引用, 如图然后在 OnCreate 事件中加入 wxoprepare, 即 procedure TForm1.FormCreate(Sender: TObject); begin wxoprepare(handle,application.handle); end; 再编译成生成 EXE 即可 ( 用 F9 会出现一闪而过的现象, 属正常 )

$exe ( 工具栏下方 ) 选择输出目录 (Outpur Dir ) 为 C:\WWW ( 工具栏第一个工具按钮 ) 选择应用为 C:\hello\hello.$

9 (3) 部署到服务器运行 WebXone 开发包中的 Tools 目录中的 wxoconfig.exe ( 工具栏下方 ) 选择输出目录 (Outpur Dir ) 为 C:\WWW ( 工具栏第一个工具按钮 ) 选择应用为 C:\hello\hello.exe, 如图选择菜单 :Edit->Select All, 然后菜单 :Edit->Remove, 结果如图然后, 菜单 Generate, 会弹出一个对话框, 如图

这个是注册提示对话框, 不管它, 稍等 5 秒点 Continue 此时部署完成 2.3 网络访问打开 IE, 在地址栏输入 http://127.0.

10 这个是注册提示对话框, 不管它, 稍等 5 秒点 Continue 此时部署完成 2.3 网络访问打开 IE, 在地址栏输入注意 : 这里端口为 8080 此时应出现 WebXone 插件安装界面 ( 仅第一次时出现 ), 如图

11 点击这里, 下载 setup.exe 并运行注意 : 有些系统安装有迅雷等辅助下载软件, 请在下载的目录中找到 setup.exe 并运行点击运行点击下一步

12 安装完成, 点击完成, 然后刷新页面此时, 就可以看到刚才所写的应用程序 Hello,World 了, 如图

13 2.4 免费使用开发模式 1 运行 Delphi 7, 菜单 File New Application, 创建一个应用程序并添加一个 Label 控件, 设置 Caption 为 Hello!WebXone, 设置合适的字体 Font 保存 unit 为 Main.pas, 窗体名为 Form_WXO, 工程 (Project) 名为 HeyWebXone.dpr 确保能正常编译通过 2 打开 WebXone 开发包解压缩包中的 public 目录, 复制其中的文件 wxodemo.dpr 和 wxounit.pas 到 HeyWebXone.dpr 所在目录 3 采用 Delphi7 打开 wxodemo.dpr, 直接编译, 应显示以下界面

$4 此时 HeyWebXone.dpr 所在目录内应该生成一个文件 wxodemo.wxo 复制该文件到 C:\WWWW\ 5 打开 IE, 输入 http://127.0.0.1/index.htm?wxodemo 即可 2.$

14 4 此时 HeyWebXone.dpr 所在目录内应该生成一个文件 wxodemo.wxo 复制该文件到 C:\WWWW\ 5 打开 IE, 输入即可 2.5 C++ Builder 开发 WebXone 应用以下以 C++ Builder6 为例介绍开发流程 1 运行 C++ Builder6, 菜单 File New Application, 创建一个应用程序并添加一个 Label 控件, 设置 Caption 为 Hello,World! 保存文件为 unit1.cpp, 保存 project 名为 cb.dpr; 2 复制 WebXone 开发包中的 public 目录的 wxoexec.cpp 到 cb.dpr 所有目录 ;

15 3 菜单 Project Add to project, 选择 wxoexec.cpp; 4 在 unit1.cpp 中增加引用 #include wxoexec.h 5 在 OnCreate 事件中增加代码 wxoprepare((unsigned int)handle,(unsigned int)application->handle); 如图再编译成生成 EXE 即可 ( 用 F9 会出现一闪而过的现象, 属正常 ) 6 后续的打包部署等请参见 2.2 相应部分 2.6 Visual C++ 开发 WebXone 应用以下以 Visual C++ 6 为例介绍开发流程 1 运行 Visual C++ 6, 选择菜单 File -> New, 选择 MFC AppWizard(exe) ; 2 选择基本对话框 (dialog), 然后完成 (finish), 如图

$3 复制开发包中 public\vc 文件夹中 wxoexec.cpp 和 wxoexec.$

16 3 复制开发包中 public\vc 文件夹中 wxoexec.cpp 和 wxoexec.h 到工程目录 ; 4 在 Visual C++6 的对话框界面中右键, 选择建立类向导, 如图

17 5 在弹出的对话框中双击 WM_SHOWWINDOW, 然后双击下框内的 OnShowWindow 行, 如图

18 6 在 hellovcdlg.cpp 中加入 #include "wxoexec.cpp"; 7 在 OnShowWindow 事件中加入 wxoprepare((unsigned int)this->getsafehwnd(),(unsigned int)this->getsafeowner()); 如图 8 编译生成 hellovc.exe, 并复制该文件到一空白文件夹中 ; 9 复制 Visual C++6 的三个基本运行支持库 MFC42D.dll, MFCO42D.dll 和 MSVCRTD.dll 到上述的文件夹内 ; 10 运行 wxoconfig.exe 文件, 并选中上述文件夹内的 hellovc.exe, 选择相应的 Output Dir, 点击 generate 生成, 如图

11 打开 IE, 在地址栏输入 http://127.0.0.1:8080/index.htm?hellovc 即可实现访问 3. 相关系统支持 3.

19 11 打开 IE, 在地址栏输入即可实现访问 3. 相关系统支持 3.1 浏览器支持支持 IE Chrome FireFox Safari Opera 等所有主流浏览器支持搜狗 ( 兼容模式 ) 360 猎豹傲游 QQ 等国产浏览器推荐 Chrome 浏览器

20 3.2 客户端操作系统支持客户端支持 Window 2000/Win 2003/Win Xp/Win7 32/Win7 64/Win8 目前客户端不支持 ios Linux 和 Android 注 :Win7 非管理员用户需要关闭 UAC 具体关闭 UAC 操作参见附件 3.3 开发工具支持支持所有版本 Delphi 支持所有版本 C++Builder 支持所有版本 Visual C++ 目前易语言正在进行最后测试推荐 Delphi7 3.4 服务器操作系统支持服务器操作系统支持所有操作系统, 包括 Windows 系列 Linux 系统和 Apple 系列 3.5 服务器服务程序支持服务器支持所有服务程序, 包括 IIS Apache 和其它系列, 推荐超小型服务程序 netbox 上述文档中采用的自制 WebServ, 不是必须的, 可以替换其中 IIS 需要添加 mime 详见附件

21 3.6 数据库系统支持支持所有数据库系统 3.7 三层中间件支持支持所有三层中间件, 包括 RTC,RO 推荐国产优秀三层插件 RemoteADO 和 QuickBurro. 4. 常见问题为什么我的应用没有占满整个屏幕或超出了屏幕? 答 : 把主窗体的 align, position 和 windowstate 属性设为默认即可注册用户是否支持后续版本升级? 答 : 终身免费升级客户端是否支持移动平台? 答 : 不支持后续是否有移动平台支持开发计划? 答 : 拟研发一个类似 unigui 的版本 :WebXoneJS 具体内容和时间待定

22 能不能在 Linux 服务器上部署? 答 : 可以!webXone 演示网站就部署在 Linux 服务器上是否支持几百人甚至更多用户同时在线? 答 : 支持! 有用户基于 WebXone 开发了支持几万人使用的系统为什么载入失败, 出现 126 错误? 答 : 因为在应用中使用了某些附属文件 ( 如 DLL), 但在客户端却不存在, 需要在用 WXOCofig 打包时增加该文件采用 IIS 网络服务, 为什么提示找不到 wxo? 答 : 请参见附件 1 如何通过 wxoconfig 打包多个文件 ( 包括一些配置文件和动态链接库 )? 答 : 把 WebXone 应用程序 (wxo 或 exe) 以及其他的相关文件 ( 配置文件,dll 等 ) 复制到一个新的空目录中, 然后用 wxoconfig 打开应用程序 (wxo 或 exe), 直接 generate 即可注意 : 输出目录应为网络目录如何通过 URL 传递参数? 答 : 可以通过类似以下的网址传递参数 ( 仅举例, 网址不可用 )

23 该网址将打开 main 应用程序中可以得到网址到变量 gsurl, 然后在程序中解析即可注意分隔符为 && 应用程序比较大, 客户端是否会因每次都要加载, 造成启动时间长? 答 :WebXone 采用的智能压缩载入机制, 在客户端第一次访问时, 加载压缩后的程序, 然后自动解压后运行 ; 以后客户端访问时客户端自动比较本地和服务器端文件, 如果服务器端未更新, 则客户端可以直接运行, 没有二次加载问题 WebXone 应用是否可以读取本地端口, 如操作串口或操作打印机? 答 : 可以操作本地端口, 包括串口并口 USB 打印机等如何修改页面标题? 答 : 通过 wxoexec 中的 wxosendmessage 通过调用 JavaScript 代码来实现, 其中 //Delphi 代码 wxosendmessage(giapp, Handle, 'RNJS', Handle, 'window.document.title = "'+Edit1.Text+'"'); //C 代码 wxosendmessage(giapp,_wxo_mainformhandle,"rnjs",_wxo_mainformhandle, "window.document.title = 'new title';");

24 如何关闭页面? 答 : 通过 wxoexec 中的 wxosendmessage 通过调用 JavaScript 代码来实现, 一般直接用 wxoclose 函数即可是否支持 MDI? 答 : 支持如何使 URL 更短? 答 : 如果应用名为 default.wxo 或 default.exe, 部署后可以不加? 及后面的应用名直接访问 WebXonem 网络应用, 比如如果想进一步缩短, 可以通过 IIS 或 Apache 的配置直接通过类似访问是否可以自定义安装目录? 答 : 目前不支持, 后续的版本可能会增加此项功能是否可以对 setup.exe 中的相关信息进行定制? 答 : 可以! 注册用户可以得到 setup.exe 的 innosetup 格式源码, 可以自行修改插件名称研发公司版本号等信息

25 5. 最近更新 version 增加了直接嵌入 EXE 功能, 完全兼容所有 VCL 控件 ( 强烈推荐 ); 2 增加了支持 MDI 的功能 ; 3 增加了异常情况下 WXO 自动退出功能 ( 主要针对部分小众浏览器 ); 4 更新了 setup.exe, 解决了升级安装时忘记关闭浏览器的问题 ; version 增加了对退出时的异常处理, 更好地兼容 VCL 控件 ; 2 增加了运行 JavaScript 的功能 ; 3 增加了对主窗体 OnClose 等的处理 ; 4 增加了数字签名 ; 5 解决了 360 报毒的问题 ; 6 解决了在 FireFox 等中易造成卡死的 BUG; 7 采用了 MD5+ 文件大小 + 时间双重校验, 更加稳定 ; version

26 1 兼容所有主流浏览器, 包括 IE Chrome FireFox Safari 和 Opera; 2 增加了非主窗体 (Form) 的自动嵌入功能 ; 3 取消了注册限制, 对所有的个人开发使用免费, 无任何限制 ; 4 增加了用于调试的轻量级服务器程序 WebServ, 用于快速系统调试 ; 5 增加了附属文件载入模式, 在原有模式基础上增加了载入不更新模式 ; 6 重新设计了 wxounit, 使从普通程序到 WebXone 的转换更方便快捷 ; 7 采用了 MD5 进行了更新校验, 比原来的文件大小 + 时间校验更加科学 ; version 采用了模块化结构, 使系统可以平滑升级 ; 2. 修改了载入目录, 以解决 Orcale 等软件对目录的要求 ; version 对单 WXO 模式应用免费 2. 对附属文件不多于 5 个的应用免费 3. 修改了注册模式, 注册后可无限发布应用, 开发和发布均不绑定计算机 4. 支持定制安装界面 ( 提供 index.htm 源码 ) version 2.0

27 1. 增加了多附属文件部署 ; 2. 增加了压缩载入功能, 大大提升了载入速度 ; 3. 采用了智能载入技术, 使二次载入时间几乎为零 ; 4. 进一步对第三方控件 (cxgrid 等 ) 进行了测试 ; Version 增加了 Hello,World! 等例程 ; 2. 解决了不能生成目录的 Bug; 3. 解决了少数 LoadLibrary 不成功的 bug; Version 1.0 完成了 WebXone 1.0, 可以采用 Delphi 等工具生成网络应用程序 6. 使用协议 1.1 免费使用采用免费使用开发模式特点 : 支持单文件 (.wxo) 部署 ;

28 1.2 标准版可以一次发布包括多个文件的应用支持单文件部署 ; 支持多文件智能压缩部署 ; 部署打包操作 (wxoconfig.exe) 限定在特定计算机上运行 ; 免费获得 WebServ.exe 的 Delphi 源码和控件 ; 免费获得 setup.exe 的 innosetup 格式源码 ; 免费获得 CRM 源码 (Delphi) 一套 ; 1.3 企业版可以一次发布包括多个文件的应用支持单文件部署 ; 支持多文件智能压缩部署 ; 部署打包操作 (wxoconfig.exe) 可以在多台计算机上运行 ; 免费获得 WebServ.exe 的 Delphi 源码和控件 ; 免费获得 setup.exe 的 innosetup 格式源码 ; 免费获得 CRM 源码 (Delphi) 一套 ; 免费赠送 RemoteADO 标准版一套 ( 售后服务由原开发者负责 )

$wa,.xml,.wxo) Mime 类型选 application/vnd.rn-realmedia 即可 2. Win7 非管理员用户关闭 UAC 操作在运行里直接输入 C:\Windows\System32\UserAccountControlSettings.$

30 附件 : 1. IIS 使用时报找不到 WXO 时的解决办法原因 : IIS 限定了下载 WXO 文件到本地, 所以本地找不到 WXO 解决办法 : 通过修改 IIS 里的 HTTP 头信息来实现, 主要通过修改 MIME 信息来实现, 主要需要增加 4 种类型 (.wx,.wa,.xml,.wxo) Mime 类型选 application/vnd.rn-realmedia 即可 2. Win7 非管理员用户关闭 UAC 操作在运行里直接输入 C:\Windows\System32\UserAccountControlSettings.exe, 可以直接

31 弹出 UAC 设置的窗口, 然后拨到从不通知部分用户需要重新启动计算机打包部署工具 wxo wxoconfig 简介 wxoconfig 是一个对 WebXone 应用 ( 即.wxo 文件或经过处理的.exe 文件 ) 及其附属文件进行打包并部署的工具通过 wxoconfig 打包后部署的 WebXone 应用在客户端时进行访问时速度更快, 而且在客户端第二次进入时不需要再进行载入, 可以极速载入基本操作如下 : (1) 准备工作新建一个文件夹, 将拟打包 WebXone 应用 ( 即.wxo 文件或经过处理的.exe 文件 ) 及其附属文件复制到该文件夹中 ; (2) 启动程序运行 wxoconfig (3) 选择拟输出的文件夹 Output Dir, 即包括 index.htm default setup.exe 的文件夹 ; (4) 选择 WXO 选择这个.wxo 文件或经过处理的.exe 文件 (5) 管理附属文件可以通过菜单 Edit--->Delete 删除选中的附属文件 (6) 配置附属文件可以通过菜单 Edit--->Set current file Load... 来配置当前附属文件其中, Load Automatic 为默认选项, 表明客户端自动从服务器端载入

32 该文件, 并在服务器端更新后重新载入 Load Manual 表明客户端不自动从服务器端载入该文件, 需要用户手动从客户端载入该文件采用函数 GetAttachFile 完成, 类似 GetAttachFile(Url,2); 第一个参数为当前 URL, 第二个参数为附属文件 ID 号 Load and No update 表明客户端自动从服务器端载入该文件, 并在服务器端更新后不重新载入 6 打包部署菜单 Generate 生成打包后的文件夹, 并复制到拟部署的文件夹中