一. 部署配置说明 X5版本支持 v3.6pre版本以上；（WeX5在2016-08-11发布最新的v3.6pre版本之后，平台自带PushServer）； PushServer配置 修改JUSTEP_HOME/conf/server.xml文件，将其中的push-server和mqtt-server注释放开： <push-server>http://localhost:8080/PushServer</push-server> <mqtt-server>tcp://localhost:1883</mqtt-server> 在PushServer上部署苹果证书 将苹果证书的p12文件复制到JUSTEP_HOME/runtime/PushServer/WEB-INF/cert目录下，并修改JUSTEP_HOME/runtime/PushServer/WEB-INF/justep.xml文件中的 <class certPath="/WEB-INF/cert/push.x5.p12" certPassword="justep" isDev="false">com.justep.push.processor.APNsMessageProcessor</class> 其中： certPath: 证书路径 certPassword: 证书的密码 isDev: 是否是开发证书 修改Actor服务器上配置的消息服务器地址 修改 dangchat-server/conf/server.conf其中的server-uri, 指向消息服务器的地址    ： justep { push { [...]

1.选择应用模式 调试推荐模式三，发布推荐模式一或模式二 应用名可以是英文、中文或其他合法字符（显示在手机应用图标下） 2.设置服务地址和选择UI资源 Web服务地址：根据需要填打包所需资源所在地址（不能填127.0.0.1） Web路径：除模式三填“X5/UI”以外，其他模式这一项为空 首页：在下方资源管理目录中找到应用首页后鼠标双击 选择需要发布的资源：模式三时只需要在下方资源管理目录中勾选应用首页，其他模式    需要把用到的资源全部手动勾选 3.配置应用信息 版本号：固定格式，三段  0.8.1 应用包名：①只打安卓包，报名只要符合java规范就可以（应用包名需是全小写的,中间由点分隔开，但每个分段的名称不可以使用数字作为开头，也不  可以 使用特殊字符。）②只打iOS包或安卓和iOS都需要打，应用包名必须和苹果开发证书描述文件中的BundleID保持一致 4.配置开发者信息和证书 除三个证书选择项其他都为选填项 Android证书：六位数字如果是第一次打该应用的安卓包，在输入证书密码时系统自动勾选新生成证书，如果不是第一次打不要勾选新生成证书选项 IOS开发证书：调试iOS包时使用，只有在描述文件中注册过的iPhone设备可以安装此应用。证书密码必须和P12证书导出时填的密码一致，然后依次   选择P12证书和    相应APP ID的开发描述文件 IOS发布证书：发布iOS应用时使用，证书密码必须和P12证书导出时填的密码一致, 然后依次选择P12证书和相应BundleID的发布描述文件 5.设置屏幕选项 根据需要选择符合要求的图片和屏幕方向 6.选择打包的本地插件 系统勾选“自动追加使用到的Cordova插件”选项 手动勾选已知的插件可以减小打包失败的几率 需要填参数的插件必须手动勾选并填上相应参数（填完参数点击其他地方确定输入的input框失去焦点） 7.配置更新信息 根据需要选填 8.本地应用信息 确认显示的信息无误（模式一和模式二Web路径可以为空） [...]

一、配置启动https服务 1、解压铛铛绿色部署包； 2、在铛铛绿色部署包根目录中，找到文件“配置并启动https服务.bat”并双击运行； 3、在浏览器中输入地址：https://【IP地址】:1234/download；如出现下图界面，说明https服务启动成功； 二、ios设备通过https服务安装app 1、在铛铛绿色部署包的根目录下，找到文件“启动铛铛.bat”，双击运行铛铛服务； 2、服务全部启动成功后，在浏览器中输入http://【IP】:8080/dangchat，回车打开该网页；建议使用Chrome、firefox和safari浏览器；界面如下图所示： 3.使用iOS设备扫描二维码下载app，可以使用微信扫描右下角的二维码，扫描后，设备上显示界面如下图： 按照上图中的箭头指示操作，选择“在Safari中打开”，并出现如下界面： 在界面中点击铛铛图标上部的链接（箭头1指示），安装证书； 4.证书安装完成后，重新回到此界面，点击铛铛图标下部的文字链接（箭头2指示），下载安装APP。 安装成功后，在iOS设备桌面上，会出现铛铛的图标。

