经过半个月倾力研发,全新跨平台原创新作Tauri2-ViteOS桌面客户端OS管理平台宣告完结了。
tauri2-viteos使用最新跨平台框架Tauri2.0整合Vite6.0构建桌面项目框架。
使用技术
- 编辑器:vscode
- 技术框架:vite^6.0.3+vue^3.5.13+vue-router^4.5.0
- 跨平台框架:tauri^2.1.1
- 组件库:@arco-design/web-vue^2.56.3
- 状态管理:pinia^2.3.0
- 拖拽插件:sortablejs^1.15.6
- 滑屏插件:swiper^11.1.15
- 图表组件:echarts^5.5.1
- markdown编辑器:md-editor-v3^5.1.1
- 模拟数据:mockjs^1.1.0
功能亮点
- 支持
macos和windows两种桌面风格 tauri2.0封装高性能多窗口管理- 支持自定义json配置桌面菜单和Dock菜单
- 自研栅格化桌面拖拽布局引擎
- Dock菜单支持自由拖拽顺序
- 支持自定义个性化桌面壁纸、全场景毛玻璃虚化UI界面
- 支持主窗口和独立新开窗口打开路由页面
项目框架结构
tauri2-os使用最新tauri2.0高性能框架,结合vite6.x构建工具,采用vue3 setup语法编码开发。
入口配置
在main.js中引入路由/状态管理、插件等基本配置信息。
import { createApp } from 'vue'
import './style.scss'
import App from './App.vue'
// 引入插件配置
import Plugins from './plugins'
// 引入路由/状态配置
import Router from './router'
import Pinia from './pinia'
createApp(App)
.use(Router)
.use(Pinia)
.use(Plugins)
.mount("#app")
vite6批量路由配置+登录验证拦截
使用vite.js提供的import.meta.glob批量导入路由文件。
/**
* 路由管理Router
* @author andy
*/
import { getCurrentWindow } from '@tauri-apps/api/window'
import { createRouter, createWebHistory } from 'vue-router'
import { authState } from '@/pinia/modules/auth'
import Layout from '@/layouts/index.vue'
import { loginWindow } from '@/windows/actions'
// 批量导入路由
const modules = import.meta.glob('./modules/*.js', { eager: true })
console.log(modules)
const patchRouters = Object.keys(modules).map(key => modules[key].default).flat()
console.log(patchRouters)
/**
* meta配置
* @param meta.requireAuth 需登录验证页面
*/
const routes = [
{
path: '/',
redirect: '/desk',
},
// 批量路由
...patchRouters,
// 错误模块
{
path: '/:pathMatch(.*)*',
redirect: '/404',
component: Layout,
meta: {
title: '404 error',
},
children: [
{
path: '404',
component: () => import('@/views/error/404.vue'),
}
]
},
]
const router = createRouter({
history: createWebHistory(),
routes,
})
// 全局路由钩子拦截
router.beforeEach(async(to, from) => {
const authstate = authState()
// 登录验证
if(to?.meta?.requireAuth && !authstate.authorization) {
loginWindow()
}else {
await getCurrentWindow().show()
await getCurrentWindow().unminimize()
await getCurrentWindow().setFocus()
return true
}
})
router.afterEach(() => {
// ...
})
router.onError(error => {
console.warn('[Router Error]', error)
})
export default router
通过router.beforeEach来拦截是否登录,未登录就直接跳转到登录窗口。
// 登录窗口
export async function loginWindow() {
await winCreate({
label: 'main-login',
url: '/login',
title: '登录',
width: 750,
height: 480,
resizable: false,
maximizable: false,
alwaysOnTop: true
})
}
tauri2-os桌面结构布局
提供了macos和windows两种桌面风格桌面模板。
<script setup>
import { appState } from '@/pinia/modules/app'
// 引入布局模板
import MacosLayout from './template/macos.vue'
import WindowsLayout from './template/windows.vue'
const appstate = appState()
const DeskLayout = {
macos: MacosLayout,
windows: WindowsLayout
}
</script>
<template>
<div class="vu__container flexbox" :style="{'--themeSkin': appstate.config.skin}">
<component :is="DeskLayout[appstate.config.layout]" />
</div>
</template>
tauri2-os桌面分为顶部导航操作栏+桌面菜单+底部Dock菜单+右侧分页指示器等模块。
<script setup>
import { appState } from '@/pinia/modules/app'
import Titlebar from '@/layouts/components/titlebar/index.vue'
import Desk from '@/layouts/components/mac/desk.vue'
import Dock from '@/layouts/components/mac/dock.vue'
const appstate = appState()
</script>
<template>
<div class="vu__layout flexbox flex-col">
<div class="vu__layout-header">
<Titlebar />
</div>
<div class="vu__layout-body flex1 flexbox">
<Desk />
</div>
<div class="vu__layout-footer">
<Dock v-if="appstate.config.dockEnable" />
</div>
</div>
</template>
Tauri2+Vue3桌面栅格系统
桌面图标支持自定义大小、圆角、间距等信息。
const deskVariable = ref({
'--icon-radius': '10px', // 圆角
'--icon-size': '60px', // 图标尺寸
'--icon-gap-col': '30px', // 水平间距
'--icon-gap-row': '30px', // 垂直间距
'--icon-labelSize': '12px', // 标签文字大小
'--icon-labelColor': '#fff', // 标签颜色
'--icon-fit': 'contain', // 图标自适应模式
})
桌面菜单支持如下参数配置
/**
* ***** Desk桌面菜单配置项 *****
* label 图标标题
* imgico 图标(本地或网络图片) 支持Arco Design内置图标或自定义iconfont图标
* path 跳转路由页面
* link 跳转外部链接
* hideLabel 是否隐藏图标标题
* filter 是否禁用拖拽
* background 自定义图标背景色
* color 自定义图标颜色
* size 栅格磁贴布局 1x1 ... 12x12
* padding 内边距
* onClick 点击图标回调函数
* isNewin 新窗口打开路由页面
* children 二级菜单
*/
桌面菜单片段
const deskMenu = [
{
uid: 'h128f210-737e-1d4e-6438-7feefac27e48',
label: '主页',
imgico: '/tauri.svg',
list: [
// ...
{label: '倒计时', imgico: markRaw(CountDown), size: '2x2'},
{label: 'Tauri^2.1', imgico: '/tauri.svg', link: 'https://tauri.app/', background: '#fff', padding: '5px',},
{label: 'Vite^6.0.3', imgico: 'https://vitejs.dev/logo.svg', link: 'https://vitejs.dev/',},
]
},
{
uid: 'y587f210-037e-1u4e-1250-4seefac27e48',
label: 'Apps',
imgico: '/static/mac/safari.png',
list: [
{label: 'Appstore', imgico: '/static/mac/appstore.png'},
// ...
]
},
{
uid: 'u658f210-807e-1e4e-1550-4deefac27e48',
label: '摸鱼',
imgico: 'https://hao8.qhimg.com/dmfd/80_80_75/t11148baf6114dc38875f0173e7.webp',
list: [
{label: 'Github', imgico: '/static/svg/github.svg', link: 'https://github.com/', background: '#607d8b', size: '2x2'},
{label: 'Vite.js官方文档', imgico: '/vite.svg', link: 'https://vitejs.dev/',},
// ...
]
},
{
uid: 'u658f210-807e-1e4e-1550-4deefac27e48',
label: 'AI',
imgico: 'https://openres.xfyun.cn/xfyundoc/2024-10-20/b2b49aa6-ee0d-4b77-9ce9-c20a27ee6618/1729415860861/adfsasdf.png',
list: [
{label: 'ChatGPT', imgico: '/static/svg/chatgpt.svg', link: 'https://openai.com/chatgpt/', hideLabel: true, background: '#0ea17e', size: '3x2'},
// ...
]
},
{
uid: 'd141f210-207e-1e8e-9950-9deefac27e48',
label: '工作台',
imgico: markRaw(IconComputer),
list: [
{label: '纯血鸿蒙', imgico: 'images/logo-dev.svg', link: 'https://developer.huawei.com/', hideLabel: true, background: '#f3f6f9', size: '2x1'},
{label: 'Tauri^2.1', imgico: '/static/svg/tauri.svg', link: 'https://tauri.app/', background: '#dffbff', padding: '10px', size: '2x2'},
{label: 'Vite^6.0.3', imgico: 'https://vitejs.dev/logo.svg', link: 'https://vitejs.dev/'},
// ...
{
label: '组件',
children: [
// ...
]
},
{
label: '管理中心',
children: [
{label: '主页', imgico: '/static/svg/ucenter.svg', path: '/setting'},
// ...
]
},
{
label: '设置',
children: [
// ...
]
},
{label: 'Element-Plus', imgico: '/images/element-plus-logo.svg', link: 'https://element-plus.org/', padding: '10px', size: '3x1'},
{
label: '收藏夹',
children: [
// ...
]
},
{
label: '公众号', imgico: '/static/qrimg.png', background: '#fff', size: '2x1',
onClick: () => {
// ...
}
},
]
}
]
tauri2.0+vue3实现dock菜单
dock菜单支持如下参数
/**
* ***** Dock菜单配置项 *****
* label 图标tooltip提示
* imgico 图标(本地或网络图片) 支持Arco Design内置图标或自定义iconfont图标
* path 跳转路由页面
* link 跳转外部链接
* filter 是否禁用拖拽
* color 自定义图标颜色
* onClick 点击图标回调函数
* isNewin 新窗口打开路由页面
* children 二级菜单
*/
如上图:桌面菜单默认主窗口打开路由页面,开启独立窗口打开路由页面后,会新开窗口打开页面。
另外项目中托盘管理采用自定义tauri窗体实现系统托盘菜单。
综上就是tauri2.0+vite6+vue3+arco实战开发桌面端os系统的一些知识分享。通过开发这个项目探索一种全新的OS桌面式后台管理系统新解决方案,希望对大家有些帮助哈!