名称: uniappx-uview-pro 描述: 一个全面的技能,用于在 UniAppX 项目中集成和使用 uView Pro。这个技能专注于 UniAppX 特定的集成、配置和平台特定考虑,当在 UniAppX 应用中使用 uView Pro 时。每当用户需要在 UniAppX 项目中集成 uView Pro、配置 UniAppX 特定设置或处理平台差异时使用此技能。 许可证: 完整条款在 LICENSE.txt
何时使用此技能
每当用户想要时使用此技能:
- 将 uView Pro 集成到 UniAppX 项目中
- 配置 UniAppX 项目以与 uView Pro 协同工作(pages.json、manifest.json、easycom)
- 在 UniAppX 中使用 uView Pro 时处理平台特定行为(H5、小程序、App、nvue)
- 在 UniAppX 功能(导航、API、生命周期)中使用 uView Pro 组件
- 使用 uView Pro 组件构建跨平台 UniAppX 应用程序
- 在 UniAppX 中配置 easycom 以自动导入 uView Pro 组件
- 在 UniAppX 中使用 uView Pro 处理导航和路由
- 使用 uView Pro 优化 UniAppX 项目
- 将基于 uView Pro 的 UniAppX 应用程序部署到多个平台
如何使用此技能
此技能的组织匹配 UniAppX 集成模式和官方 UniAppX 插件结构(https://ext.dcloud.net.cn/plugin?id=24633)。在 UniAppX 中使用 uView Pro 时:
-
安装和设置 uView Pro 在 UniAppX 项目中:
- 加载
examples/getting-started/installation.md以在 UniAppX 中安装 - 加载
examples/getting-started/project-setup.md以配置 UniAppX 项目 - 加载
examples/getting-started/easycom-config.md以配置 easycom
- 加载
-
与 UniAppX 功能集成:
- 加载
examples/integration/pages-config.md以配置 pages.json - 加载
examples/integration/manifest-config.md以配置 manifest.json - 加载
examples/integration/navigation.md以使用 uView Pro 导航 - 加载
examples/integration/uniappx-api.md以在 uView Pro 组件中使用 UniAppX API
- 加载
-
处理平台特定行为:
- 加载
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以在 UniAppX 中自定义主题 - 加载
examples/advanced/build-optimization.md以优化构建 - 加载
examples/advanced/multi-platform.md以多平台部署
- 加载
-
参考 API 文档 当需要时:
api/integration-api.md- UniAppX 和 uView Pro 集成 APIapi/config-api.md- 配置 API 参考
-
使用模板 快速开始:
templates/basic-uniappx-project.md- 基本 UniAppX 项目与 uView Protemplates/pages-template.md- pages.json 配置模板templates/manifest-template.md- manifest.json 配置模板
重要注意事项:
- 此技能专注于 UniAppX 集成,而非 uView Pro API 文档
- UniAppX 使用 TypeScript(.uts 文件)和 Composition API(setup 语法)
- 始终在 pages.json 中配置 easycom 以自动导入组件
- 使用条件编译(
#ifdef、#endif)处理平台特定代码 - 部署前在所有目标平台(H5、小程序、App)上测试
- 在 UniAppX 中使用 rpx 单位进行响应式尺寸调整
示例和模板
入门指南
- 安装:
examples/getting-started/installation.md- 如何在 UniAppX 项目中安装 uView Pro - 项目设置:
examples/getting-started/project-setup.md- 设置 UniAppX 项目与 uView Pro - Easycom 配置:
examples/getting-started/easycom-config.md- 配置 easycom 以自动导入组件
集成
- Pages 配置:
examples/integration/pages-config.md- 使用 uView Pro 配置 pages.json - Manifest 配置:
examples/integration/manifest-config.md- 为 uView Pro 配置 manifest.json - 导航:
examples/integration/navigation.md- 使用 uView Pro 进行导航和路由 - UniAppX API:
examples/integration/uniappx-api.md- 在 uView Pro 组件中使用 UniAppX API
平台特定
- H5:
examples/platform-specific/h5.md- 在 H5 平台使用 uView Pro 的考虑 - 小程序:
examples/platform-specific/miniprogram.md- 在小程序平台使用 uView Pro 的考虑 - App:
examples/platform-specific/app.md- 在 App 平台使用 uView Pro 的考虑 - nvue:
examples/platform-specific/nvue.md- 在 nvue 平台使用 uView Pro 的考虑
高级
- 自定义主题:
examples/advanced/custom-theme.md- 在 UniAppX 项目中自定义主题 - 构建优化:
examples/advanced/build-optimization.md- 使用 uView Pro 优化 UniAppX 构建 - 多平台:
examples/advanced/multi-platform.md- 多平台部署策略
模板
- 基础项目:
templates/basic-uniappx-project.md- 基本 UniAppX 项目结构与 uView Pro - Pages 模板:
templates/pages-template.md- pages.json 配置模板 - Manifest 模板:
templates/manifest-template.md- manifest.json 配置模板
API 参考
- 集成 API:
api/integration-api.md- UniAppX 和 uView Pro 集成 API 参考 - 配置 API:
api/config-api.md- UniAppX 项目配置 API 参考
最佳实践
- 使用 easycom: 在 pages.json 中配置 easycom 以自动导入 uView Pro 组件
- 平台测试: 部署前在所有目标平台(H5、小程序、App)上测试
- 使用 rpx 单位: 在 UniAppX 中使用 rpx 进行响应式尺寸调整,px 用于固定尺寸
- SCSS 支持: 确保在 UniAppX 项目中正确配置 SCSS
- Manifest 配置: 为每个平台正确配置 manifest.json
- 条件编译: 使用条件编译(
#ifdef、#endif)处理平台特定代码 - 性能: 针对每个平台的特定需求进行优化
- TypeScript: 使用 TypeScript(.uts 文件)和适当的类型定义
- Composition API: 使用 Composition API 和 setup 语法(推荐用于 UniAppX)
- 生命周期管理: 正确处理 UniAppX 页面生命周期与 uView Pro 组件
资源
- 官方 UniAppX 插件: https://ext.dcloud.net.cn/plugin?id=24633
- UniAppX 文档: https://uniapp.dcloud.net.cn/uni-app-x/
- UniAppX API 参考: https://uniapp.dcloud.net.cn/uni-app-x/api/
关键词
uniappx, uniapp-x, uview-pro, uview pro, uniappx 集成, uniappx 配置, easycom, pages.json, manifest.json, uni-app-x, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异, TypeScript, Composition API, setup 语法, .uts 文件, UniAppX 组件, 跨平台组件, 小程序组件, App 组件