Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
梦想橡皮擦
uni-starter
提交
56f8588b
U
uni-starter
项目概览
梦想橡皮擦
/
uni-starter
与 Fork 源项目一致
Fork自
DCloud / uni-starter
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-starter
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
56f8588b
编写于
6月 09, 2022
作者:
DCloud_JSON
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
升级预置的`uni_modules`->`uni-captcha`版本为:0.6.0。[详情](
https://ext.dcloud.net.cn/plugin?name=uni-captcha
)
上级
60c2ced4
变更
21
隐藏空白更改
内联
并排
Showing
21 changed file
with
145 addition
and
862 deletion
+145
-862
README.md
README.md
+3
-569
changelog.md
changelog.md
+7
-0
common/appInit.js
common/appInit.js
+4
-4
manifest.json
manifest.json
+63
-232
package.json
package.json
+3
-2
pages.json
pages.json
+2
-1
pages/list/detail.vue
pages/list/detail.vue
+9
-9
pages/list/list.nvue
pages/list/list.nvue
+2
-2
pages/ucenter/about/about.vue
pages/ucenter/about/about.vue
+6
-6
pages/ucenter/login-page/index/index.vue
pages/ucenter/login-page/index/index.vue
+1
-1
pages/ucenter/login-page/pwd-login/pwd-login.vue
pages/ucenter/login-page/pwd-login/pwd-login.vue
+3
-3
pages/ucenter/login-page/register/register.vue
pages/ucenter/login-page/register/register.vue
+10
-5
pages/ucenter/ucenter.vue
pages/ucenter/ucenter.vue
+6
-6
uni-starter.config.js
uni-starter.config.js
+2
-0
uni_modules/uni-captcha/changelog.md
uni_modules/uni-captcha/changelog.md
+3
-0
uni_modules/uni-captcha/components/uni-captcha/uni-captcha.vue
...odules/uni-captcha/components/uni-captcha/uni-captcha.vue
+1
-1
uni_modules/uni-captcha/components/uni-popup-captcha/uni-popup-captcha.vue
...aptcha/components/uni-popup-captcha/uni-popup-captcha.vue
+12
-4
uni_modules/uni-captcha/package.json
uni_modules/uni-captcha/package.json
+1
-1
uni_modules/uni-captcha/uniCloud/cloudfunctions/common/uni-captcha/index.js
...ptcha/uniCloud/cloudfunctions/common/uni-captcha/index.js
+1
-1
uni_modules/uni-captcha/uniCloud/cloudfunctions/uni-captcha-co/index.obj.js
...ptcha/uniCloud/cloudfunctions/uni-captcha-co/index.obj.js
+6
-10
uni_modules/uni-captcha/uniCloud/database/db_init.json
uni_modules/uni-captcha/uniCloud/database/db_init.json
+0
-5
未找到文件。
README.md
浏览文件 @
56f8588b
#### 视频介绍
<a
target=
"_blank"
href=
"https://www.bilibili.com/video/BV17p4y1a71x?p=11"
>
<img
src=
"https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/71d310a5-ef69-4ca5-88c8-9a3abf8fb8e3.png"
alt=
"腾讯课堂uniCloud视频教程"
style=
"width: 70%;margin-bottom:26px;"
>
</a>
注:视频会有滞后问题,入门为主。最新的完整功能请看以下文档
#### 简介
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))
<img
src=
"https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/0625ae17-1262-45cb-a713-cdbf02df5c0a.png"
style=
"width: 120px;"
>
### 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. 运行云服务空间初始化向导
<img
style=
"width:61.8%"
src=
"https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/472d8525-4e64-4a86-a77a-8c37c4379610.jpg"
/>
<img
style=
"width:61.8%"
src=
"https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/78b3f17c-cf70-4cdf-9ada-1796753ffeac.jpg"
/>
<img
style=
"width:61.8%"
src=
"https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/09916d79-4753-4baa-9b95-baa831f1a873.jpg"
/>
## 功能模块介绍
### 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
"
:
"
请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/> 你可阅读<a href=
\"
https://ask.dcloud.net.cn/protocol.html
\"
>《服务协议》</a>和<a href=
\"
https://ask.dcloud.net.cn/protocol.html
\"
>《隐私政策》</a>了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。
"
,
"
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
<pre>
uni-starter
├─uniCloud-aliyun
│ ├─cloudfunctions 云函数目录
│ | ├─common 公共模块
│ │ | ├─uni-config-center uni-starter的服务端配置中心,项目所有云函数的配置在这里填写
<a
target=
"_blank"
href=
"https://ext.dcloud.net.cn/plugin?id=4425"
>
详情
</a>
│ │ | | ├─index.js config-center入口文件
│ │ | | └─uni-id uni-id模块配置目录
│ │ | | ├─config.json uni-id对应的配置数据:微信登录、一键登录、短信验证码登录等key都在这里填写
<a
target=
"_blank"
href=
"https://ext.dcloud.net.cn/plugin?id=4425"
>
详情
</a>
│ │ | | └─file.cert uni-id依赖的配置文件,假如你使用微信发红包功能,需要的证书文件就是放到这里
│ | | └───uni-id uni-id用户体系
<a
target=
"_blank"
href=
"https://uniapp.dcloud.io/uniCloud/uni-id"
>
详情
</a>
│ | ├─uni-analyse-searchhot 云端一体搜索模板依赖的云函数
<a
target=
"_blank"
href=
"https://ext.dcloud.net.cn/plugin?id=3851"
>
详情
</a>
│ | └─uni-id-cf 用户中心云函数,实现用户注册、修改密码、发送验证码、快捷登录(微信、短信、账户、一键登录)
│ └──database 云数据目录
│ ├─db_init.json db_init.json初始化数据库文件,其中不再包含schema
<a
target=
"_blank"
href=
"https://uniapp.dcloud.net.cn/uniCloud/hellodb?id=db-init"
>
详情
</a>
│ ├─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 存放应用引用的本地静态资源(如图片、视频等)的目录,
<b>
注意:
</b>
静态资源只能存放于此
├─uni_modules 存放
[
uni_module
](
/uni_modules
)
规范的插件。
├─uni_modules_tools uni_modules插件上传辅助脚本
<a
href=
"https://ext.dcloud.net.cn/plugin?id=5256"
>
详情
</a>
。
├─main.js Vue初始化入口文件
├─App.vue 应用配置,用来配置App全局样式以及监听
<a
href=
"/collocation/frame/lifecycle?id=应用生命周期"
>
应用生命周期
</a>
├─uni-starter.config uni-starter的前端的配置文件,项目所有模块的配置在这里填写。详见该文件的代码注释。
├─manifest.json 配置应用名称、appid、logo、版本等打包信息,
<a
href=
"/collocation/manifest"
>
详见
</a>
└─pages.json 配置页面路由、导航条、选项卡等页面类信息,
<a
href=
"/collocation/pages"
>
详见
</a>
</pre>
完整的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
<h2>
文档已移至
<a
href=
"https://uniapp.dcloud.io/uniCloud/uni-starter.html"
target=
"_blank"
>
uni-starter文档
</a>
</h2>
\ No newline at end of file
changelog.md
浏览文件 @
56f8588b
## 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)
...
...
common/appInit.js
浏览文件 @
56f8588b
...
...
@@ -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
(
D
ebug
)
{
if
(
d
ebug
)
{
uni
.
showModal
({
content
:
JSON
.
stringify
(
e
),
showCancel
:
false
...
...
@@ -375,7 +375,7 @@ export default async function() {
},
fail
(
err
)
{
// 失败回调拦截
console
.
log
(
err
);
if
(
D
ebug
)
{
if
(
d
ebug
)
{
console
.
log
(
err
);
uni
.
showModal
({
content
:
JSON
.
stringify
(
err
),
...
...
manifest.json
浏览文件 @
56f8588b
{
"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"
:
" 请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款,包括但不限于:为了更好的向你提供服务,我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/> 你可阅读<a href=
\"
https://ask.dcloud.net.cn/protocol.html
\"
>《服务协议》</a>和<a href=
\"
https://ask.dcloud.net.cn/protocol.html
\"
>《隐私政策》</a>了解详细信息。如果你同意,请点击下面按钮开始接受我们的服务。"
,
"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"
:
[
"<uses-feature android:name=
\"
android.hardware.camera
\"
/>"
,
"<uses-feature android:name=
\"
android.hardware.camera.autofocus
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.ACCESS_NETWORK_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.ACCESS_WIFI_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.CAMERA
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.CHANGE_NETWORK_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.CHANGE_WIFI_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.FLASHLIGHT
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.MODIFY_AUDIO_SETTINGS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.MOUNT_UNMOUNT_FILESYSTEMS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.READ_LOGS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.READ_PHONE_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.USE_FINGERPRINT
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.VIBRATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.WAKE_LOCK
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.WRITE_SETTINGS
\"
/>"
],
"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"
:
[
"<uses-permission android:name=
\"
android.permission.CHANGE_NETWORK_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.MOUNT_UNMOUNT_FILESYSTEMS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.VIBRATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.READ_LOGS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.ACCESS_WIFI_STATE
\"
/>"
,
"<uses-feature android:name=
\"
android.hardware.camera.autofocus
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.ACCESS_NETWORK_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.CAMERA
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.GET_ACCOUNTS
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.READ_PHONE_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.CHANGE_WIFI_STATE
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.WAKE_LOCK
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.FLASHLIGHT
\"
/>"
,
"<uses-feature android:name=
\"
android.hardware.camera
\"
/>"
,
"<uses-permission android:name=
\"
android.permission.WRITE_SETTINGS
\"
/>"
]
},
"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"
}
package.json
浏览文件 @
56f8588b
{
"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"
:
{
...
...
pages.json
浏览文件 @
56f8588b
{
"pages"
:
[{
"pages"
:
[
{
"path"
:
"pages/list/list"
,
"style"
:
{
//
#ifndef
APP-PLUS
...
...
pages/list/detail.vue
浏览文件 @
56f8588b
...
...
@@ -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
);
})
...
...
pages/list/list.nvue
浏览文件 @
56f8588b
...
...
@@ -58,7 +58,7 @@
</template>
<script>
var cdbRef, currentWebview
;
let cdbRef
;
import statusBar from "@/uni_modules/uni-nav-bar/components/uni-nav-bar/uni-status-bar";
import Gps from '@/uni_modules/json-gps/js_sdk/gps.js';
...
...
@@ -101,7 +101,7 @@
}
}
},
async onReady() {
async onReady() {
// #ifdef APP-NVUE
/* 可用窗口高度 - 搜索框高 - 状态栏高 */
this.listHight = uni.getSystemInfoSync().windowHeight - uni.getSystemInfoSync().statusBarHeight - 50 + 'px';
...
...
pages/ucenter/about/about.vue
浏览文件 @
56f8588b
...
...
@@ -76,7 +76,7 @@
},
menus
:
[{
"
img
"
:
"
/static/app-plus/sharemenu/wechatfriend.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
wechatFriends
,
"
text
"
:
this
.
$t
(
'
common
.wechatFriends
'
)
,
"
share
"
:
{
"
provider
"
:
"
weixin
"
,
"
scene
"
:
"
WXSceneSession
"
...
...
@@ -84,7 +84,7 @@
},
{
"
img
"
:
"
/static/app-plus/sharemenu/wechatmoments.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
wechatBbs
,
"
text
"
:
this
.
$t
(
'
common
.wechatBbs
'
)
,
"
share
"
:
{
"
provider
"
:
"
weixin
"
,
"
scene
"
:
"
WXSceneTimeline
"
...
...
@@ -92,7 +92,7 @@
},
{
"
img
"
:
"
/static/app-plus/sharemenu/weibo.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
weibo
,
"
text
"
:
this
.
$t
(
'
common
.weibo
'
)
,
"
share
"
:
{
"
provider
"
:
"
sinaweibo
"
}
...
...
@@ -106,16 +106,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
);
})
...
...
pages/ucenter/login-page/index/index.vue
浏览文件 @
56f8588b
...
...
@@ -91,7 +91,7 @@
sendShortMsg
()
{
if
(
!
this
.
agree
)
{
return
uni
.
showToast
({
title
:
this
.
$t
(
'
common
'
).
noAgree
,
title
:
this
.
$t
(
'
common
.noAgree
'
)
,
icon
:
'
none
'
});
}
...
...
pages/ucenter/login-page/pwd-login/pwd-login.vue
浏览文件 @
56f8588b
...
...
@@ -55,7 +55,7 @@
pwdLogin
()
{
if
(
!
this
.
agree
)
{
return
uni
.
showToast
({
title
:
this
.
$t
(
'
common
'
).
noAgree
,
title
:
this
.
$t
(
'
common
.noAgree
'
)
,
icon
:
'
none
'
});
}
...
...
@@ -84,10 +84,10 @@
// this.createCaptcha()
}
else
{
uni
.
showModal
({
title
:
this
.
$t
(
'
common
'
).
error
,
title
:
this
.
$t
(
'
common
.error
'
)
,
content
:
result
.
msg
,
showCancel
:
false
,
confirmText
:
this
.
$t
(
'
common
'
).
gotIt
confirmText
:
this
.
$t
(
'
common
.gotIt
'
)
});
}
}
...
...
pages/ucenter/login-page/register/register.vue
浏览文件 @
56f8588b
...
...
@@ -17,7 +17,7 @@
<uni-captcha
scene=
"register"
v-model=
"formData.captcha"
></uni-captcha>
</uni-forms-item>
<uni-agreements
@
setAgree=
"agree = $event"
></uni-agreements>
<button
class=
"send-btn"
type=
"primary
"
@
click=
"submit"
>
{{
$t
(
'
register.registerAndLogin
'
)
}}
</button>
<button
class=
"send-btn"
:disabled=
"!canSubmit"
:type=
"canSubmit?'primary':'default'
"
@
click=
"submit"
>
{{
$t
(
'
register.registerAndLogin
'
)
}}
</button>
</uni-forms>
</view>
</
template
>
...
...
@@ -34,12 +34,17 @@ import mixin from '../common/login-page.mixin.js';
"
nickname
"
:
""
,
"
password
"
:
""
,
"
pwd2
"
:
""
,
"
captcha
"
:
false
"
captcha
"
:
""
},
rules
,
agree
:
false
agree
:
false
,
}
},
},
computed
:{
canSubmit
(){
return
this
.
formData
.
username
.
length
&&
this
.
formData
.
password
.
length
&&
this
.
formData
.
captcha
.
length
==
4
&&
this
.
agree
}
},
onReady
()
{
this
.
$refs
.
form
.
setRules
(
this
.
rules
)
},
...
...
@@ -55,7 +60,7 @@ import mixin from '../common/login-page.mixin.js';
submit
()
{
if
(
!
this
.
agree
){
return
uni
.
showToast
({
title
:
this
.
$t
(
'
common
'
).
noAgree
,
title
:
this
.
$t
(
'
common
.noAgree
'
)
,
icon
:
'
none
'
});
}
...
...
pages/ucenter/ucenter.vue
浏览文件 @
56f8588b
...
...
@@ -295,7 +295,7 @@
},
menus
:
[{
"
img
"
:
"
/static/app-plus/sharemenu/wechatfriend.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
wechatFriends
,
"
text
"
:
this
.
$t
(
'
common
.wechatFriends
'
)
,
"
share
"
:
{
"
provider
"
:
"
weixin
"
,
"
scene
"
:
"
WXSceneSession
"
...
...
@@ -303,7 +303,7 @@
},
{
"
img
"
:
"
/static/app-plus/sharemenu/wechatmoments.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
wechatBbs
,
"
text
"
:
this
.
$t
(
'
common
.wechatBbs
'
)
,
"
share
"
:
{
"
provider
"
:
"
weixin
"
,
"
scene
"
:
"
WXSceneTimeline
"
...
...
@@ -311,7 +311,7 @@
},
{
"
img
"
:
"
/static/app-plus/sharemenu/weibo.png
"
,
"
text
"
:
this
.
$t
(
'
common
'
).
weibo
,
"
text
"
:
this
.
$t
(
'
common
.weibo
'
)
,
"
share
"
:
{
"
provider
"
:
"
sinaweibo
"
}
...
...
@@ -325,16 +325,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
);
})
...
...
uni-starter.config.js
浏览文件 @
56f8588b
//这是应用的配置页面,App.vue挂载到getApp().globalData.config
export
default
{
//是否打开调试模式
"
debug
"
:
false
,
"
h5
"
:
{
"
url
"
:
"
https://uni-starter.dcloud.net.cn
"
,
// 前端网页托管的域名
// 在h5端全局悬浮引导用户下载app的功能 更多自定义要求在/common/openApp.js中修改
...
...
uni_modules/uni-captcha/changelog.md
浏览文件 @
56f8588b
## 0.6.0(2022-05-27)
-
新增:支持在
`uni-config-center`
中根据场景值配置
-
修复:弹窗式验证码,输入内容后点击取消,重新打开验证码的值仍然存在的问题
## 0.5.2(2022-05-19)
-
修复在Vue3的兼容问题
## 0.5.1(2022-05-18)
...
...
uni_modules/uni-captcha/components/uni-captcha/uni-captcha.vue
浏览文件 @
56f8588b
...
...
@@ -58,7 +58,7 @@
scene
:
{
handler
(
scene
)
{
if
(
scene
)
{
this
.
getImageCaptcha
(
false
)
this
.
getImageCaptcha
(
this
.
focus
)
}
else
{
uni
.
showToast
({
title
:
'
scene不能为空
'
,
...
...
uni_modules/uni-captcha/components/uni-popup-captcha/uni-popup-captcha.vue
浏览文件 @
56f8588b
...
...
@@ -3,7 +3,7 @@
<view
class=
"popup-captcha"
>
<view
class=
"content"
>
<text
class=
"title"
>
{{
title
}}
</text>
<uni-captcha
:scene=
"scene"
v-model=
"val"
></uni-captcha>
<uni-captcha
:
focus=
"focus"
:
scene=
"scene"
v-model=
"val"
></uni-captcha>
</view>
<view
class=
"button-box"
>
<view
@
click=
"close"
class=
"btn"
>
取消
</view>
...
...
@@ -15,6 +15,11 @@
<
script
>
export
default
{
data
()
{
return
{
focus
:
false
}
},
props
:
{
modelValue
:
String
,
value
:
String
,
...
...
@@ -51,14 +56,17 @@
}
},
methods
:
{
open
()
{
open
()
{
this
.
focus
=
true
this
.
val
=
""
this
.
$refs
.
popup
.
open
()
},
close
()
{
close
()
{
this
.
focus
=
false
this
.
$refs
.
popup
.
close
()
},
confirm
()
{
if
(
this
.
val
.
length
<
4
){
if
(
!
this
.
val
||
this
.
val
.
length
<
4
){
return
uni
.
showToast
({
title
:
'
请填写验证码
'
,
icon
:
'
none
'
...
...
uni_modules/uni-captcha/package.json
浏览文件 @
56f8588b
{
"id"
:
"uni-captcha"
,
"displayName"
:
"uni-captcha"
,
"version"
:
"0.
5.2
"
,
"version"
:
"0.
6.0
"
,
"description"
:
"云端一体图形验证码组件"
,
"keywords"
:
[
"uniCloud"
,
...
...
uni_modules/uni-captcha/uniCloud/cloudfunctions/common/uni-captcha/index.js
浏览文件 @
56f8588b
因为 它太大了无法显示 source diff 。你可以改为
查看blob
。
uni_modules/uni-captcha/uniCloud/cloudfunctions/uni-captcha-co/index.obj.js
浏览文件 @
56f8588b
...
...
@@ -11,9 +11,9 @@ module.exports = {
})
{
//获取设备id
let
{
deviceId
,
deviceId
,
platform
}
=
this
.
getClientInfo
();
}
=
this
.
getClientInfo
();
//根据:设备id、场景值、状态,查找记录是否存在
let
res
=
await
verifyCodes
.
where
({
scene
,
...
...
@@ -24,13 +24,9 @@ module.exports = {
let
action
=
res
.
data
.
length
?
'
refresh
'
:
'
create
'
//执行并返回结果
//导入配置,配置优先级说明:此处配置 > uni-config-center
const
config
=
require
(
'
./config
'
)
return
await
uniCaptcha
[
action
](
Object
.
assign
(
config
,
// 配置优先级说明:此配置 > uni-config-center
{
scene
,
//来源客户端传递,表示:使用场景值,用于防止不同功能的验证码混用
uniPlatform
:
platform
},
))
return
await
uniCaptcha
[
action
]({
scene
,
//来源客户端传递,表示:使用场景值,用于防止不同功能的验证码混用
uniPlatform
:
platform
})
}
}
uni_modules/uni-captcha/uniCloud/database/db_init.json
已删除
100644 → 0
浏览文件 @
60c2ced4
//
在本文件中可配置云数据库初始化,数据格式见:https://uniapp.dcloud.io/uniCloud/hellodb?id=db-init
//
编写完毕后对本文件点右键,可按配置规则创建表和添加数据
{
"opendb-verify-codes"
:{}
}
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录