服务器端要求 1.1      操作系统 建议Windows Server 2008以上版本 1.2      JDK Oracle JDK 8+ 1.3      数据库 PostgreSQL 9.3+ 安装步骤 2.1 安装和配置JDK 下载地址： http://www.oracle.com/technetwork/java/javase/downloads/index.html 选择下载Java，如下图所示： 根据需要下载相应的版本，建议下载最新版本。 下载后运行安装文件，打开安装向导界面，一般按照默认选项安装即可。 2.2 安装PostgreSQL 下载地址： http://www.enterprisedb.com/products-services-training/pgdownload#windows 建议下载最新的稳定版，不使用Beta版。 下载后运行安装文件，打开安装向导界面，一般按照默认选项安装即可。 提示：PostgreSQL默认使用5432端口，建议不要修改。 2.3 设置数据库 2.3.1          创建登录角色 打开PostgreSQL管理工具-pgAdmin [...]

服务器端要求 1.1      操作系统 建议安装CentOS7 1.2      JDK OracleJDK 8+ 1.3      数据库 PostgreSQL 9.3+ 安装步骤 2.1 安装和配置JDK 将JDK解压到指定目录中，如：/usr/local/jdk1.8，然后进行如下配置 vim/etc/profile 将如下内容追加到文件中 export JAVA_HOME=/usr/local/jdk1.8 export JRE_HOME=/usr/local/jdk1.8/jre export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib:$CLASSPATH export PATH=$PATH :$JAVA_HOME/bin 请记住，在上述添加过程中，等号两侧不要加入空格，不然会出现“不是有效的标识符”，因为source /etc/profile 时不能识别多余到空格，会理解为是路径一部分。 然后保存，执行source /etc/profile，使profile生效 2.2 安装PostgreSQL 安装PostgreSQL [...]

一、chat目录结构 图（一） 铛铛前端代码的目录结构如图（一）所示。base文件夹下的.w页面为所有页面的基础页面。Bex5版铛铛和wex5版铛铛的移动端都是从base文件夹中继承的。铛铛Bex5版和wex5版的PC端页面是继承各自的移动端页面。 在base目录下我们要关注的是base/js文件夹中的im.js和im.impl.js。 js是dangchat-server所提供的接口，在页面中用到dangchat-server中的方法需要将im.js文件引入。 impl.js实现im.js中的接口。 对于bex5或wex5有关的接口的实现(例如：铛铛的登录)我们放在各自文件夹中的js目录下，如图（二）所示。 图（二） 图（三） 如图（三）所示，lib/actor目录是跟dangchat-server有关的API。调用服务端方法都在actorClient.js中。如图（四）所示： 图（四） Promise-pollfill.js是兼容低版本不支持promise的Chrome浏览器。photoswipe是消息页面调用的查看图片的工具。 superInput是输入框有关的组件。比如在PC端移动端会有不同状态、表情、语音都在js中处理。 min.js是PC端复制功能调用的第三方。 electron-app.js是构建桌面端铛铛一些功能。 js是全局页面的一些公共方法。如：会话列表中的最后一条消息的内容、发送人、发送时间时间等。 min.css.xml和chat.min.js.xml是合并资源时所需要的配置文件。 js是配置dangchat-server端口的。 chat根目录下w是兼容以前版本铛铛的首页跳转。默认跳转到bex5版铛铛的移动端首页。 铛铛源码引入步骤及注意点 1．源码准备 用户可在https://github.com/wex5中下载。点击图(五)所示的标题，进入后下载的chat目录为铛铛所有的前端源码。 图（五） 2．将下载铛铛源码（chat文件夹）的导入x5平台的UI2目录下。 3．Wex5版铛铛源码需要将baas/org文件夹（https://github.com/wex5/wex5-org可下载）导入x5平台下的Baas目录进行模型编译。 注:如果wex5铛铛用bex5数据库中的示例数据。需要注意人员头像问题，wex5版铛铛的头像在数据库中的字段为varchar类型。Bex5版铛铛中示例组织人员的头像为longblob类型。 4． Bex5版铛铛的搜索文档，搜索历史消息功能为x5的拓展服务，点击图(六)所示标题，进入页面进行下载。下载的文件名修改为chat，放入BIZ目录下。如图（七）所示。 图（六） 图（七） 5． dangchat-server准备。下载铛铛绿色安装包:http://www.wex5.com/downloads/。如图（八）所示，红框内为dangchat-server的重要文件，可单独拷贝到服务器作为dangchat-server。注：需要修改dangchat-server/conf/server.conf文件中的所在服务器的端口，修改chat/config.js的端口修改为dangchat-server的端口。 图（八） 以上步骤完成后，启动dangchat服务，启动tomcat，运行chat/bex5/index.w或chat/wex5/index.w即可。 二chat修改代码重点 [...]

