更新记录

1.1.3（2024-06-24）

1. chore: update deps；
2. feat: 新增 stylelint 格式化插件。

1.1.2（2024-05-29）

feat: 新增 stylelint 格式化插件； chore: update deps；

1.1.1（2024-05-15）

1. chore: v3.0.0-4010520240507001;
2. fix: 修复 pinia 路径错误
3. fix: 修复 @vueuse 版本错误

平台兼容性

uni-app

uni-app x

快速地^{vitesse-uniapp-vue3} 创建 uniapp + vue3 + ts 应用

🖥 在线预览

平台兼容性

在技术考量上，优先同时支持下列的平台，为兼容多个平台而舍弃一些实用的依赖插件。如发现下列平台环境开发编译出现问题，欢迎提 issue or pr

特性

• 🗂 基于文件的路由

• 📦 组件自动化加载

• 🍍 使用 Pinia 的状态管理

• 📑 布局系统

• 🔥 使用 新的 <script setup> 语法

• 📥 API 自动加载 - 直接使用 Composition API 无需引入

• 🎨 UnoCSS - 高性能且极具灵活性的即时原子化 CSS 引擎

• TypeScript, 为什么不呢

• ⚙️ 使用 Vitest 进行单元测试

预配置

UI 框架

• uview-plus uview-plus3.0是基于uView2.x修改的vue3版本
• UnoCSS 高性能且极具灵活性的即时原子化 CSS 引擎
• unocss-preset-uni 专为 uni-app 打造的 UnoCSS 预设

插件

• Pinia - 直接的, 类型安全的, 使用 Composition API 的轻便灵活的 Vue 状态管理
  • pinia-plugin-persist-uni - pinia 在 uniapp 中数据持久化插件
• Router
  • @uni-helper/vite-plugin-uni-pages - 在 Vite 驱动的 uni-app 上使用基于文件的路由系统
  • vite-plugin-vue-layouts - 页面布局系统
  • @uni-helper/uni-use - 使用 useRouter 封装路由方法 -> src/composables/useNavigation.ts
• 请求
  • @uni-helper/uni-network - 为 uni-app 打造的基于 Promise 的 HTTP 客户端
  • services 目录封装通用请求
• unplugin-vue-components - 自动加载组件
• unplugin-auto-import - 直接使用 Composition API 等，无需导入
• @uni-helper/vite-plugin-uni-manifest - 使用 TypeScript 编写 uni-app 的 manifest.json。

编码风格

• 使用 Composition API 地 <script setup> SFC 语法
• ESLint 配置为 @antfu/eslint-config - 单引号, 无分号...
  • @unocss/eslint-config - 用于UnoCSS的ESLint配置
  • @uni-helper/eslint-config - 适用于 uni-app 的 Anthony's ESLint 配置预设

各平台类型定义文件

• [x] uni-app 组件
• [x] 微信小程序
• [x] 支付宝小程序
• [x] 字节小程序
• [x] 快手小程序
• [x] 百度小程序

环境建议

Node >= 18

pnpm >= 8

使用该模版

npx degit sunpm/vitesse-uniapp-vue3#main my-vitesse-uniapp-vue3
cd my-vitesse-uniapp-vue3
pnpm install

如果你没装过 pnpm, 可以先运行: npm install -g pnpm

清单

使用此模板时，请尝试按照清单正确更新您自己的信息

• [ ] 在 LICENSE 中改变作者名或删除
• [ ] 在 manifest.config.ts 中修改项目名称，描述，appid 等
• [ ] 在 .env.* 更改环境变量
• [ ] 不需要部署到 netlify 请移除 .netlify.toml 文件
• [ ] 整理 README 并删除演示页面和组件

紧接着, 享受吧 :)

问题

怎么修改了 pages.json 没效果？

模版使用了 @uni-helper/vite-plugin-uni-pages插件依赖，需要在pages.config.ts配置，编译会生成至pages.json，详细点我看文档

怎么修改了 manifest.json 没效果？

模版使用了@uni-helper/vite-plugin-uni-manifest插件依赖，需要在manifest.config.ts配置，编译会生成至manifest.json，新增了自动生成项目配置信息的方法，详细点击查看代码

报错：Uncaught SyntaxError: The requested module '/node_modules/vue-demi/lib/index.mjs?v=701bef9f' does not provide an export named 'hasInjectionContext'

pinia v2.1.X 版本要求 vue 3.3 或者 vue-demi latest ，如果 uniapp 的 vue 版本是 ^3.2.45，通过 pinia 降级到 2.0.X 可以运行和使用。

感谢

• vitesse
• uni-helper
• uni-vitesse