用途
本技能面向需要在 UniAppX(uni-app-x)项目中集成 uView Pro 组件库的开发者。当用户希望将 uView Pro 引入 UniAppX 项目、配置项目以配合 uView Pro 工作(pages.json、manifest.json、easycom)、处理 uView Pro 在 UniAppX 中的平台差异(H5、小程序、App、nvue)、在 uView Pro 组件中使用 UniAppX 的导航、API 与生命周期、构建跨平台应用、配置 easycom 自动引入、处理导航与路由、优化项目或将应用部署到多平台时,均可使用本技能。
主要能力
技能内容按 UniAppX 集成模式与官方 UniAppX 插件结构组织,覆盖以下方面:
- 安装与初始化:在 UniAppX 项目中安装与设置 uView Pro,包括项目配置与 easycom 配置。
- 与 UniAppX 特性集成:pages.json 配置、manifest.json 配置、导航与路由、UniAppX API 与 uView Pro 组件的配合使用。
- 平台差异处理:H5、小程序、App、nvue 各平台的注意事项。
- 进阶集成:主题定制、构建优化、多平台部署。
- 参考文档:集成 API 与配置 API 参考。
- 模板:基础 UniAppX 项目模板、pages 配置模板、manifest 配置模板。
使用方式
技能按主题组织为可加载的示例与模板文件,按需加载对应内容:
- 安装与初始化:加载 examples/getting-started/installation.md(安装)、examples/getting-started/project-setup.md(项目配置)、examples/getting-started/easycom-config.md(easycom 配置)。
- 集成:examples/integration/pages-config.md、examples/integration/manifest-config.md、examples/integration/navigation.md、examples/integration/uniappx-api.md。
- 平台差异:examples/platform-specific/h5.md、miniprogram.md、app.md、nvue.md。
- 进阶:examples/advanced/custom-theme.md、build-optimization.md、multi-platform.md。
- API 参考:api/integration-api.md、api/config-api.md。
- 模板:templates/basic-uniappx-project.md、templates/pages-template.md、templates/manifest-template.md。
适用场景
适用于使用 UniAppX 与 uView Pro 构建跨平台应用(H5、小程序、App、nvue)的开发场景,尤其是需要 TypeScript(.uts 文件)与 Composition API(setup 语法)、需要 easycom 自动引入组件、需要处理平台差异与条件编译、需要主题定制与构建优化、以及需要多平台部署的项目。
限制与注意事项
- 本技能聚焦 UniAppX 集成,而非 uView Pro 的 API 文档本身。
- UniAppX 使用 TypeScript(.uts 文件)与 Composition API(setup 语法)。
- 需在 pages.json 中配置 easycom 以实现组件自动引入。
- 平台特定代码需使用条件编译(#ifdef、#endif)。
- 部署前需在所有目标平台(H5、小程序、App)上测试。
- 在 UniAppX 中使用 rpx 单位进行响应式尺寸设置。
- 需确保 UniAppX 项目中正确配置 SCSS。
- 需为各平台正确配置 manifest.json。
- 需针对各平台特定要求进行性能优化。
- 需使用 TypeScript 与正确的类型定义,并妥善处理 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/