掌握uni-app + Vue3 + TS

前端大神之路

共 11154字,需浏览 23分钟

 · 2022-07-16

本文特别福利,赠送Vue.JS、uni-app新书,详情查看文末~



希望本篇文章能帮你加深对 Uni-app 和 Vue 的理解


基础介绍

个人使用背景是因为公司业务覆盖多个小程序端,主要包括:支付宝小程序、微信小程序、百度小程序、快应用。项目基于npm包管理,vscode相关插件提供更好的开发体验。

  • 主要用到相关技术:uni-app相关 / vue3 / vite / typescript / axios / sass / eslint / prettier 下面直接开始从头开始搭建一个可用的初始项目~ 如果"需求紧急"可以参考底部的GitHub源码。如果遇到问题可参照对应步骤。

使用npm安装uni-app

npm install -g @vue/cli
vue create -p dcloudio/uni-preset-vue#vue3 uni-app-vue3-demo
// 等待片刻 ...
> 请选择 uni-app 模板: 默认模板(TypeScript)

cd uni-app-vue3-demo

npm install
// 安装较慢时可使用
npm install --registry=https://registry.npm.taobao.org


配置 eslint + prettier 自动格式化代码

  • 安装相关npm包

  •   "devDependencies": {
        "@typescript-eslint/eslint-plugin""^5.15.0",
        "@typescript-eslint/parser""^5.15.0",
        "eslint""^8.11.0",
        "eslint-config-prettier""^8.5.0",
        "eslint-plugin-prettier""^4.0.0",
        "eslint-plugin-vue""^8.5.0",
        "prettier""2.6.0",
        "vite-plugin-eslint""^1.3.0"
      }

  • 安装相关插件

  • eslint配置 .eslintrc.js

module.exports = {
  env: { nodetrue },
  globals: { unitruewxtruemytrueswantrue },
  parser'vue-eslint-parser',
  parserOptions: { parser'@typescript-eslint/parser'sourceType'module' },
  extends: ['eslint:recommended''plugin:vue/vue3-recommended''prettier'],
  plugins: ['vue''@typescript-eslint'],
  rules: {
    'vue/multi-word-component-names'0,
  },
}
  • prettier配置 .prettierrc.js

module.exports = {
  printWidth120,
  tabWidth2,
  tabsfalse,
  semifalse,
  singleQuotetrue,
  quoteProps'as-needed',
  tailingComma'all',
  bracketSpacingtrue,
  jsxBracketSameLinefalse,
  arrowParens'always',
  endOfLine'auto',
}

  • vscode 配置 .vscode/settings.json

{
  "editor.tabSize"2,
  
  "vetur.validation.template"false,
  "editor.formatOnSave"true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint"true
  },
  "[vue]": {
    "editor.defaultFormatter""esbenp.prettier-vscode"
  },
  "[javascript]": {
    "editor.defaultFormatter""esbenp.prettier-vscode"
  },
  "[typescript]": {
    "editor.defaultFormatter""esbenp.prettier-vscode"
  },
}

  • 测试代码自动格式化 (重启vscode 打开 src pages/index.vue 输入几个空格 然后在保存看是否会自动格式化)

Typescript 配置允许默认 any 类型 tsconfig.json

{
  compilerOptions: {
    "noImplicitAny"false,
  }
}

配置 SASS

  • 安装 npm 相关包

 npm install node-sass@4.0.0 sass-loader@7.3.1 --save-dev 
 // 如遇到安装问题可手动在package.json devDependencies 手动中添加
 // 删除 node_modules 然后 重新安装npm install
  • 在 vue 中使用

<style lang="scss">
</style>

配置全局公共变量 并 自动导入

  • 新建全局样式变量 src/style/var.scss

$test-size: 400rpx;
  • 在全局自动导入 vite.config.ts

import { defineConfig, loadEnv, UserConfig } from 'vite'
import uni from '@dcloudio/vite-plugin-uni'
import * as path from 'path'

import eslintPlugin from 'vite-plugin-eslint'

// https://vitejs.dev/config/
export default defineConfig(({ command, mode }) => {
  const env = loadEnv(mode, process.cwd())
  console.log(command, mode, env)

  let config: UserConfig = {
    resolve: { alias: { '~': path.resolve(__dirname, './src') } },
    css: {
      preprocessorOptions: {
        scss: { charset: false, additionalData: `@import "~/styles/var.scss";` },
      },
    },

    plugins: [uni(), eslintPlugin()],
  }

  if (command === 'serve') {
    // 仅开发
    return config
  } else {
    // 生产
    return config
  }
})


vscode 相关插件

SCSS IntelliSense 安装后会在全局提示 样式变量(如下图所示)



安装 axios api层 适配小程序

import axios, { AxiosError } from 'axios'
import qs from 'qs'
let TOKEN_KEY = 'x-token' // TODO 根据自己后端配置
let API_SOURCE = ''
// #ifdef  MP-WEIXIN
API_SOURCE = 'weixin' // 微信小程序
// #endif
// #ifdef  MP-BAIDU
API_SOURCE = 'bdapplets' // 百度小程序
// #endif

// 设置表单类型
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded'