首先注册github账号 打开github首页：https://github.com/ ，点击页面上的Sign up按钮，打开注册页面，填写相关信息后完成用户注册操作。在后续的Studio配置中，主要用到注册github的用户名和邮箱； 下载X5开发平台 下载地址：http://www.wex5.com/downloads/；根据需要分别下载WeX5或BeX5的开发平台； 下载完成后，解压X5开发平台； 在X5 Studio中设置Git参数 双击“启动X5开发工具.bat”打开Studio；第一次打开会弹出Welcome to Android Development的设置界面，可以选择“No”，然后点击“完成”，如下图： 然后，在Studio中点击窗口->首选项，打开首选项页面；在左侧列表中点击小组 ->Git ->配置，显示Git配置项。点击“添加条目”按钮，打开添加条目对话框，如下图： 打开添加条目对话框后，关键字输入user.name，值为在github上注册的用户名，填写完成后点击“确定”按钮；然后再点击“添加条目”按钮，添加email信息，关键字为user.email，值为注册github用户输入的email，然后点击“确定”按钮完成填写。 完成后如下图： 5.获取github上的源代码 铛铛的所有源码的URI可在 https://github.com/wex5中得到： 小组外部贡献者请先执行FORK操作，选择要导入的项目点FORK。然后继续后续操作。（贡献者不在小组中，无法提交代码到主干） 以dangchat-client为例，点击要导入的项目，进入该项目，点击页面上的Clone or download按钮，复制该项目Git的URL地址。如下图： 6.从github上Checkout源码 点击Studio的“文件”菜单，选择“导入”，在导入对话框中选择Git ->来自Git项目，打开从Git导入项目对话框。在该对话框中选择URI，点击下一步 将之前复制的git地址复制到URI中，Protocol选择https，然后点击下一步，选择项目保存的地址；如下图： 确定后等待下载源码： 源码下载完成后，选中该窗口的Import as general project项，如下图： 然后依次点击“下一步”->“完成”按钮，完成操作； [...]

一、准备工作 1.官方推荐的最新版本WeX5开发工具：http://www.wex5.com/wex5/。 2.百度云盘或github下载的源码 ：百度云： http://pan.baidu.com/s/1dFhtu29。github： https://github.com/wex5/ 3.铛铛WeX5版绿色安装部署包：http://pan.baidu.com/s/1c1XmaL6或是：http://www.wex5.com/downloads/ 二、拷贝源码： 将源码资源按照源码资源结构表进行一一对象拷贝到wex5内，开发工具目录表为拷贝好之后开发工具模型资源目录结构。 源码资源结构表: 铛铛源码资源结构 WeX5 dangchat-client \UI2\chat \model\UI2\chat wex5-org \Baas\org \model\Baas\org wex5-work \UI2\work \model\UI2\work \Baas\ \model\Baas\ 开发工具目录表： 三、拷贝dangchat-server服务 拷贝绿色安装部署包中以下三个文件到WeX5开发工具根目录下： 绿色安装包（三个文件）： WeX5开发工具根目录（三个文件） 四、拷贝数据库 拷贝绿色安装部署包中mysql下的data文件到WeX5开发工具mysql目录下 绿色安装包: WeX5开发工具mysql目录: 五、配置数据源 在WeX5开发工具界面配置数据源，在配置前请先启动数据库 1.打开数据源配置对话框 [...]

