移动模板部署文档

注意：移动模板的部署分为两部分，① 前端页面部署  ② 后端 license 控制部署  
注意：部署、升级 ① 移动模板前端页面 不需要重启任何服务，但是要多刷新几次浏览器、或清空浏览器/第三方 App 浏览缓存，防止浏览器强缓存旧版，导致新版不生效  
注意：请一定要按照文档部署 “后端 license 控制” 系统

前端页面部署

概要

该文档适用于 Hxphone 3.0 及以上版本

部署完成后，可在手机端使用hxphone登录账号进行发信读信等

获取安装包的方式：

① 通过产品经理的交付邮件附件中获取

详情

在 /home/coremail/web/webapp 目录下新建 hxphone 目录，将 hxphone.zip 安装包拷贝到文件夹中
将 hxphone 安装包解压至 hxphone 目录下 unzip -qo /path/to/hxphone.zip -d /home/coremail/web/webapp/hxphone
修改文件夹权限 chown -R coremail:root hxphone
移动模板前端部署完成，访问 www.domain.com/coremail/hxphone 即可正常使用。但是此时 license 尚未部署，请按照下面的文档继续部署 license

备注

如果是hxphone模板升级部署，则：

备份原 /home/coremail/web/webapp/hxphone 目录（使用 cp 命令即可，不需要 mv）
将新版本的 hxphone.zip 安装包解压覆盖 /home/coremail/web/webapp/hxphone unzip -qo /path/to/hxphone.zip -d /home/coremail/web/webapp/hxphone
解压后需确认客户的自定义配置文件是否还存在，并且是正确的

回退方法：
将备份的 /home/coremail/web/webapp/hxphone 恢复。

查看已部署版本号

查看已部署的 Hxphone 版本的方法有2种：
① 在主页面 - 设置中心 - 关于我们页面中查看（可以在 settings.json 里面开启 settings-about 菜单入口）
② 在 PC 上的 Chrome 浏览器（或其他浏览器），打开控制台，访问移动模板页面，第一行输出的 log 日志也是版本号

后端license控制部署

(内部文档，请通过内部 wiki 查看)

移动模板目录结构说明

tree /home/coremail/web/webapp/hxphone

├── app // 移动模板子项目文件夹
│   ├── cloudStorage.html // 第三方网盘入口文件
│   ├── index.html // 首页入口文件
│   ├── inline.chunk.js
│   ├── login.html // 测试登录页面入口文件
│   ├── schedule.html // 日程入口文件
│   └── static // 静态资源文件，每次构建之后改变的文件hash都会不一致
│       ├── css
│       ├── img
│       └── js
├── favicon.ico
├── index.html // 移动模板主项目核心入口文件
├── sso.html // 移动模板主项目单点核心入口文件
├── json // 各类以配置方式存放的文件
│   ├── custom
│   │   ├── custom_locale-en_US.sample.json // 自定义英文语言示例文件
│   │   ├── custom_locale-zh_CN.sample.json // 自定义简体中文语言示例文件
│   │   ├── custom_locale-zh_TW.sample.json // 自定义繁体中文语言示例文件
│   │   └── custom_settings.sample.json // 自定义配置系统配置示例文件
│   ├── i18n
│   │   ├── locale-en_US.json // 项目英文语言资源文件
│   │   ├── locale-zh_CN.json // 项目简体中文资源文件
│   │   └── locale-zh_TW.json // 项目繁体中文资源文件
│   └── settings.json // 系统核心配置文件（请勿直接修改，请用自定义配置系统配置）
├── static // 静态资源文件，每次构建之后改变的文件hash都会不一致
│   ├── css
│   ├── fonts
│   ├── img
│   └── js
└── views
    └── compose
        └── edit.html

常见问题解答

Q: 手机访问 http://domain.com/coremail 默认访问 xphone
A: 如果想要直接输入域名自动访问hxphone，需要修改配置
/home/coremail/web/webapp/WEB-INF/tags/index_header.tag 将文件中的 xphone 修改为 hxphone 即可

Q: 部署完成后，部分文件出现 403、404 状态的问题
A: 理论上部署成功后，不需要更改移动模板目录的权限即可正常使用，现在部分反馈在极少部分的环境中会出现权限不正确的问题，这个问题仍在排查中可通过在 /home/coremail/web/webapp/hxphone 下执行 find -type d -exec chmod 755 {} \; 进行临时解决

Q: Webmail 可以登录，但是 hxphone 提示密码错误
A: 这种情况可能是因为用户启用了多邮箱域名登录模式，hxphone 需要额外的配置获取到对应的域名列表

移动模板部署文档