uni-app开发小程序的完整流程记录

 更新时间:2024年11月04日 10:30:43   作者:&小胖&  
本文详细介绍了使用uni-app进行项目开发的全过程,包括uni-app框架的介绍、开发工具HBuilderX的下载安装与配置、项目开发中的网络请求配置、小程序分包加载、自定义组件使用、组件使用技巧等,还提及了解决开发中遇到的一些问题,需要的朋友可以参考下

一、项目准备工作

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开发小程序内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue服务端渲染页面缓存和组件缓存的实例详解

    vue服务端渲染页面缓存和组件缓存的实例详解

    本篇文章给大家带来的内容是关于vue服务端渲染页面缓存和组件缓存的介绍(代码),有一定的参考价值,有需要的朋友可以参考一下
    2018-09-09
  • Vue3嵌套路由中使用keep-alive缓存多层的实现

    Vue3嵌套路由中使用keep-alive缓存多层的实现

    本文介绍了Vue3 嵌套路由中使用 keep-alive缓存多层的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-04-04
  • 基于 Vue 实现一个酷炫的 menu插件

    基于 Vue 实现一个酷炫的 menu插件

    本文给大家介绍基于 Vue 实现一个酷炫的 menu插件,此篇教程需要大家具备一定的css和vue基础知识,本文分步骤给大家介绍的非常详细,需要的朋友参考下吧
    2017-11-11
  • vue中echarts@4.9版本,地图的使用方式

    vue中echarts@4.9版本,地图的使用方式

    这篇文章主要介绍了vue中echarts@4.9版本地图的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-02-02
  • antd form表单中如何嵌套自定义组件

    antd form表单中如何嵌套自定义组件

    这篇文章主要介绍了antd form表单中如何嵌套自定义组件问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03
  • vue自定义指令的创建和使用方法实例分析

    vue自定义指令的创建和使用方法实例分析

    这篇文章主要介绍了vue自定义指令的创建和使用方法,结合完整实例形式分析了vue.js创建及使用自定义指令的相关操作技巧与注意事项,需要的朋友可以参考下
    2018-12-12
  • Vue.js实现音乐播放器

    Vue.js实现音乐播放器

    这篇文章主要为大家详细介绍了Vue.js实现音乐播放器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-06-06
  • vue递归获取父元素的元素实例

    vue递归获取父元素的元素实例

    这篇文章主要介绍了vue递归获取父元素的元素实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • 通过npm引用的vue组件使用详解

    通过npm引用的vue组件使用详解

    本文章通过实现一个vue-dialog的弹出层组件,然后附加说明如果发布此包到npm,且能被其他项目使用。本文给大家介绍的非常详细,需要的的朋友参考下
    2017-03-03
  • vue使用router-view调用页面方式

    vue使用router-view调用页面方式

    这篇文章主要介绍了vue使用router-view调用页面方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-03-03

最新评论