uni-app开发小程序

一、项目准备工作

1.uni-app介绍（地址）

​        uni-app是一个使用Vue.js开发所有前端应用的框架，开发者编写一套代码，可发布到iOS、Android、Web（响应式）、以及各种小程序（微信/支付宝/百度/头条/飞书/QQ/快手/钉钉/淘宝）、快应用等多个平台。

2.开发工具下载和安装

        2.1介绍

uni-app官方推荐使用HBuilderX来开发uni-app类型的项目,主要好处：模板丰富、完善的智能提示、一键运行

        2.2下载HBuilderX

1.下载的地址https://www.dcloud.io/hbuilderx.html2.下载 正式版->App开发版

        2.3安装HBuilderX

1.将下载的zip包进行解压2.将解压的文件放到一个纯英文的目录下3.双击HBuilderX.exe即可启动HBuilderX

3.开发工具的配置

     3.1安装scss/sass编译    

        介绍

为了方便编写样式,建议安装'scss/sass编辑'插件

        下载地址 (scss/sass编译 - DCloud 插件市场)

                操作步骤：1.先注册 2.点击下载插件并导入HBuilderX

        3.2快捷键方案切换

                操作步骤:工具->预设快捷键方案切换->vs Code

        3.3修改编辑器的基本设置

                操作步骤：工具->设置 ，点击源码视图

二、项目开发

1.网络请求配置

        1.1.介绍(@escook/request-miniprogram - npm)

由于平台限制，小程序不支持axios，而且原生的wx.request()API功能较为简单,不支持拦截器等全局定制的功能，因此建议在uni-app项目中使用@escook/request-miniprogram第三方包发起网络数据请求

        1.2.添加依赖

npm init -y //初始化npm项目npm install @escook/request-miniprogram

        1.3.配置网络请求

// 按需导入 $http 对象import { $http } from '@escook/request-miniprogram'//配置网络请求库$http.baseUrl = '' // 请求根路径//请求拦截器$http.beforeRequest = function (options) {  // 展示loading框  uni.showLoading({  title:'数据加载中...'  })}//响应拦截器$http.afterRequest = function () {  // 隐藏加载框  uni.hideLoading()}// 在 uni-app 项目中，可以把 $http 挂载到 uni 顶级对象之上，方便全局调用uni.$http = $http

  2. 小程序分包加载

         2.1.介绍

分包指的是把一个完整的小程序项目，按照需求划分为不同的子包，在构建时打包成不同的分包，用户在使用时按需进行加载

        2.2分包的好处

a.可以优化小程序首次启动时下载时间b.在多团队共同开发式可以更好的解藕协作

        2.3.分包加载

                2.3.1分包加载前后项目的结构

1.分包前，小程序项目中所有的页面和资源都被打包到一起，导致整个项目体积过大，影响小程序首次启动的下载时间2.分包后，小程序项目由一个主包+多个分包组成：主包：一般只包含项目的启动页面或TabBar页面，以及所有主包都需要用到的一些公共资源分包：只包含和当前分包有关的页面和私有资源

                2.3.2分包的加载规则

1.  在小程序启动时，默认会下载主包并启动主包内页面2.  当用户进入分包内某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示注意： 非  tabBar 页面可以按照功能的不同，划分为不同的分包之后，进行按需下载

                2.3.3分包的体积限制

整个小程序所有分包大小不超过  20M （主包 + 所有分包）单个分包/主包大小不能超过  2M

        3.4分包的配置

                3.4.1定义

1.在项目的根目录中，创建分包的根目录，命名为subpkg2.在pages.json中，和pages字段平级的位置声明subPackages数据节点中，用来定义分包相关的结构：

                 3.4.2使用

1.pages.json配置  {"subPackages": [{"root": "subpkg","pages": []}],  }2.创建目录subpkg3.在subpkg目录下页面4.配置页面后会在pages.json中subPackages.pages中自动填写创建的页面信息

                3.4.3新建分包文件

3.自定义组件使用

        3.1.创建组件

在项目根目录的 components 目录上，鼠标右键，选择 新建组件，填写组件信息，最后点击 创建 按钮

       3.2.使用

直接以标签的形式使用不需要引入

4.组件使用

        4.1获取页面可用高度

const sysInfo = uni.getSystemInfoSync()

        4.2数据保存到本地

uni.setStorageSync('定义参数', 保存的值) //保存uni.getStorageSync('定义参数')  // 获取

        4.3.图片预览功能

1.使用    // 调用 uni.previewImage() 方法预览图片        uni.previewImage({            // 预览时，默认显示图片的索引            current: 1,            // 所有图片 url 地址的数组    urls: []})

        4.4商品导航组件 uni-goods-nav

                地址：导航组件

                效果

                         

        4.5.为tabBar 设置数字徽标

 // 调用 uni.setTabBarBadge() 方法，设置购物车右上角徽标      uni.setTabBarBadge({        index: 2,  //位置        text: 2 + '', // 注意：text 的值必须是字符串，不能是数字，显示的图标      })

                效果

                        

        4.6.混入功能

1.新建一个mixins文件夹2.文件下创建一个.js文件3.配置内容export default {  computed: {},  methods: {  },  data:{  return{    }  }}4.在需要的vue文件中使用// 导入自己封装的 mixin 模块import badgeMix from '@/mixins/xxxx.js'export default {  // 将 badgeMix 混入到当前的页面中进行使用  mixins: [badgeMix],  // 省略其它代码...}

        4.7调用小程序的方法获取用户地址

// 1. 调用小程序提供的 chooseAddress() 方法，即可使用选择收货地址的功能//    返回值是一个数组：第 1 项为错误对象；第 2 项为成功之后的收货地址对象const [err, succ] = await uni.chooseAddress()// 2. 用户成功的选择了收货地址if (err === null) {// 为 data 里面的收货地址对象赋值this.address = succ}

        4.8.NumberBox 数字输入框

                地址: 数字输入框

                效果    

                使用

<uni-number-box :min="1" :value="item.goods_count" :max="9" @change="numChangeHandler"></uni-number-box>属性min 最小max 最大change 数据发生变化触发step 一次加多少

        4.9获取微信用户信息

// desc 为必填字段，用于声明获取用户个人信息后的用途，不超过30个字符const [err, res] = await uni.getUserProfile({desc: '完善个人资料'})// 用户拒绝授权if (err) return uni.$showMsg('您拒绝授权！')// 用户同意授权，保存用户信息console.log(res)

        4.10.获取微信登录返回的code信息

// 调用微信登录接口 const [err, res] = await uni.login()// 判断微信登录uni.login()是否调用失败if (err) return uni.$showMsg('微信登录失败！')console.log(res.code) // 微信登录返回的code

        4.11.退出登录

const [err, succ] = await uni.showModal({title: '提示',content: '确认退出登录吗？'})if (succ && succ.confirm) {// 用户确认了退出登录的操作}

        4.12.微信支付功能

// 调用 uni.requestPayment() 发起微信支付const [err, succ] = await uni.requestPayment(payInfo)

5.解决问题

        5.1解决 .webp 格式图片在 ios 设备上无法正常显示的问题

 // 使用字符串的 replace() 方法，将 webp 的后缀名替换为 jpg 的后缀名 .replace(/webp/g, 'jpg')

        5.2.判断对象是否为空

JSON.stringify(对象) === '{}'