uni-starter可以快速新建一个实现了大部分需求的前端页面，而uni-admin则是快速新建一个可以管理前端页面的后台管理系统，通过schema2code的方法快速生成后端代码。
uni-admin在生成项目后需要配置关联其他应用或服务空间，将其和uni-start创建的项目关联起来，这样两个项目公用一套数据库和云函数，这样就不会互相打架互相影响了。

注意在使用schema2code的时候有两种选项，一种是前端页面，还有一种是uniCloud admin，如果是想要创建后台管理系统则选择uniCloud admin，如果是前端页面则只能在数据库查询到自己上传的内容，而后台管理系统是能直接操控整个数据库的。

如果要修改全局里的页面路由、导航条、选项卡等页面类信息，在pages.json文件中修改：
详细的官方开发文档见下：
/

视频介绍

7.uni-starter和uni-admin快速开发 - 图1

注：视频会有滞后问题，入门为主。最新的完整功能请看以下文档

简介

uni-starter是一个集成了大量商用项目常见功能的，云端一体应用快速开发基本项目模版。

APP有很多通用的功能，比如登录注册、头像、设置、banner、… uni-starter将这些功能都已经集成好。

直接在hbuilderx新建项目选择uni-starter模板，即可在此基础上快速开发自己的特色业务。

有了uni-starter，再加上schema2code生成前端页面，一个简单应用就可以快速完成。

如果说uniCloud admin是管理端项目的基本项目模版，那么uni-starter则是用户端、尤其是移动端的基础项目模板。

uni-starter + uniCloud admin 提供了用户端和管理端的基本项目模版，应用开发从未如此简单快捷！

扫码体验：h5版演示效果（链接：https://uni-starter.dcloud.net.cn）

7.uni-starter和uni-admin快速开发 - 图2

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/登录，按云厂商要求进行实名认证。
  • 在uniCloud认证通过后，创建一个服务空间给本项目使用。选择阿里云或腾讯云均可，两种服务空间差异详情

2. 运行云服务空间初始化向导

7.uni-starter和uni-admin快速开发 - 图3

7.uni-starter和uni-admin快速开发 - 图4

7.uni-starter和uni-admin快速开发 - 图5

功能模块介绍

1.登录模块

登陆类型 描述
smsCode 验证码登录
univerify 读取手机SIM卡一键登录
username 账号密码登录
weixin 微信登录
apple 苹果登录

配置文件：项目根目录/uni-starter.config.js

  1. {
  2.     "router":{
  3.         "login":["username","smsCode"]
  4.     }
  5. }

启用登陆方式

