name: uniapp-uview description: 一个全面的技能,用于在 UniApp 项目中集成和使用 uView UI。此技能专注于 UniApp 特定的集成、配置以及在 UniApp 应用中使用 uView UI 时的平台特定考虑。每当用户需要在 UniApp 项目中集成 uView UI、配置 UniApp 特定设置或处理平台差异时,使用此技能。 license: Complete terms in LICENSE.txt
何时使用此技能
每当用户想要:
- 将 uView UI 集成到 UniApp 项目中
- 配置 UniApp 项目以与 uView UI 协同工作(pages.json、manifest.json、easycom)
- 处理在 UniApp 中使用 uView 时的平台特定行为(H5、小程序、App、nvue)
- 将 UniApp 功能(导航、API、生命周期)与 uView 组件结合使用
- 使用 uView UI 组件构建跨平台 UniApp 应用
- 在 UniApp 中配置 easycom 以自动导入 uView 组件
- 在 UniApp 中使用 uView 处理导航和路由
- 使用 uView UI 优化 UniApp 项目
- 将基于 uView 的 UniApp 应用部署到多个平台
如何使用此技能
此技能组织以匹配 UniApp 集成模式和官方 UniApp 插件结构(https://ext.dcloud.net.cn/plugin?id=1593)。在 UniApp 中使用 uView UI 时:
-
安装和设置 uView UI 在 UniApp 项目中:
- 加载
examples/getting-started/installation.md以在 UniApp 中安装 - 加载
examples/getting-started/project-setup.md以配置 UniApp 项目 - 加载
examples/getting-started/easycom-config.md以配置 easycom
- 加载
-
与 UniApp 功能集成:
- 加载
examples/integration/pages-config.md以配置 pages.json - 加载
examples/integration/manifest-config.md以配置 manifest.json - 加载
examples/integration/navigation.md以使用 uView 进行导航 - 加载
examples/integration/uni-api.md以将 UniApp API 与 uView 结合使用
- 加载
-
处理平台特定行为:
- 加载
examples/platform-specific/h5.md以了解 H5 平台考虑 - 加载
examples/platform-specific/miniprogram.md以了解小程序考虑 - 加载
examples/platform-specific/app.md以了解 App 平台考虑 - 加载
examples/platform-specific/nvue.md以了解 nvue 考虑
- 加载
-
高级集成:
- 加载
examples/advanced/custom-theme.md以在 UniApp 中自定义主题 - 加载
examples/advanced/build-optimization.md以进行构建优化 - 加载
examples/advanced/multi-platform.md以了解多平台部署
- 加载
-
参考 API 文档 当需要时:
api/integration-api.md- UniApp 和 uView 集成 APIapi/config-api.md- 配置 API 参考
-
使用模板 快速开始:
templates/basic-uniapp-project.md- 带有 uView 的基本 UniApp 项目templates/pages-template.md- pages.json 配置模板templates/manifest-template.md- manifest.json 配置模板
重要注意事项:
- 此技能专注于 UniApp 集成,而非 uView UI API 文档
- uView UI 支持 Vue 2 和 Vue 3,使用适当的语法
- 始终在 pages.json 中配置 easycom 以自动导入组件
- 使用条件编译(
#ifdef、#endif)处理平台特定代码 - 在部署前在所有目标平台(H5、小程序、App)上测试
- 在 UniApp 中使用 rpx 单位进行响应式尺寸调整
示例和模板
快速开始
- 安装:
examples/getting-started/installation.md- 如何在 UniApp 项目中安装 uView UI - 项目设置:
examples/getting-started/project-setup.md- 使用 uView 设置 UniApp 项目 - Easycom 配置:
examples/getting-started/easycom-config.md- 配置 easycom 以自动导入组件
集成
- Pages 配置:
examples/integration/pages-config.md- 使用 uView 配置 pages.json - Manifest 配置:
examples/integration/manifest-config.md- 为 uView 配置 manifest.json - 导航:
examples/integration/navigation.md- 使用 uView 进行导航和路由 - UniApp API:
examples/integration/uni-api.md- 将 UniApp API 与 uView 组件结合使用
平台特定
- H5:
examples/platform-specific/h5.md- H5 平台与 uView 的考虑 - 小程序:
examples/platform-specific/miniprogram.md- 小程序与 uView 的考虑 - App:
examples/platform-specific/app.md- App 平台与 uView 的考虑 - nvue:
examples/platform-specific/nvue.md- nvue 与 uView 的考虑
高级
- 自定义主题:
examples/advanced/custom-theme.md- 在 UniApp 项目中自定义主题 - 构建优化:
examples/advanced/build-optimization.md- 使用 uView 优化 UniApp 构建 - 多平台:
examples/advanced/multi-platform.md- 多平台部署策略
模板
- 基本项目:
templates/basic-uniapp-project.md- 带有 uView 的基本 UniApp 项目结构 - Pages 模板:
templates/pages-template.md- pages.json 配置模板 - Manifest 模板:
templates/manifest-template.md- manifest.json 配置模板
API 参考
- 集成 API:
api/integration-api.md- UniApp 和 uView 集成 API 参考 - 配置 API:
api/config-api.md- UniApp 项目配置 API 参考
最佳实践
- 使用 easycom:在 pages.json 中配置 easycom 以自动导入 uView 组件
- 平台测试:在所有目标平台(H5、小程序、App)上测试
- 使用 rpx 单位:在 UniApp 中使用 rpx 进行响应式尺寸调整,px 用于固定尺寸
- SCSS 支持:确保在 UniApp 项目中正确配置 SCSS
- Manifest 配置:为每个平台正确配置 manifest.json
- 条件编译:使用条件编译处理平台特定代码
- 性能:针对每个平台的具体要求进行优化
- 导航:将 UniApp 导航 API 与 uView 组件结合使用
资源
- 官方插件:https://ext.dcloud.net.cn/plugin?id=1593
- UniApp 文档:https://uniapp.dcloud.net.cn/
- uView UI:https://www.uviewui.com/
关键词
uniapp, uview, uview-ui, uniapp integration, uniapp configuration, easycom, pages.json, manifest.json, uni-app, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异