diff --git a/README.md b/README.md index 1a8b116465655ecbd2902141ad42087e795eef32..faccd69a3011d62d1fde0e92e504c24f259aad8e 100644 --- a/README.md +++ b/README.md @@ -1,569 +1,3 @@ -#### 视频介绍 - - 腾讯课堂uniCloud视频教程 - - -注:视频会有滞后问题,入门为主。最新的完整功能请看以下文档 - -#### 简介 -uni-starter是一个集成了大量商用项目常见功能的,云端一体应用快速开发基本项目模版。 - -APP有很多通用的功能,比如登录注册、头像、设置、banner、... uni-starter将这些功能都已经集成好。 - -直接在`hbuilderx`新建项目选择`uni-starter`模板,即可在此基础上快速开发自己的特色业务。 - -有了`uni-starter`,再加上`schema2code`生成前端页面,一个简单应用就可以快速完成。 - -如果说[uniCloud admin](https://uniapp.dcloud.io/uniCloud/admin)是管理端项目的基本项目模版,那么uni-starter则是用户端、尤其是移动端的基础项目模板。 - -`uni-starter` + `uniCloud admin` 提供了用户端和管理端的基本项目模版,应用开发从未如此简单快捷! - -##### 扫码体验:h5版演示效果(链接:[https://uni-starter.dcloud.net.cn](https://uni-starter.dcloud.net.cn)) - - -### uni-starter集成包括: -1. 用户管理: - - 登录注册(用户名密码登录、手机号验证码登录、APP一键登录、微信登录、Apple登录、微信小程序登录) - - 修改密码、忘记密码、头像更换(集成图片裁剪)、昵称修改、积分查看、退出登录 -2. 系统设置: - - App更新(整包升级、wgt升级、强制升级,后台搭配uniCloud admin的升级中心插件管理) - - 推送开关(app)、清除缓存(app) - - 指纹解锁(app)、人脸解锁(app) - - 多语言切换 - - 账号注销(正在完善中...) -3. 隐私权限:内置Android先弹出隐私协议对话框,然后再向用户申请设备权限 -4. 权限引导:当应用拒绝授权某些权限,但在后续使用中又需要这个权限;此时实现:引导用户可“一键跳转至系统设置”中开启。 - - 而不是报错让用户自己去找解决方案(更好的用户体验)。 - - 采用高内聚低耦合的设计结构,直接在应用启动时,应用拦截器中实现。免去在每个业务代码中处理这类问题,更优雅更方便。 - - 已实现项目:摄像头、相册、获取GPS定位、网络2/3/4/5G和Wi-Fi。你可以参考这些实现,处理更多该类场景的处理。uni-starter也会持续更新完善。 -5. 实用功能 - - 问题与反馈、关于、隐私政策、用户服务协议 - - banner(后台搭配uniCloud admin的banner插件管理) - - 新闻的搜索、列表、详情、分享。通过clientDB实现,开发者直接修改定义的表名等参数,即可轻松改为自己的业务 - - 可覆盖原生层的分享菜单 - - h5版在页面顶部(全局悬浮)引导用户点击下载App - - 营销裂变:点击“分销推荐”,生成带用户inviteCode参数的应用下载页(H5),一键分享到微信或微信朋友圈等。被邀请人打开下载页面点击下载,设备剪贴板的内容会被自动设置为邀请者的inviteCode。被邀请人下载app之后通过任何方式登录(含:注册并登录),uni-starter框架会自动获取设备剪切板中的inviteCode提交到服务端绑定关联关系。 -6. 更好的性能:首页采用nvue,fast编译模式,加快App端启动速度 -7. 内置拦截器: - - 页面路由拦截,配置需强制登录的页面;打开时自动检测`token`若无效就自动跳转到登录页 - - 调用云函数(callFunction)拦截器,自动携带必要参数、自动处理响应体。详见9.自动完成1-2 -8. 自动完成: - - 分析uniCloud.callfunction和clientDB操作的响应体,判断code执行对应的操作如跳转到登录页,自动续期token - - 操作注册/登录操作自动获取客户端设备:push_clientid、imei、oaid、idfa新增/更新到数据表uni-id-device - - 异常恢复处理:断网恢复后自动重连“因网络错误导致的”网络请求 - - 为迎合苹果App Store的规则,登录与分享功能项显示之前自动检测是否安装了对应客户端。比如:设备未安装微信则不显示微信快捷登录和微信分享选项 - -* 更多功能模块会不断更新,请持续关注本插件 - -## 快速体验部署流程 -#### 1. 开通uniCloud -- 开通`uniCloud`:本项目是云端一体的,它的云端代码需要部署在uniCloud云服务空间里,需要开通uniCloud。在[https://unicloud.dcloud.net.cn/](https://unicloud.dcloud.net.cn/)登录,按云厂商要求进行实名认证。 -- 在uniCloud认证通过后,创建一个服务空间给本项目使用。选择阿里云或腾讯云均可,两种服务空间差异[详情](https://uniapp.dcloud.net.cn/uniCloud/price) - -#### 2. 运行云服务空间初始化向导 - - - - -## 功能模块介绍 -### 1.登录模块 -|登录类型 |描述 | -|-- |-- | -|smsCode |验证码登录 | -|univerify |读取手机SIM卡一键登录 | -|username |账号密码登录 | -|weixin |微信登录 | -|apple |苹果登录 | - -配置文件:`项目根目录/uni-starter.config.js` -```js -{ - "router":{ - "login":["username","smsCode"] - } -} -``` - -#### 启用登录方式 -如上示例配置为:`["username","smsCode"]` 表示启用:验证码登录、账号密码登录。 - -同理配置为:`["weixin","username","smsCode"]` 则表示启用:微信登录、验证码登录、账号密码登录。 - -总结:需要几项列举几项即可。 - -#### 优先级 -在uni-starter框架中执行`uni.navigateTo({url: "/pages/ucenter/login-page/index/index"})`,会根据配置跳转到相应的登录页面。如果配置内容为:`["username","smsCode"]`会自动切换到"配置的第0项,也就是`username`类型的登录方式对应的页面”,即`账户登录`方式页面,路径:`/pages/ucenter/login-page/pwd-login/pwd-login` - -#### 平台差异性配置 -这里支持用[条件编译](https://uniapp.dcloud.io/platform?id=%e6%9d%a1%e4%bb%b6%e7%bc%96%e8%af%91)因此你可以配置在不同平台下拥有的登录方式。 -如下配置,即表示仅在APP端启用“短信验证码登录” -```js -"login": [ - "username","univerify","weixin","apple" - // #ifdef APP-PLUS - "smsCode", - // #endif -] -``` - -#### 生效策略 -登录方式有如上5种,虽然你希望有几种登录方式就在配置中列举几种。但是有的登录方式可能因为设备环境问题而不被支持; -比如你正确地配置了微信登录,而用户的手机并没有安装微信,这样微信登录功能就无法使用。 -并且如果出现这种情况你的app会被iOS的App Store拒绝上架。 -所以在这里,我们的生效策略在检测:你是否有列举到某个配置项为前提的情况下,增加了检测当前环境是否支持,如果不支持会自动隐藏。 - -#### 在uni-app框架中配置: -在应用模块:`manifest.json` App模块配置 --> OAuth(登录鉴权)--> 勾选并配置你所需要的模块 -+ 一键登录: - [开通配置](https://dev.dcloud.net.cn/uniLogin) - [使用指南](https://uniapp.dcloud.io/univerify) -+ [苹果登录集成指南](https://ask.dcloud.net.cn/article/36651) -+ 短信登录: ->`uni-id-cf`文件路径:`/uniCloud-aliyun/cloudfunctions/uni-id-cf/index.js` - - 测试期间,为节约资源。统一虚拟短信验证码为:123456。正式使用注视掉`uni-id-cf`第339-344行即可 - 使用本功能需要在[DCloud开发者中心](https://dev.dcloud.net.cn/uniSms)开通并充值 - 教程参考[短信服务开通指南](https://ask.dcloud.net.cn/article/37534) - 修改短信注册/登录发生验证码的模板id,在`uni-id-cf`搜索 `const templateId = '11753'` 替换为自己申请的模板id - -#### 服务端配置 -uni-starter服务端使用[uni-config-center](https://ext.dcloud.net.cn/plugin?id=4425)统一管理这些配置, -文件路径`/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json` -详情下文[目录结构](#id=catalogue) 和[uni-id配置说明](https://uniapp.dcloud.io/uniCloud/uni-id?id=configjson%e7%9a%84%e8%af%b4%e6%98%8e) - -### 2.路由拦截 -#### 应用场景 -有些页面,限允许已经登录后用户才访问。 -常规的做法是打开这类页面之前,检查(前端校验)uni_id_token的值是否有效,如果无效会自动跳转到登录页面。 -而这样的页面有很多,入口也不少。面向过程的写法会产生大量的代码冗余,且不易维护。 -而uni-starter基于拦截器(`uni.addInterceptor`),提供了仅需简单配置即可实现的路由拦截功能。 -#### 配置方式 -支持两种模式(二选一) -##### 黑名单模式 -列举需要强制登录的页面完整路径(支持正则) -##### 白名单模式 -列举不需要强制登录即可访问的页面完整路径(支持正则) -#### 配置示例 -配置文件:`项目根目录/uni-starter.config.js` - -```js -"router": { - "needLogin" : [ - {pattern:/^\/pages\/list.*/}, //支持正则表达式 - "/uni_modules/uni-news-favorite/pages/uni-news-favorite/list", - "/uni_modules/uni-feedback/pages/uni-feedback/add" - ], -/* - 请注意上下,黑名单(needLogin)、白名单(visitor)两种配置模式二选一不可同时使用 -*/ - "visitor" : [ - "/",//注意入口页必须直接写 "/" - {"pattern":/^\/pages\/list.*/}, //支持正则表达式 - {"pattern":/^\/pages\/ucenter\/login-page.*/}, - "/pages/common/webview/webview", - "/pages/grid/grid", - "/pages/ucenter/ucenter", - "/pages/ucenter/about/about", - "/pages/ucenter/settings/settings" - ] -} -``` - -##### 优势: -传统的路由管理方式是对uni-app框架路由写法的二次封装,自定义的写法不支持ide的代码提示,且不优雅。 -另外不同插件作者封装不同的路由管理方式,这样做出来的插件与用户的项目结合时,路由写法不统一的差异需要去磨平。 -为此`uni-starter`基于`uni.addInterceptor`(拦截器)实现路由管理。 - -##### 注意: -- uni-starter的路由拦截,仅在调用路由API(navigateTo、redirectTo、reLaunch、switchTab)时触发。应用的首页是由系统自动打开,不会触发拦截器。首页需要强制登录才能访问的场景,不由路由控制。但不用担心,如果未登录的用户,打开了需要登录才能访问页面,必定会触发需要携带有效token才能访问的API。此时则会返回相应的响应体,uni-starter监测到token无效这类的响应体也会自动跳转到登录页(这种效果需要前后端都开发完成才体验到)。 -- uni-starter框架不能将登录页`/pages/ucenter/login-page/index/index`设置为首页,否则由拦截器实现的路由管理将生效。 -- 拦截器实现的路由控制,是在路由跳转未完成之前触发。路由切换方式(navigateTo、redirectTo、reLaunch、switchTab)URL参数必须使用绝对路径路 - -### 3.h5版在页面顶部引导用户`点击下载App` -把h5端用户引流到APP端,是一个非常实用的功能。相对于h5,APP端有更高的用户留存和更好的产品体验。 -uni-starter集成了这个功能,你只需直接在`项目根目录/uni-starter.config.js`的"h5"->"openApp"中配置相关内容,即可开启全局悬浮的下载引导。 -这也是一个演示开发者如何在h5端做全局悬浮块的例子。你也可以在`/common/openApp.js`中修改他的样式等代码等,注意他只支持原生js语法。 - -### 4.分享模块 -一个可覆盖原生层分享模块 -- 应用配置:`manifest.json` App模块配置 --> Share --> 勾选并配置你所需要的模块 -- 分享功能配置参数,随着应用的业务场景决定,在各场景调用的时候配置。参考uni-starter的`/pages/list/detail.vue`的`methods -> shareClick` -- 更多`uni-share`的介绍 [详情](https://ext.dcloud.net.cn/plugin?id=4860) - -### 5.升级中心相关 -为了解决开发者维护多个 App 升级繁琐,重复逻辑过多,管理不便的问题,升级中心`uni-upgrade-center`应运而生。 -提供了简单、易用、统一的 App 管理、App 版本管理、安装包发布管理,升级检测更新管理。 -- 升级中心分为两个部分:`uni-upgrade-center` Admin管理后台和`uni-upgrade-center - Admin`前台检测更新。 -- `uni-upgrade-center`的介绍 [详情](https://ext.dcloud.net.cn/plugin?id=4542) -- `uni-upgrade-center - Admin`的介绍 [详情](https://ext.dcloud.net.cn/plugin?id=4470) - -### 6.意见反馈 -- 客户端[详情](https://ext.dcloud.net.cn/plugin?id=50) -- admin端[详情](https://ext.dcloud.net.cn/plugin?id=4992) - -### 7.指纹识别模块 -- `manifest.json` App模块配置 --> `Fingerprint`指纹识别 - -### 8.消息推送模块 -- `manifest.json` App模块配置 --> `push`消息推送 - -### 9.隐私政策弹框 -根据工业和信息化部关于开展APP侵害用户权益专项整治要求,App提交到应用市场必须满足以下条件: -- 应用启动运行时需弹出隐私政策协议,说明应用采集用户数据 -- 应用不能强制要求用户授予权限,即不能“不给权限不让用” -+ 如不希望应用启动时申请“读写手机存储”和“访问设备信息”权限,请参考:https://ask.dcloud.net.cn/article/36549 - -配置弹出“隐私协议和政策”打开项目的manifest.json文件,切换到“源码视图”项 -在`manifest.json` -> `app-plus` -> `privacy` 节点下添加 prompt节点 -```js -"privacy" : { - "prompt" : "template", - "template" : { - "title" : "服务协议和隐私政策", - "message" : "  请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。
  你可阅读《服务协议》《隐私政策》了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。", - "buttonAccept" : "同意", - "buttonRefuse" : "暂不同意" - } -} -``` -- prompt - 字符串类型,必填,隐私政策提示框配置策略,可取值template、custom、none,默认值为none - + template - 使用原生提示框模板,可自定义标题、内容已经按钮上的文本 - + custom - 自定义隐私政策提示框,uni-app项目中推荐使用nvue页面进行自定义,5+ APP使用html页面进行自定义 - + none - 不弹出隐私政策提示框 -- template - json格式,可选,模板提示框上显示的内容 - + title - 模板提示框上的标题,默认为“服务协议和隐私政策” - + message - 模板提示框上的内容,richtext类型字符串,支持a/font/br等节点,点击a链接会调用内置页面打开其href属性中链接地址。 - **注意:务必配置此提示内容,或参考上面示例内容并修改《服务协议》和《隐私政策》链接地址** - + buttonAccept - 模板提示框上接受按钮的文本,默认值为“我知道了” - + buttonRefuse - 模板提示框上拒绝按钮的文本,默认不显示此按钮 - + second - HBuilderX3.1.12+版本新增支持隐私提示框二次确认提示,用于配置二次确认提示框显示内容,message属性值不为空时弹出二次确认提示框 - + title 二次确认提示框上的标题 - + message 二次确认提示框上的内容,支持richtext类型字符串 - + buttonAccept 二次确认提示框上接受按钮的文本 - + buttonRefuse 二次确认提示框上拒绝按钮的文本 - -> 更多Android平台隐私与政策提示框配置方法,[详情](https://ask.dcloud.net.cn/article/36937) - -##### 注意: -1. 最新的华为应用市场要求,隐私政策提示框上接受按钮的文本,必须为“同意”而不能是其他有歧义的文字。 -2. 配置后提交云端打包后生效。理论上绝大部分和`manifest.json`生效相关的配置均需要提交云打包后生效 - -### 10.拦截器改造后的uniCloud -1. Debug,调试期间开启Debug。接口一旦fail就会弹出真实错误信息。否则将弹出,系统错误请稍后再试! -```js - if(Debug){ - console.log(e); - uni.showModal({ - content: JSON.stringify(e), - showCancel: false - }); - } -``` -2. 断网自动重试,当callFunction为fail时检测是否因断网引起。如果是会提醒用户并且会在恢复网络之后自动重新发起请求 -3. 常规的errCoder自动执行对应程序,如token无效/过期自动跳转到登录页面。 -4. token自动续期。 - -### 11.举例路由控制原理,深入了解拦截器的使用 -比如你希望在打开用户中心等页面之前,都检查一下该用户是否登录,否则就重定向到登录页面。使用拦截器你可以用以下写法在应用入口定义全局生效: - -```js - //定义各个页面,这里为了演示uni-starter框架是把该定义写在全局配置uni-starter.config.js中 - let needLogin = ["/pages/ucenter/userinfo/userinfo", ... ] - - uni.addInterceptor("navigateTo", { - invoke(e) { // 调用前拦截 - //获取用户的token - const token = uni.getStorageSync('uni_id_token') - //获取当前页面路径(即url去掉"?"和"?"后的参数) - const url = e.url.split('?')[0] - //判断要打开的页面是否需要验证登录 - if (needLogin.includes(url) && token == '') { - uni.showToast({ - title: '该页面需要登录才能访问,请先登录', - icon: 'none' - }) - uni.navigateTo({ - url: "/pages/ucenter/login-page/index/index" - }) - return false - } - }, - fail(err) { // 失败回调拦截 - console.log(err); - }, - }) -``` -- 而路由跳转方法不仅有`uni.navigateTo`还有`uni.redirectTo`,`uni.reLaunch`,`uni.switchTab`; -- 另外我们还希望控制直接跳转至哪种登录类型 -所以在uni-starter框架中我们这样定义: -uni-starter/common/appInit.js 的第228-280行 -```js - const {"router": {needLogin,login} } = uniStarterConfig //需要登录的页面 - let list = ["navigateTo", "redirectTo", "reLaunch", "switchTab"]; - list.forEach(item => { //用遍历的方式分别为,uni.navigateTo,uni.redirectTo,uni.reLaunch,uni.switchTab这4个路由方法添加拦截器 - uni.addInterceptor(item, { - invoke(e) { // 调用前拦截 - //获取用户的token - const token = uni.getStorageSync('uni_id_token') - //获取当前页面路径(即url去掉"?"和"?"后的参数) - const url = e.url.split('?')[0] - //判断要打开的页面是否需要验证登录 - if (needLogin.includes(url) && token == '') { - uni.showToast({ - title: '该页面需要登录才能访问,请先登录', - icon: 'none' - }) - uni.navigateTo({ - url: "/pages/ucenter/login-page/index/index" - }) - return false - } - //控制登录优先级 - if (url == '/pages/ucenter/login-page/index/index') { - //一键登录(univerify)、账号(username)、验证码登录(短信smsCode) - if (login[0] == 'univerify') { - if(e.url == url) { e.url += '?' } //添加参数之前判断是否带了`?`号如果没有就补上,因为当开发场景本身有参数的情况下是已经带了`?`号 - e.url += "univerify_first=true" - } else if (login[0] == 'username') { - e.url = "/pages/ucenter/login-page/pwd-login/pwd-login" - } - } - return true - }, - fail(err) { // 失败回调拦截 - console.log(err); - }, - }) - }) -``` - -### 12.关于升级 -- 项目升级 - - uni-starter遵循uni-app的插件模块化规范,即:[uni_modules](https://uniapp.dcloud.io/uni_modules) 。他是个项目类型的插件。在项目的根目录下有一个符合uni_modules规范的package.json文件,在这个文件右键-从插件市场更新即可更新该插件。 - -- 插件升级 - - 非项目类型的uni_modules插件,是项目根目录下的uni_modules目录下。以插件ID为插件文件夹命名,在该目录右键也会看到“从插件市场更新”选项,点击即可更新该插件。 - -### 13.多语言国际化 - uni-starter支持多语言国际化。默认开启,可以在`uni-starter.config.js`->`i18n`->`enable`中配置 - 如果你启用了多语言国际化需要先阅读:[uni-app多语言国际化](https://uniapp.dcloud.io/collocation/i18n?id=%e6%a1%86%e6%9e%b6%e5%86%85%e7%bd%ae%e7%bb%84%e4%bb%b6%e5%92%8capi%e5%9b%bd%e9%99%85%e5%8c%96) - -## 应用启动时序介绍 -文件路径: App.vue -```js - import initApp from '@/common/appInit.js'; - export default { - onLaunch: function() { - initApp(); - } - } -``` -onLaunch生命周期执行了 -1. 全局监听clientDB的err事件, - - 判断是否为token过期失效等需要重新登录的问题。自动跳转到登录页面 - - 检测本地的token是否有效(存在且并未过期)否则跳转到登录页面 -2. 预登录一键登录功能 -3. 执行了initApp()包含以下操作 - 1. 读取uni-starter.config并挂载到globalData的config下 - 2. 读取应用版本号,并存到globalData下 - 3. 检查是否有可更新的应用版本,决定是否启动在线更新版本 - 4. 监听设备的网络变化并以uni.showToast APi的方式提醒用户 - 5. 使用[拦截器](https://uniapp.dcloud.io/api/interceptor?id=addinterceptor) 实现 - - 页面路由拦截,配置需强制登录的页面;打开时检测,如果token无效就自动跳转到登录页 - - 优雅实现:自动引导打开`选择图片`所需要的权限。当调用`uni.chooseImage`时检测到无权限自动开启引导。并不是在每次调用接口时处理这类问题,你可以参考该例子做更多该类场景的处理。uni-starter也会持续完善 - - -## 配置文件 -uni-starter提供了`uni-starter.config.js`,可配置选择登录注册方式及优先级等,可指定该应用是否强制登录才能进入某个页面。配置项内容如下: -```js -module.exports = { - "h5": { - "url": "https://static-76ce2c5e-31c7-4d81-8fcf-ed1541ecbc6e.bspapp.com", // 前端网页托管的域名 - // 在h5端全局悬浮引导用户下载app的功能 更多自定义要求在/common/openApp.js中修改 - "openApp": { - //点击悬浮下载栏后打开的网页链接 - "openUrl": 'https://sj.qq.com/myapp/detail.htm?apkName=com.tencent.android.qqdownloader&info=6646FD239A6EBA9E2DEE5DFC7E18D867', - //左侧显示的应用名称 - "appname": 'uni-starter', - //应用的图标 - "logo": './static/logo.png', - } - }, - "mp": { - "weixin": { - //微信小程序原始id,微信小程序分享时 - "id": "gh_132465798" - } - }, - "router": { - //配置需要路由拦截的页面地址,在打开这些页面之前会自动检查(无需联网)uni_id_token的值,如果token无效就自动跳转到登录页 - "needLogin": [ - "/pages/ucenter/userinfo/userinfo", - "/uni_modules/uni-news-favorite/pages/uni-news-favorite/list", - ], - "login": ["smsCode","univerify", "username", "weixin", "apple"], - /* - 这里会根据数组的第0项,决定登录方式的第一优先级是哪种登录方式。 - 所有你希望拥有的登录方式这里都需要一一列举,未列举到的或设备环境不支持的登录方式将被隐藏。 - 如果你需要在不同平台有不同的配置,直接用条件编译即可。 - */ - }, - //关于应用 - "about": { - //应用名称 - "appName": "uni-starter", - //应用logo - "logo": "/static/logo.png", - //公司名称 - "company": "数字天堂(北京)网络技术有限公司", - //口号 - "slogan": "为开发而生", - //政策协议 - "agreements": [{ - "title": "用户服务协议", //协议名称 - "url": "https://ask.dcloud.net.cn/protocol.html" //对应的网络链接 - }, - { - "title": "隐私政策", - "url": "https://ask.dcloud.net.cn/protocol.html" - } - ], - //应用的链接,用于分享到第三方平台和生成关于我们页的二维码 - "download": "https://m3w.cn/uniapp" - }, - //用于打开应用市场评分界面 - "marketId":{ - "ios":"id1417078253", - "android":"123456" - }, - //配置多语言国际化。i18n为英文单词 internationalization的首末字符i和n,18为中间的字符数 是“国际化”的简称 - "i18n":{ - "enable":false //默认启用,国际化。如果你不想使用国际化相关功能,请改为false - } -} -``` - -## 目录结构@catalogue -
