uniapp项目中使用vue3开发多端项目实践

本项目中使用vue3开发多端项目实践，hbuilderx内置vue3模块，使用了vite4.x构建，编译构建项目的速度比火箭还快，超爽！！！！

1、使用版本说明

HBuilderX: 3.8.4
Vite: 4.2.1
uView-Plus: 3.1.31

2、创建项目

通过hbuilderx可视化编辑器创建项目

点击编辑器的文件 > 新建 > 项目（快捷键Ctrl+N）

选择uni-app项目，输入项目名/路径，选择项目模板，勾选vue3版本，点击创建，即可成功创建

3、运行项目

点击编辑器的运行 > 运行到浏览器 > 选择浏览器

当然也可以运行到手机或模拟器、运行到小程序工具。

App.vue使用setup语法糖编码。

<script setup>
    import {
    
     onLaunch, onShow, onHide } from '@dcloudio/uni-app'
    onLaunch(() => {
    
    
        console.log('App Launch!')
    })
    onShow(() => {
    
    
        console.log('App Show!')
    })
    onHide(() => {
    
    
        console.log('App Hide!')
    })
</script>

uniapp内置了pinia状态管理。

import App from './App'

import uView from '@/uview-plus'

import {
    
     createSSRApp } from 'vue'
import {
    
     createPinia } from 'pinia'

export function createApp() {
    
    
    const app = createSSRApp(App)
    const pinia = createPinia()
    app.use(pinia)
    app.use(uView)
    return {
    
    
        app,
        pinia
    }
}

4、uniapp+pinia本地缓存插件PiniaPluginUnistorage

pinia-plugin-unistorage 基于uniapp pinia实现多端的更简单的全局本地数据缓存

该插件是 pinia-plugin-persistedstate 的 uniapp 版本。

npm安装插件

npm i pinia-plugin-unistorage -D

在main.ts中引入

import {
    
     createSSRApp } from 'vue'
import * as Pinia from 'pinia'
import {
    
     createUnistorage } from 'pinia-plugin-unistorage'

export function createApp() {
    
    
    const app = createSSRApp(App)

    const store = Pinia.createPinia()

    // 关键代码
    store.use(createUnistorage())

    app.use(store)

    return {
    
    
        app,
        Pinia // 此处必须将 Pinia 返回
    }
}

使用组件

import {
    
     defineStore } from 'pinia'

export const useStore = defineStore('main', {
    
    
    state() {
    
    
        return {
    
    
            someState: 'hello pinia'
        }
    },
    unistorage: true // 开启后对 state 的数据读写都将持久化
})

支持vue3 setup 语法

import {
    
     defineStore } from 'pinia'

export const useStore = defineStore(
    'main',
    () => {
    
    
        const someState = ref('hello pinia')
        return {
    
     someState }
    },
    {
    
    
        unistorage: true // 开启后对 state 的数据读写都将持久化
    }
)

插件地址
https://ext.dcloud.net.cn/plugin?id=8081
仓库地址
https://github.com/dishait/pinia-plugin-unistorage

5、 uni-app + vue3 + vite + ts 项目结构

• index.html 首页入口文件。
• package.json 项目配置文件。
• tsconfig.json typescript 配置文件。
• vite.config.ts vite 的配置文件。

src 存放开发资源文件，基本要做的事情都在这个目录内，里面又包含了几个目录文件：

• pages 存放所有页面文件，我们创建的页面组件都放入该文件夹。
• static 存放静态资源的文件夹。
• App.vue 页面入口文件，所有页面都在 App.vue 下进行切换。
• env.d.ts 第三方模块的类型声明文件。
• main.ts 项目入口文件，因为使用 ts 语法，所以后缀是 .ts
• mainfest.json 应用配置文件，用于指定应用名称、图标、权限等。
• pages.json 全局配置文件，可以配置页面文件路径、窗口样式、原生的导航栏、底部tab栏等。
• uni.scss 是uni-app的样式包，在其他文件中可以快速引用样式包内的样式。