如上示例配置为：["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

平台差异性配置

这里支持用条件编译因此你可以配置在不同平台下拥有的登录方式。
如下配置，即表示仅在APP端启用“短信验证码登陆”

  1. "login": [
  2.     "username","univerify","weixin","apple"
  3.     // #ifdef APP-PLUS
  4.         "smsCode",
  5.     // #endif
  6. ]

生效策略

登陆方式有如上5种，虽然你希望有几种登陆方式就在配置中列举几种。但是有的登陆方式可能因为设备环境问题而不被支持；
比如你正确地配置了微信登陆，而用户的手机并没有安装微信，这样微信登陆功能就无法使用。
并且如果出现这种情况你的app会被iOS的App Store拒绝上架。
所以在这里，我们的生效策略在检测：你是否有列举到某个配置项为前提的情况下，增加了检测当前环境是否支持，如果不支持会自动隐藏。

在uni-app框架中配置：

在应用模块：manifest.json App模块配置 —> OAuth（登录鉴权）—> 勾选并配置你所需要的模块

服务端配置

uni-starter服务端使用uni-config-center统一管理这些配置，
文件路径/uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json
详情下文目录结构 和uni-id配置说明

2.路由拦截

应用场景

有些页面，限允许已经登陆后用户才访问。
常规的做法是打开这类页面之前，检查（前端校验）uni_id_token的值是否有效,如果无效会自动跳转到登陆页面。
而这样的页面有很多，入口也不少。面向过程的写法会产生大量的代码冗余，且不易维护。
而uni-starter基于拦截器（uni.addInterceptor），提供了仅需简单配置即可实现的路由拦截功能。

配置方式

支持两种模式（二选一）

黑名单模式

列举需要强制登陆的页面完整路径（支持正则）

白名单模式

列举不需要强制登陆即可访问的页面完整路径（支持正则）

配置示例

配置文件：项目根目录/uni-starter.config.js

  1. "router": {
  2.         "needLogin" : [
  3.              {pattern:/^\/pages\/list.*/},    //支持正则表达式
  4.                 "/uni_modules/uni-news-favorite/pages/uni-news-favorite/list",
  5.                 "/uni_modules/uni-feedback/pages/uni-feedback/add"
  6.         ],
  7. /*
  8.     请注意上下，黑名单（needLogin）、白名单（visitor）两种配置模式二选一不可同时使用
  9. */
  10.         "visitor" : [
  11.             "/",//注意入口页必须直接写 "/"
  12.             {"pattern":/^\/pages\/list.*/},    //支持正则表达式
  13.             {"pattern":/^\/pages\/ucenter\/login-page.*/},
  14.             "/pages/common/webview/webview",
  15.             "/pages/grid/grid",
  16.             "/pages/ucenter/ucenter",
  17.             "/pages/ucenter/guestbook/guestbook",
  18.             "/pages/ucenter/about/about",
  19.             "/pages/ucenter/settings/settings"
  20.         ]
  21. }

优势：

传统的路由管理方式是对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的介绍 详情

5.升级中心相关

为了解决开发者维护多个 App 升级繁琐，重复逻辑过多，管理不便的问题，升级中心uni-upgrade-center应运而生。
提供了简单、易用、统一的 App 管理、App 版本管理、安装包发布管理，升级检测更新管理。

  • 升级中心分为两个部分：uni-upgrade-center Admin管理后台和uni-upgrade-center - Admin前台检测更新。
  • uni-upgrade-center的介绍 详情
  • uni-upgrade-center - Admin的介绍 详情

6.意见反馈

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节点

  1. "privacy" : {
  2.     "prompt" : "template",
  3.     "template" : {
  4.         "title" : "服务协议和隐私政策",
  5.         "message" : "　　请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款，包括但不限于：为了更好的向你提供服务，我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/>　　你可阅读<a href=\"https://ask.dcloud.net.cn/protocol.html\">《服务协议》</a>和<a href=\"https://ask.dcloud.net.cn/protocol.html\">《隐私政策》</a>了解详细信息。如果你同意，请点击下面按钮开始接受我们的服务。",
  6.         "buttonAccept" : "同意",
  7.         "buttonRefuse" : "暂不同意"
  8.     }
  9. }
  • 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平台隐私与政策提示框配置方法，详情

注意：
  1. 最新的华为应用市场要求，隐私政策提示框上接受按钮的文本，必须为“同意”而不能是其他有歧义的文字。
  2. 配置后提交云端打包后生效。理论上绝大部分和manifest.json生效相关的配置均需要提交云打包后生效

10.拦截器改造后的uniCloud

  1. Debug，调试期间开启Debug。接口一旦fail就会弹出真实错误信息。否则将弹出，系统错误请稍后再试！
  1.     if(Debug){
  2.         console.log(e);
  3.         uni.showModal({
  4.             content: JSON.stringify(e),
  5.             showCancel: false
  6.         });
  7.     }
  1. 断网自动重试，当callFunction为fail时检测是否因断网引起。如果是会提醒用户并且会在恢复网络之后自动重新发起请求
  2. 常规的errCoder自动执行对应程序，如token无效/过期自动跳转到登陆页面。
  3. token自动续期。

11.举例路由控制原理，深入了解拦截器的使用

比如你希望在打开用户中心等页面之前，都检查一下该用户是否登陆，否则就重定向到登陆页面。使用拦截器你可以用以下写法在应用入口定义全局生效：

  1.     //定义各个页面，这里为了演示uni-starter框架是把该定义写在全局配置uni-starter.config.js中
  2.     let needLogin = ["/pages/ucenter/userinfo/userinfo", ... ] 
  4.     uni.addInterceptor("navigateTo", {
  5.         invoke(e) { // 调用前拦截
  6.             //获取用户的token
  7.             const token = uni.getStorageSync('uni_id_token')
  8.             //获取当前页面路径（即url去掉"?"和"?"后的参数）
  9.             const url = e.url.split('?')[0]
  10.             //判断要打开的页面是否需要验证登陆
  11.             if (needLogin.includes(url) && token == '') {
  12.                 uni.showToast({
  13.                     title: '该页面需要登录才能访问，请先登录',
  14.                     icon: 'none'
  15.                 })
  16.                 uni.navigateTo({
  17.                     url: "/pages/ucenter/login-page/index/index"
  18.                 })
  19.                 return false
  20.             }
  21.         },
  22.         fail(err) { // 失败回调拦截 
  23.             console.log(err);
  24.         },
  25.     })
  • 而路由跳转方法不仅有uni.navigateTo还有uni.redirectTo,uni.reLaunch,uni.switchTab；
  • 另外我们还希望控制直接跳转至哪种登陆类型
    所以在uni-starter框架中我们这样定义：
    uni-starter/common/appInit.js 的第228-280行
  1.     const {"router": {needLogin,login} } = uniStarterConfig //需要登录的页面
  2.     let list = ["navigateTo", "redirectTo", "reLaunch", "switchTab"];
  3.     list.forEach(item => { //用遍历的方式分别为,uni.navigateTo,uni.redirectTo,uni.reLaunch,uni.switchTab这4个路由方法添加拦截器
  4.         uni.addInterceptor(item, {
  5.             invoke(e) { // 调用前拦截
  6.                 //获取用户的token
  7.                 const token = uni.getStorageSync('uni_id_token')
  8.                 //获取当前页面路径（即url去掉"?"和"?"后的参数）
  9.                 const url = e.url.split('?')[0]
  10.                 //判断要打开的页面是否需要验证登陆
  11.                 if (needLogin.includes(url) && token == '') {
  12.                     uni.showToast({
  13.                         title: '该页面需要登录才能访问，请先登录',
  14.                         icon: 'none'
  15.                     })
  16.                     uni.navigateTo({
  17.                         url: "/pages/ucenter/login-page/index/index"
  18.                     })
  19.                     return false
  20.                 }
  21.                 //控制登录优先级
  22.                 if (url == '/pages/ucenter/login-page/index/index') {
  23.                     //一键登录（univerify）、账号（username）、验证码登录（短信smsCode）
  24.                     if (login[0] == 'univerify') {
  25.                         if(e.url == url) { e.url += '?' } //添加参数之前判断是否带了`？`号如果没有就补上，因为当开发场景本身有参数的情况下是已经带了`？`号
  26.                         e.url += "univerify_first=true"
  27.                     } else if (login[0] == 'username') {
  28.                         e.url = "/pages/ucenter/login-page/pwd-login/pwd-login"
  29.                     }
  30.                 }
  31.                 return true
  32.             },
  33.             fail(err) { // 失败回调拦截 
  34.                 console.log(err);
  35.             },
  36.         })
  37.     })

12.关于升级

  • 项目升级
    uni-starter遵循uni-app的插件模块化规范，即：uni_modules 。他是个项目类型的插件。在项目的根目录下有一个符合uni_modules规范的package.json文件，在这个文件右键-从插件市场更新即可更新该插件。
  • 插件升级
    非项目类型的uni_modules插件，是项目根目录下的uni_modules目录下。以插件ID为插件文件夹命名，在该目录右键也会看到“从插件市场更新”选项，点击即可更新该插件。

13.多语言国际化

  1. uni-starter支持多语言国际化。默认开启，可以在`uni-starter.config.js`->`i18n`->`enable`中配置
  2. 如果你启用了多语言国际化需要先阅读：[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

  1.     import initApp from '@/common/appInit.js';
  2.     export default {
  3.         onLaunch: function() {
  4.             initApp();
  5.         }
  6.     }

onLaunch生命周期执行了

  1. 全局监听clientDB的err事件，
    • 判断是否为token过期失效等需要重新登录的问题。自动跳转到登录页面
    • 检测本地的token是否有效（存在且并未过期）否则跳转到登录页面
  2. 预登录一键登录功能
  3. 执行了initApp()包含以下操作
    1. 读取uni-starter.config并挂载到globalData的config下
    2. 读取应用版本号，并存到globalData下
    3. 检查是否有可更新的应用版本，决定是否启动在线更新版本
    4. 监听设备的网络变化并以uni.showToast APi的方式提醒用户
    5. 使用拦截器 实现
      • 页面路由拦截，配置需强制登录的页面；打开时检测，如果token无效就自动跳转到登录页
      • 优雅实现：自动引导打开选择图片所需要的权限。当调用uni.chooseImage时检测到无权限自动开启引导。并不是在每次调用接口时处理这类问题，你可以参考该例子做更多该类场景的处理。uni-starter也会持续完善

配置文件

uni-starter提供了uni-starter.config.js，可配置选择登录注册方式及优先级等，可指定该应用是否强制登录才能进入某个页面。配置项内容如下：

  1. module.exports = {
  2.     "h5": {
  3.         "url": "https://static-76ce2c5e-31c7-4d81-8fcf-ed1541ecbc6e.bspapp.com", //    前端网页托管的域名
  4.          // 在h5端全局悬浮引导用户下载app的功能 更多自定义要求在/common/openApp.js中修改
  5.         "openApp": {
  6.             //点击悬浮下载栏后打开的网页链接
  7.             "openUrl": 'https://sj.qq.com/myapp/detail.htm?apkName=com.tencent.android.qqdownloader&info=6646FD239A6EBA9E2DEE5DFC7E18D867',
  8.             //左侧显示的应用名称
  9.             "appname": 'uni-starter',
  10.             //应用的图标
  11.             "logo": './static/logo.png',
  12.         }
  13.     },
  14.     "mp": {
  15.         "weixin": {
  16.             //微信小程序原始id，微信小程序分享时
  17.             "id": "gh_132465798"
  18.         }
  19.     },
  20.     "router": {
  21.         //配置需要路由拦截的页面地址，在打开这些页面之前会自动检查（无需联网）uni_id_token的值，如果token无效就自动跳转到登录页
  22.         "needLogin": [
  23.             "/pages/ucenter/userinfo/userinfo",
  24.             "/uni_modules/uni-news-favorite/pages/uni-news-favorite/list",
  25.         ],
  26.         "login": ["smsCode","univerify", "username", "weixin", "apple"],
  27.         /* 
  28.             这里会根据数组的第0项，决定登录方式的第一优先级是哪种登录方式。
  29.             所有你希望拥有的登录方式这里都需要一一列举，未列举到的或设备环境不支持的登录方式将被隐藏。
  30.             如果你需要在不同平台有不同的配置，直接用条件编译即可。
  31.         */
  32.     },
  33.     //关于应用
  34.     "about": {
  35.         //应用名称
  36.         "appName": "uni-starter",
  37.         //应用logo
  38.         "logo": "/static/logo.png",
  39.         //公司名称
  40.         "company": "数字天堂（北京）网络技术有限公司",
  41.         //口号
  42.         "slogan": "为开发而生",
  43.         //政策协议
  44.         "agreements": [{
  45.                 "title": "用户服务协议", //协议名称
  46.                 "url": "https://ask.dcloud.net.cn/protocol.html" //对应的网络链接
  47.             },
  48.             {
  49.                 "title": "隐私政策",
  50.                 "url": "https://ask.dcloud.net.cn/protocol.html"
  51.             }
  52.         ],
  53.         //应用的链接，用于分享到第三方平台和生成关于我们页的二维码
  54.         "download": "https://m3w.cn/uniapp"
  55.     },
  56.     //用于打开应用市场评分界面
  57.     "marketId":{
  58.         "ios":"id1417078253",
  59.         "android":"123456"
  60.     },
  61.     //配置多语言国际化。i18n为英文单词 internationalization的首末字符i和n，18为中间的字符数 是“国际化”的简称
  62.     "i18n":{
  63.         "enable":false //默认启用，国际化。如果你不想使用国际化相关功能，请改为false
  64.     }
  65. }

目录结构@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 @作者： 陌上华年
│ │ │ │ ├─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_tools uni_modules插件上传辅助脚本 详情。
├─main.js Vue初始化入口文件
├─App.vue 应用配置，用来配置App全局样式以及监听 应用生命周期
├─uni-starter.config uni-starter的前端的配置文件，项目所有模块的配置在这里填写。详见该文件的代码注释。
├─manifest.json 配置应用名称、appid、logo、版本等打包信息，详见
└─pages.json 配置页面路由、导航条、选项卡等页面类信息，详见

完整的uni-app目录结构详情

常见API示范

  1. 判断当前用户是否拥有某角色uniIDHasRole 演示页面：/pages/grid/grid API文档详情：
  2. 指纹解锁、人脸解锁 演示页面：/pages/ucenter/settings/settings API文档详情：

注意事项

  1. 真机运行需要制作自定义基座，制作后选择运行到自定义基座
  2. 苹果登录的图标，需要满足苹果应用市场的审核规范请勿随便修改；如需修改请先阅读:Sign in with Apple Button
  3. 应用登录功能，默认不勾选同意隐私权限是响应安卓应用市场的规范；请勿修改该逻辑。

FAQ：常见问题

  1. 提示“公共模块uni-id缺少配置信息”解决方案：在cloudfunctions右键‘上传所有云函数、公共模块及actions’之后，需要在cloudfunctions -> common -> uni-config-center 目录单独上传一次，右键‘上传公共模块’。
  2. 本项目代码可以商用，无需为DCloud付费。但不能把本项目的代码改造用于非uni-app和uniCloud的技术体系。即，不能将后台改成php、java等其他后台，这将违反使用许可协议。

第三方插件（感谢插件作者，排名不分前后）：

  1. 图片裁剪 limeClipper @作者： 陌上华年
  2. 二维码生成 Sansnn-uQRCode @作者： 3snn
  3. clipboard.js clipboard