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.html
2.下载 正式版->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.在项目的根目录中,创建分包的根目录,命名为subpkg
2.在pages.json中,和pages字段平级的位置声明subPackages数据节点中,用来定义分包相关的结构:
3.4.2使用
1.pages.json配置 { "subPackages": [{ "root": "subpkg", "pages": [] }], } 2.创建目录subpkg 3.在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(对象) === '{}'
总结
到此这篇关于uni-app开发小程序的文章就介绍到这了,更多相关uni-app开发小程序内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
最新评论