以平台中保存外卖案例中的用户信息进行调试为例： 1.下载并解压开发工具，双击"启动WeX5开发工具.bat",双击"启动MySQL数据库.bat"。 2.在sdudio窗口对baas 进行模型编译（调试模式），重启tomcat。 目的：这样java视图可以自动导入baasServer,不需要重新导入。 3.设置tomcat的启动方法，选择要进行调试的部分。如下图所示: 1）在工具栏中选择窗口–首选项–Studio配置–Tomcat–不要勾选调试模式启动Tomcat–选择所要调试的资源。 4.引入平台中baas源码 把studio视图调到Java视图，然后把平台中source中自带的源码加入到baasServer中。如下图所示: 1）把studio视图调到Java视图：   2)在baasServer中加入source中自带的baas源码。 解压版本自带的baas .java.zip文件（WeX5\source\baas.java） 把baas-api整个文件复制到sdudio开发工具java视图下的 baasServer 下面，在src上右键---构建路径---用作源文件夹。   5.对需要调试代码打断点（以调试外卖案例中保存用户信息代码为例）。 找到/BaasServer/baas-api/src/com/justep/baas/action（找要调试的类，然后进行打断点），这里以调试CRUD.java类为例，打开类文件，在需要进行调试处双击进行打断点。如下图所示： 6.运行UI层的.w文件，进行调试。 1）切换到studio窗口，先启动tomcat。如下图： 第一个：启动tomcat。 第二个：停止tomcat。 第三个：重启tomcat。 2)切换到studio窗口:点击工具栏中的strdio按钮即可。 3)右键用浏览器运行外卖中的index.w文件，在浏览器中点击--我的----填写用户信息---保存用户信息，当出现这个界面的时候表示操作成功，点击确定可进入调试视图，可操作并观察调试过程。如下图： 注：调试过程中，这些是必须要了解（最好掌握）的东西： F5——进入：移动到下一个步骤，如果当前行有一个方法调用，该控件将会跳转到被调用方法的第一行执行。 F6——跳出：移动到下一行。如果在当前行有方法调用，那么会直接移动到下一行执行。不会进入被调用方法体里面。 F7——返回：从当前方法中跳出，继续往下执行。 F8——移动到下一个断点处执行。 Java程序员应该知道的10个调试技巧：http://www.csdn.net/article/2012-09-03/2809495-Java-Debugging-Tips-with-Eclipse  

以调试自定义action代码为例： 一.创建资源： baas中自定义action方法：http://docs.wex5.com/baas-customaction/ 二.调试java代码： 1.启动tomcat 点击工具栏中的tomcat图标： 第一个：启动tomcat。 第二个：停止tomcat。 第三个：重启tomcat。 2.在sdudio窗口对baas 进行模型编译（调试模式），重启tomcat。 目的：这样java视图可以自动导入baasServer,不需要重新导入。 3.设置tomcat的启动方法，选择要进行调试的部分。如下图所示: 在工具栏中选择窗口--首选项--Studio配置--Tomcat--不要勾选调试模式启动Tomcat--选择所要调试的资源。 4.对需要调试的java代码进行打断点。 1)把studio视图调到Java视图。 2)找到baasServer层下的baas 层--打开自己写的代码，对需要进行调试的部分进行打断点（在需要调试的行号旁边双击方可打断点）。如下图： 5.运行UI层的.w文件，进行调试。 1)切换到studio窗口:点击工具栏中的strdio按钮即可。 2)运行UI层的.w文件，进行调试。右键用浏览器运行UI层的.w文件，当出现这个界面的时候表示操作成功，点击确定可进入调试视图，可操作并观察调试过程。如下图： 注：调试过程中，这些是必须要了解（最好掌握）的东西： F5——进入：移动到下一个步骤，如果当前行有一个方法调用，该控件将会跳转到被调用方法的第一行执行。 F6——跳出：移动到下一行。如果在当前行有方法调用，那么会直接移动到下一行执行。不会进入被调用方法体里面。 F7——返回：从当前方法中跳出，继续往下执行。 F8——移动到下一个断点处执行。 Java程序员应该知道的10个调试技巧：http://www.csdn.net/article/2012-09-03/2809495-Java-Debugging-Tips-with-Eclipse