base app目前还处于内测阶段,内测QQ群号:869926521,欢迎大家加入!内测期间享受有疑问实时解答的福利。
介绍
base app
,是一个云端一体的、集成了商用项目开发常见功能的项目模板。
如果说uniCloud admin是管理端项目的基础模板,那么base app则是用户端、尤其是移动端的基础模板。
在HBuilderX新建项目时选择base app项目模板,在这个模板基础之上快速填充自己的业务,即可很快完成一个应用。
地址:https://gitee.com/dcloud/base-app
项目背景
我们一直想出一个结合uni-app、uniCloud和openDB以及uni-id和uniCloud admin等,uni全家桶的项目模板;
为了照顾各类应用的开发者,我们取交集最终罗列了如下功能,发现这些就是除业务逻辑外的项目基本功能并把它命名为base app
。
界面效果 img{ box-shadow:0 0 2px #eeeeee; width:200px; margin:15px 5vw 0 0; float:left }
base app集成的功能包括:
- 个人中心:登录注册(含用户名密码登录、手机号验证码登录、app一键登陆、微信登录、Apple登录、支付宝小程序登录)、修改密码、忘记密码、头像更换、昵称修改、积分查看、指纹绑定、退出
- 设置:App更新(整包升级、wgt升级、强制升级,后台搭配uniCloud admin的升级中心插件管理)、权限引导(app)、推送开关(app)、清除缓存(app)、用户协议、隐私协议(app)、问题与反馈、分享推荐、关于
- 启动引导:iOS初次启动被用户禁止网络权限后引导开启、Android弹出隐私协议后再申请权限
- 首页集成banner(后台搭配uniCloud admin的banner插件管理)、搜索、列表、详情、分享,均为云端一体。实际使用中将clientDB的表名更改为自己业务表名即可
- 首页采用nvue,fast编译模式,加快App端启动速度
- 内置联网失败的重试页面(不是错误弹框,页面有重试按钮)、更漂亮的分享菜单页面
- 内置拦截器:
- 网络拦截
- 页面路由拦截,需要登录才能用的,自动跳转到登陆页,登陆后自动继续
- 权限拦截,定位、拍照、相册涉及隐私权限和设备是否开关
- h5版支持在页面顶部引导下载App
base app提供了baseapp.config.js,可指定该应用是否强制登录才能进入首页,可配置选择登录注册方式以及不同方式的优先级。 base app将节省开发者大量的时间,让开发者集中精力在自己的特色业务上。 有了base app,再加上schema2code生成前端页面,一个简单应用就可以快速完成。 base app + uniCloud admin,应用开发从未如此简单快捷!
应用配置
目录结构
cloudfunctions ├─────common 公共模块 │ └─uni-config-center // baseapp的服务端配置中心,项目所有云函数的配置在这里填写 │ ├─index.js // config-center入口文件 │ └─uni-id // 插件uni-id对应的目录 │ ├─config.json // uni-id对应的配置文件 │ └─file.cert // uni-id依赖的其他文件,假如你使用微信发红包功能,需要的证书文件就是放到这里 ├─ baseconfig // baseapp的前端的配置文件,项目所有模块的配置在这里填写。详见该文件的代码注释。 └─ manifest.json // 配置应用名称、appid、logo、版本等打包信息,[详情](https://uniapp.dcloud.io/collocation/manifest)
完整的uni-app目录结构详情
按功能模块
- 登陆模块
-
manifest.json
App模块配置 --> OAuth(登录鉴权)--> 勾选并配置你所需要的模块 - 登陆方式的优先级和登陆项(支持多平台条件编译)详情配置文件:
baseconfig
的router -> login
- 服务端配置详情:
/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json
- 更多
uni-config-center
的介绍 详情
-
- 分享模块
-
manifest.json
App模块配置 --> Share(分享)--> 勾选并配置你所需要的模块 - 分享功能配置参数,随着应用的业务场景决定,在各场景调用的时候配置。参考base app的
/pages/list/detail.vue
的methods -> shareClick
- 更多
uni-share
的介绍 详情
-
- 升级中心相关
-
manifest.json
基础配置 --> 应用版本名称 和 应用版本号 - 更多
uni-upgrade-center
的介绍 详情
-
时序介绍
- 初始化应用执行appInit
- 读取baseapp.config并挂载到globalData的config下
- 读取应用版本号,并存到globalData下。
- 检查是否有可更新的应用版本。
- 使用拦截器 实现了,
- 强制登陆路由拦截。
- 摄像头/相册权限,引导跳到设置界面
- 全局监听
- 网络的变化与toast方式提醒
- clientDB的err事件,
- 判断是否为token过期失效等需要重新登陆的问题。自动跳转到登陆页面
- 检测本地的token是否有效(存在且并未过期)否则跳转到登陆页面
- 预登陆一键登录功能
快速体验部署流程
1. 开通uniCloud
- 开通
uniCloud
:本项目是云端一体的,它的云端代码需要部署在uniCloud云服务空间里,需要开通uniCloud。在https://unicloud.dcloud.net.cn/登录,按云厂商要求进行实名认证。 - 在uniCloud认证通过后,创建一个服务空间给本项目使用。选择阿里云或腾讯云均可。参考
- 使用HBuilderX 3.1以上版本(最好是最新版),把本项目导入到HBuilderX中,在项目根目录uniCloud上点右键菜单,关联服务空间 -> 选择之前创建的服务空间
2. 关联项目与云服务空间
3. 跨域配置
如运行在iOS上,需解决本地页面跨域问题。
在uniCloud web 控制台跨域配置里添加:localhost:13131
5. 真机运行
注意:真机运行需要制作自定义基座,制作后选择运行到自定义基座.
FAQ:常见问题
- 提示“公共模块uni-id缺少配置信息”解决方案:在cloudfunctions右键‘上传所有云函数、公共模块及actions’之后,需要在cloudfunctions--》common--》uni-config-center 目录单独上传一次,右键‘上传公共模块’。
- 本项目代码可以商用,无需为DCloud付费。但不能把本项目的代码改造用于非uni-app和uniCloud的技术体系。即,不能将后台改成php、java等其他后台,这将违反使用许可协议。
第三方插件(感谢插件作者,排名不分前后):
- 图片裁剪 limeClipper @作者: 陌上华年
- 二维码生成 Sansnn-uQRCode @作者: 3snn