-uni-starter
-├─uniCloud-aliyun	
-│	├─cloudfunctions 云函数目录
-│	|	├─common 公共模块
-│	│	|	├─uni-config-center		uni-starter的服务端配置中心,项目所有云函数的配置在这里填写 详情
-│	│	|	|	├─index.js			config-center入口文件
-│	│	|	|	└─uni-id			uni-id模块配置目录
-│	│	|	|		├─config.json	uni-id对应的配置数据:微信登录、一键登录、短信验证码登录等key都在这里填写详情
-│	│	|	|		└─file.cert		uni-id依赖的配置文件,假如你使用微信发红包功能,需要的证书文件就是放到这里
-│	|	|	└───uni-id				uni-id用户体系 详情
-│	|	├─uni-analyse-searchhot		云端一体搜索模板依赖的云函数 详情
-│	|	└─uni-id-cf				用户中心云函数,实现用户注册、修改密码、发送验证码、快捷登录(微信、短信、账户、一键登录)
-│	└──database						云数据目录
-│		├─db_init.json				db_init.json初始化数据库文件,其中不再包含schema 详情
-│		├─opendb-app-versions.schema.json		应用版本,表结构文件
-│		├─opendb-banner.schema.json	        	横幅数据表,表结构文件
-│		├─opendb-feedback.schema.json	        意见反馈表,表结构文件
-│		├─opendb-news-articles.schema.json	    新闻文章表,表结构文件
-│		├─opendb-news-categories.schema.json	新闻分类表,表结构文件
-│		├─opendb-news-comments.schema.json		新闻评论表,表结构文件
-│		├─opendb-news-favorite.schema.json		新闻收藏表,表结构文件
-│		├─opendb-search-hot.schema.json			热门搜索表,表结构文件
-│		├─opendb-search-log.schema.json			搜索记录表,表结构文件
-│		├─opendb-verify-codes.schema.json		验证码表,表结构文件
-│		├─uni-id-log.schema.json	        	登录日志表,表结构文件
-│		├─uni-id-scores.schema.json	        	用户积分表,表结构文件
-│		└─uni-id-users.schema.json	        	用户表,表结构文件
-├─pages										业务页面文件存放的目录
-│	├─common						
-│	│	└─webview							webview目录
-│	│		└─webview.vue					webview页面	用于实现跨端的web页面浏览
-│	├─grid
-│	│	└─grid.vue	 						带宫格和banner的示例页面
-│	├─list
-│	│	├─list.vue	 						新闻列表
-│	│	├─search
-│	│	│	└─search						云端一体搜索插件
-│	│	└─detail.vue						新闻详情
-│	├─ucenter
-│	│	├─about								关于我们
-│	│	│	└─about
-│	│	├─login-page						登录模块
-│	|	|	├─common						登录模块公共库
-│	│	│	│	├─login-page.css			公共样式库
-│	│	│	│	├─login-page.mixin.js		公共mixin
-│	│	│	│	└─loginSuccess.js			公共登录成功后操作
-│	|	|	├─index							短信验证码登录,手机号码输入页面
-│	|	|	├─phone-code					短信验证码登录,验证码输入页面
-│	|	|	├─pwd-login						账户密码登录
-│	|	|	├─pwd-retrieve					密码重置
-│	│	│	└─register						注册账户模块
-│	│	│		├─validator.js
-│	│	│		└─register.vue
-│	│	├─read-news-log						新闻阅读记录
-│	│	│	└─read-news-log
-│	│	├─settings						
-│	│	│	├─dc-push
-│	│	│	│	└─push.js					push权限操作SDK
-│	│	│	└─settings.vue					app设置
-│	│	├─userinfo							用户个人信息
-│	│	│	├─bind-mobile
-│	│	│	│	└─bind-mobile.vue			绑定手机号码
-│	│	│	├─limeClipper					图片裁剪插件,来源[limeClipper](https://ext.dcloud.net.cn/plugin?id=3594) @作者: 陌上华年
-│	│	│	│	├─images
-│	│	│	│	│	├─photo.svg
-│	│	│	│	│	└─rotate.svg
-│	│	│	│	├─index.css
-│	│	│	│	├─limeClipper.vue
-│	│	│	│	├─README.md
-│	│	│	│	└─utils.js
-│	│	│	├─main.js
-│	│	│	├─cropImage.vue	引用limeClipper的图片裁剪模块,为了方便二开可能会出现兼容`vue`与`nvue`,所以做成了`页面`而不是`组件`
-│	│	│	└─userinfo.vue
-│	|	└─ucenter.vue						用户中心
-│	|
-├─static	 						存放应用引用的本地静态资源(如图片、视频等)的目录,注意:静态资源只能存放于此
-├─uni_modules						存放[uni_module](/uni_modules)规范的插件。
-├─uni_modules_tools					uni_modules插件上传辅助脚本 详情。
-├─main.js							Vue初始化入口文件
-├─App.vue							应用配置,用来配置App全局样式以及监听 应用生命周期
-├─uni-starter.config				uni-starter的前端的配置文件,项目所有模块的配置在这里填写。详见该文件的代码注释。
-├─manifest.json	 					配置应用名称、appid、logo、版本等打包信息,详见
-└─pages.json						配置页面路由、导航条、选项卡等页面类信息,详见
-
-完整的uni-app目录结构[详情](https://uniapp.dcloud.io/frame?id=%e7%9b%ae%e5%bd%95%e7%bb%93%e6%9e%84) - -## 常见API示范 -1. 判断当前用户是否拥有某角色`uniIDHasRole` 演示页面:`/pages/grid/grid` [API文档详情:](https://uniapp.dcloud.io/api/global?id=uniidhasrole) -2. 指纹解锁、人脸解锁 演示页面:`/pages/ucenter/settings/settings` [API文档详情:](https://uniapp.dcloud.io/api/system/authentication) - -## 注意事项 -1. 真机运行需要制作自定义基座,制作后选择运行到自定义基座 -2. 苹果登录的图标,需要满足苹果应用市场的审核规范请勿随便修改;如需修改请先阅读:[Sign in with Apple Button](https://appleid.apple.com/signinwithapple/button) -3. 应用登录功能,默认不勾选同意隐私权限是响应安卓应用市场的规范;请勿修改该逻辑。 - -## FAQ:常见问题 -1. 提示“公共模块uni-id缺少配置信息”解决方案:在cloudfunctions右键‘上传所有云函数、公共模块及actions’之后,需要在cloudfunctions -> common -> uni-config-center 目录单独上传一次,右键‘上传公共模块’。 -2. 本项目代码可以商用,无需为DCloud付费。但不能把本项目的代码改造用于非uni-app和uniCloud的技术体系。即,不能将后台改成php、java等其他后台,这将违反使用许可协议。 - -## 相关案例 -[ - ![](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/dd4c366f-6165-46c0-8500-5a679d7e5463.jpg) -](https://ext.dcloud.net.cn/search?q=uni-starter) -(点击跳转到案例列表) - - -## 第三方插件(感谢插件作者,排名不分前后): -1. 图片裁剪 [limeClipper](https://ext.dcloud.net.cn/plugin?id=3594) @作者: 陌上华年 -2. 二维码生成 [Sansnn-uQRCode](https://ext.dcloud.net.cn/plugin?id=1287) @作者: 3snn -3. clipboard.js [clipboard](https://clipboardjs.com/) \ No newline at end of file +

+文档已移至 uni-starter文档 +

\ No newline at end of file diff --git a/changelog.md b/changelog.md index 629c9bd097d07b2ea4f47678ac5a3456fdd9b6eb..6a216ac6db9f721ab50b0e881d7791d4594ad7fd 100644 --- a/changelog.md +++ b/changelog.md @@ -1,3 +1,10 @@ +## 1.2.5(2022-05-29) +升级预置的`uni_modules`->`uni-captcha`版本为:0.6.0。[详情](https://ext.dcloud.net.cn/plugin?name=uni-captcha) +## 1.2.4(2022-05-20) +- 修改`uni-starter.config.js`->`debug`的默认值为`false` +## 1.2.3(2022-05-20) +- 默认关闭`manifest.json`中的扩展配置 +- `uni-starter.config.js` 新增debug,用于配置是否开启调试模式 ## 1.2.2(2022-05-19) - 优化登陆体验,账号密码登陆错误超过2次,再显示图形验证码进行人机校验。 ## 1.2.1(2022-05-18) diff --git a/common/appInit.js b/common/appInit.js index e0eb28af5897db3fcac8f8b9a763144250197ecf..da70ffd2acfb32c8c1fac8f2652fdd5db79550d2 100644 --- a/common/appInit.js +++ b/common/appInit.js @@ -8,7 +8,8 @@ import interceptorChooseImage from '@/uni_modules/json-interceptor-chooseImage/j // #endif const db = uniCloud.database() export default async function() { - let loginConfig = uniStarterConfig.router.login + let loginConfig = uniStarterConfig.router.login; + const debug = uniStarterConfig.debug; //清除有配置但设备环境不支持的登录项 // #ifdef APP-PLUS await new Promise((callBack) => { @@ -152,7 +153,6 @@ export default async function() { } }) - const Debug = false; //拦截器封装callFunction let callFunctionOption; uniCloud.addInterceptor('callFunction', { @@ -200,7 +200,7 @@ export default async function() { }, fail(e) { // 失败回调拦截 console.error('网络请求错误码:',JSON.stringify(e)); - if (Debug) { + if (debug) { uni.showModal({ content: JSON.stringify(e), showCancel: false @@ -375,7 +375,7 @@ export default async function() { }, fail(err) { // 失败回调拦截 console.log(err); - if (Debug) { + if (debug) { console.log(err); uni.showModal({ content: JSON.stringify(err), diff --git a/manifest.json b/manifest.json index 13ba2f7dd75d2fb142d30d731c80a9f59db3cd8f..8f82c59dd129eeb7205440cc020029c818a7a27f 100644 --- a/manifest.json +++ b/manifest.json @@ -1,241 +1,72 @@ { - "name": "", - "appid": "请点击重新获取", - "description": "云端一体应用快速开发模版", - "versionName": "1.0.0", - "versionCode": "100", - "transformPx": false, - "app-plus": { - "locales": { - "en": { - "name": "uni-starter", - "android": { - "strings": { - "CustomKey": "CustomValue" - } + "name" : "uni-starter", + "appid" : "__UNI__EC87F46", + "description" : "", + "versionName" : "1.0.0", + "versionCode" : "100", + "transformPx" : false, + /* 5+App特有相关 */ + "app-plus" : { + "usingComponents" : true, + "nvueStyleCompiler" : "uni-app", + "compilerVersion" : 3, + "splashscreen" : { + "alwaysShowBeforeRender" : true, + "waiting" : true, + "autoclose" : true, + "delay" : 0 }, - "ios": { - "privacyDescription": { - "NSPhotoLibraryUsageDescription": "access to the user’s photo library(read)" - }, - "infoPlist": { - "CustomKey": "CustomValue" - } - } - }, - "zh": { - "name": "统一应用基本项目" - } - }, - "privacy": { - "prompt": "template", - "template": { - "title": "服务协议和隐私政策", - "message": "  请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。
  你可阅读《服务协议》《隐私政策》了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。", - "buttonAccept": "同意", - "buttonRefuse": "暂不同意" - } - }, - "compatible": { - "ignoreVersion": true - }, - "usingComponents": true, - "nvueStyleCompiler": "uni-app", - "compilerVersion": 3, - "splashscreen": { - "alwaysShowBeforeRender": false, - "waiting": true, - "autoclose": true, - "delay": 0 - }, - "modules": { - "Fingerprint": { - }, - "Share": { - }, - "OAuth": { - }, - "FaceID": { - }, - "Geolocation": { - }, - "Bluetooth": { - }, - "Push": { - }, - "Maps": { - } - }, - "distribute": { - "android": { - "permissions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" - ], - "abiFilters": [ - "armeabi-v7a", - "arm64-v8a", - "x86" - ] - }, - "ios": { - "capabilities": { - "entitlements": { - "com.apple.developer.associated-domains": [ - "applinks:static-76ce2c5e-31c7-4d81-8fcf-ed1541ecbc6e.bspapp.com" - ] - } - } - }, - "sdkConfigs": { - "oauth": { - "apple": { - }, - "weixin": { - "appid": "", - "appsecret": "", - "UniversalLinks": "" - }, - "univerify": { - } - }, - "ad": { - }, - "share": { - "weixin": { - "appid": "", - "UniversalLinks": "" - } - }, - "geolocation": { - "baidu": { - "__platform__": [ - "ios", - "android" - ], - "appkey_ios": "请填写地图的key", - "appkey_android": "请填写地图的key" - } - }, - "push": { - "unipush": { - "version": "2", - "offline": true, - "meizu": { - }, - "mi": { - }, - "vivo": { + /* 模块配置 */ + "modules" : {}, + /* 应用发布信息 */ + "distribute" : { + /* android打包配置 */ + "android" : { + "permissions" : [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ] }, - "oppo": { - }, - "hms": { - } - } - }, - "payment": { - }, - "maps": { + /* ios打包配置 */ + "ios" : {}, + /* SDK配置 */ + "sdkConfigs" : {} } - }, - "icons": { - "android": { - "hdpi": "", - "xhdpi": "", - "xxhdpi": "", - "xxxhdpi": "" + }, + /* 快应用特有相关 */ + "quickapp" : {}, + /* 小程序特有相关 */ + "mp-weixin" : { + "appid" : "", + "setting" : { + "urlCheck" : false }, - "ios": { - "appstore": "", - "ipad": { - "app": "", - "app@2x": "", - "notification": "", - "notification@2x": "", - "proapp@2x": "", - "settings": "", - "settings@2x": "", - "spotlight": "", - "spotlight@2x": "" - }, - "iphone": { - "app@2x": "", - "app@3x": "", - "notification@2x": "", - "notification@3x": "", - "settings@2x": "", - "settings@3x": "", - "spotlight@2x": "", - "spotlight@3x": "" - } - } - }, - "splashscreen": { - "iosStyle": "common", - "androidStyle": "common", - "useOriginalMsgbox": true - } + "usingComponents" : true }, - "nvueLaunchMode": "" - }, - "quickapp": { - }, - "mp-weixin": { - "appid": "", - "setting": { - "urlCheck": false, - "es6": false + "mp-alipay" : { + "usingComponents" : true }, - "usingComponents": true, - "betterScopedSlots": true, - "permission": { - "scope.userLocation": { - "desc": "演示在onShow生命周期获取地理位置" - } - } - }, - "mp-alipay": { - "usingComponents": true - }, - "mp-baidu": { - "usingComponents": true - }, - "mp-toutiao": { - "usingComponents": true - }, - "uniStatistics": { - "enable": false - }, - "h5": { - "template": "", - "sdkConfigs": { - "maps": { - "qqmap": { - "key": "" - } - } + "mp-baidu" : { + "usingComponents" : true + }, + "mp-toutiao" : { + "usingComponents" : true }, - "router": { - "base": "" + "uniStatistics" : { + "enable" : false }, - "uniStatistics": { - "enable": true - } - }, - "_spaceID": "", - "vueVersion": "2" -} \ No newline at end of file + "vueVersion" : "2" +} diff --git a/package.json b/package.json index 39d28204e0cc8fd6ab795bead0320c36b234cc51..56e582b41e62ec9309c6bba043fda9d11ce2aeef 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "id": "uni-starter", "displayName": "uni-starter", - "version": "1.2.2", + "version": "1.2.5", "description": "云端一体应用快速开发基本项目模版", "keywords": [ "login", @@ -39,7 +39,8 @@ }, "uni_modules": { "dependencies": [ - "uni-id-cf" + "uni-id-cf", + "uni-captcha" ], "encrypt": [], "platforms": { diff --git a/pages.json b/pages.json index 56346c53302dbc679dd233c68c8f8a4c57393429..bcb5ccbe8e440fa7ca1a87763c28db0dba0b6514 100644 --- a/pages.json +++ b/pages.json @@ -1,5 +1,6 @@ { - "pages": [{ + "pages": [ + { "path": "pages/list/list", "style": { // #ifndef APP-PLUS diff --git a/pages/list/detail.vue b/pages/list/detail.vue index 1b80e683d5577ba250a30f38dfa19bd3c47ada42..9d1d55879b67c606321730fa5e394a59b240286d 100644 --- a/pages/list/detail.vue +++ b/pages/list/detail.vue @@ -121,7 +121,7 @@ } else { uni.showToast({ icon: 'none', - title: this.$t('listDetail').newsErr + title: this.$t('listDetail.newsErr') }) } }, @@ -193,7 +193,7 @@ */ followClick() { uni.showToast({ - title:this.$t('listDetail').follow, + title:this.$t('listDetail.follow'), icon: 'none' }); }, @@ -224,7 +224,7 @@ }, menus: [{ "img": "/static/app-plus/sharemenu/wechatfriend.png", - "text": this.$t('common').wechatFriends, + "text": this.$t('common.wechatFriends'), "share": { "provider": "weixin", "scene": "WXSceneSession" @@ -232,7 +232,7 @@ }, { "img": "/static/app-plus/sharemenu/wechatmoments.png", - "text": this.$t('common').wechatBbs, + "text": this.$t('common.wechatBbs'), "share": { "provider": "weixin", "scene": "WXSceneTimeline" @@ -240,7 +240,7 @@ }, { "img": "/static/app-plus/sharemenu/mp_weixin.png", - "text": this.$t('common').wechatApplet, + "text": this.$t('common.wechatApplet'), "share": { provider: "weixin", scene: "WXSceneSession", @@ -256,7 +256,7 @@ }, { "img": "/static/app-plus/sharemenu/weibo.png", - "text": this.$t('common').weibo, + "text": this.$t('common.weibo'), "share": { "provider": "sinaweibo" } @@ -270,16 +270,16 @@ }, { "img": "/static/app-plus/sharemenu/copyurl.png", - "text": this.$t('common').copy, + "text": this.$t('common.copy'), "share": "copyurl" }, { "img": "/static/app-plus/sharemenu/more.png", - "text": this.$t('common').more, + "text": this.$t('common.more'), "share": "shareSystem" } ], - cancelText: this.$t('common').cancelShare, + cancelText: this.$t('common.cancelShare'), }, e => { //callback console.log(e); }) diff --git a/pages/list/list.nvue b/pages/list/list.nvue index 62214ec8091282862f2365302b0c8fd684b16fdd..b273cfe825a2077d471401dcaf813bea23427d5e 100644 --- a/pages/list/list.nvue +++ b/pages/list/list.nvue @@ -58,7 +58,7 @@