zhiyicx / plus-component-h5
v4.1.2
2018-11-14 09:31 UTC
This package is not auto-updated.
Last update: 2022-02-01 13:09:43 UTC
README
Plus(ThinkSNS+) 的移动端客户端
使用现代 Web 技术(Vue.js)编写的 Plus(ThinkSNS+) 浏览器单页客户端。
简介
此浏览器单页客户端基于 Apache-2.0 协议开源,使用 Vue.js 及 ES+ 等现代 Web 技术构建!项目具有以下特点:
- 易于分发,您可以将编译后的文件分发到任何地方,无需支持动态语言。
- 完全独立,您无需了解后端程序,只需调用文件化的 API 接口即可开发。
- 高 App 还原,项目以 ThinkSNS+ 原生客户端为 UI 基准,进行高度还原。
- 技术简单,我们使用中国接受度非常高的 Vue.js 进行开发,您可以快速上手。
安装
配置
.env
文件配置说明:
BASE_URL=/ # 我们假设你部署在一个域名下,所以默认 `/`, 例如你部署在子目录下,请设置子目录,必须以 `/` 结尾! GENERATE_CSS_MAP=true # 是否构建的时候生成 source map VUE_APP_ENABLE_SERVICE_WORKER=false # 是否添加离线支持 VUE_APP_API_HOST=http://127.0.0.1 # 你的 Plus 程序地址 VUE_APP_API_VERSION=v2 # 无需修改,目前支持的值只有 `v2` VUE_APP_NAME="Plus (ThinkSNS+)" # 浏览器显示的程序名称 VUE_APP_KEYWORDS= # 易于搜索引擎搜索的关键词 VUE_APP_DESCRIPTION= # 你的网站描述 VUE_APP_ROUTER_MODE=hash # 路由模式,请参考下面的「路由模式」文档 VUE_APP_THEME=src/console/theme.js # 主题文件,暂时不支持修改 VUE_APP_EASEMOB_APP_KEY=# # 环信 APP KEY VUE_APP_EASEMOB_API_URL=http://a1.easemob.com # 环信接口地址 VUE_APP_EASEMOB_ISDEBUG=false # 是否开启环信 Debug VUE_APP_LBS_GAODE_KEY= # 高德地图 GAODE KEY
路由模式
路由模式支持 hash
和 history
两种模式,区别如下:
hash
模式:无需后端支持,利用浏览器的「锚」功能进行路由定位。history
模式:需要后端的路由转发支持,正确设置的情况是所有请求都转发到index.html
文件上
更详细的描述请看 👉 API 参考#mode
跨域问题
如果您将此客户端部署到全新的地址中,那么您肯定会遇到跨域资源共享禁止问题,导致此客户端无法正常工作。在您安装完成 Plus(ThinkSNS+) 后,您可以进入 /admin
后台管理面板,然后您从左侧菜单点击「系统设置」,然后再从顶栏菜单选择「安全」。
此时,您会看到一个「跨域设置」设置,这个时候您应该咨询后端了解跨域资源共享的人,默认情况是允许所有跨域的,如果关闭了允许所有,请在 Access-Control-Allow-Origin
中添加程序的 host 即可!
开发部署
在项目中设置了三个有效命令:
serve
用于开发,修改代码后会自动 Hot Reloadbuild
用于正式部署的打包,执行完成后会多出一个dist/
目录lint
用于代码检查和风格修复
许可证
Plus 代码采用企业定制许可证发布,请参阅完整的许可证文本
版权所有 © 2018 成都智忆创想科技有限公司。保留所有权利。