let baseURL = process.env.VUE_APP_API_HOST

const fetch = axios.create({
  withCredentialstrue,
  baseURL,
  timeout5000,
})
let jumpLoginCount = 0

// request拦截器,在请求之前做一些处理
fetch.interceptors.request.use(
  (config) => {
    Object.assign(config.headers, {
      Authorization: uni.getStorageSync(TOKEN_KEY),
    })
    config.data = qs.stringify(config.data)

    return config
  },
  (error) => {
    return Promise.reject(error)
  }
)

// 配置成功后的拦截器
fetch.interceptors.response.use(
  (res) => {
    const params = qs.parse(res.config.data)

    // 设置 token
    if (res.headers.Authorization) {
      uni.setStorageSync(TOKEN_KEY, res.headers.Authorization)
    }
    // TODO 根据后端成功状态配置
    if (['20001'].includes(`${res.data.code}`)) {
      // 是否返回根数据
      if (params.rootResult) return res
      else return res.data
    } else {
      return Promise.reject(res.data)
    }
  },
  (error: AxiosError) => {
    const params = qs.parse(error.config.data)
    // 未登录 跳转登录页
    if (error.response!.status == 401) {
      if (jumpLoginCount == 0) {
        uni.navigateTo({
          url'/pages/login/index'// TODO 配置成自己的登录页路径
        })
        ++jumpLoginCount
        setTimeout(() => (jumpLoginCount = 0), 2000)
      }
      return Promise.reject(error)
    }

    return Promise.reject(error)
  }
)

// 适配 小程序
fetch.defaults.adapter = function (config: any{
  return new Promise((resolve, reject) => {
    var settle = require('axios/lib/core/settle')
    var buildURL = require('axios/lib/helpers/buildURL')

    uni.request({
      method: config.method.toUpperCase(),
      url: config.baseURL + buildURL(config.url, config.params, config.paramsSerializer),
      header: config.headers,
      data: config.data,
      dataType: config.dataType,
      responseType: config.responseType,
      sslVerify: config.sslVerify,
      completefunction complete(response: any{
        response = {
          data: response.data,
          status: response.statusCode,
          errMsg: response.errMsg,
          headers: response.header, // 注意此处 单复数
          config: config,
        }
        settle(resolve, reject, response)
      },
    })
  })
}

export { fetch, API_SOURCE }

总结

通过上述步骤后,就能愉快的进行踩坑之旅了~


作者:Akai

https://juejin.cn/post/7035929902381531150


免费送书

《Vue.js从入门到企业级实战》是一本以高薪就业为目的,完全还原真实项目、真实服务端数据接口的Vue实战教程。

全书共分为两大篇:Vue2篇和Vue3篇。其中,Vue2篇由基础知识和实战两大部分组成,包括学习Vue前的准备工作、Vue基础、组件、过渡与动画、可复用性组合、vue-cli的安装与配置、Vue全家桶之router、Postman软件的使用、Vue全家桶之axios、使用Fetch与服务端通信、Vue全家桶之Vuex、第三方插件和UI库的使用、项目架构搭建和企业级项目实战;Vue3篇为电子书,包括Vue3开发必学的TypeScript语法、用Vue3创建项目、Vue3新特性Composition API、用Vue3开发插件及使用第三方UI库。

《Vue.js从入门到企业级实战》内容丰富,实用性强,以面试内容和实战项目为基础进行讲解,所讲解的每个知识点都会让读者知道在实际项目的开发中如何使用,教会读者如何快速学会Vue编程并进行实战开发。本书可作为正在工作或打算学习Vue以获得高薪就业的初学者的参考书,也可作为相关培训机构的辅导教材。


购买链接


uni-app多端跨平台开发从入门到企业级实战


《uni-app多端跨平台开发从入门到企业级实战》是一本系统介绍热门前端多端框架uni-app的实战教程。

全书由基础知识和实战两大部分组成,包括初识uni-app,uni-app环境搭建,生命周期,尺寸单位、Flex布局与背景图片,pages.json配置,manifest.json配置,路由,判断运行环境和平台,常用组件,常用API以及仿美团点餐小程序客户端开发。

本书以面试和实战为基础,通过阅读本书,读者可快速学会uni-app的相关知识并将其应用到实战项目中。例如,优化性能、解决iPhone X 的“刘海”兼容性问题、实现微信支付与微信授权登录、获取位置并在地图上显示、获取用户所在的城市和街道信息、发布与审核微信小程序等。对于想要学习更多框架知识,并且想要快速将这些知识应用到实战项目中的你来说,这本书可谓是不二之选。

购买链接:

参与规则

1:从「本文在看」中随机各抽取  名幸运读者

2:在 7月18日 开奖前我会随机时间发布一条朋友圈,第 22、33、66、88 个点赞的人即可中奖

一共送 本!!

开奖时间2022 年 7 月 18 日 21:00

注意事项:禁止作弊;3个月内中过奖的读者不能再重复参与;提前加我微信好友,避免开奖后联系不到导致机会作废

👇👇👇

听说 点赞、在看 的人更幸运哦

浏览 14
点赞
评论
收藏
分享

手机扫一扫分享

举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

举报