name: uniapp-ucharts description: 一项用于在UniApp项目中集成和使用uCharts的综合技能。该技能专注于在UniApp应用程序中使用uCharts时的UniApp特定集成、配置和平台特定考虑。每当用户需要在UniApp项目中集成uCharts、配置UniApp特定设置或处理平台差异时,请使用此技能。 license: 完整条款见LICENSE.txt
何时使用此技能
每当用户想要:
- 将uCharts集成到UniApp项目中
- 配置UniApp项目以与uCharts一起工作(pages.json, manifest.json, easycom)
- 处理在UniApp中使用uCharts时的平台特定行为(H5, 小程序, App, nvue)
- 使用UniApp功能(导航、API、生命周期)与uCharts组件
- 构建带有uCharts图表的跨平台UniApp应用程序
- 在UniApp中为自动导入uCharts组件配置easycom
- 处理在UniApp中与uCharts的导航和路由
- 使用uCharts优化UniApp项目
- 部署基于uCharts的UniApp应用程序到多个平台
如何使用此技能
此技能组织成匹配UniApp集成模式和官方UniApp插件结构(https://ext.dcloud.net.cn/plugin?id=271)。在UniApp中使用uCharts时:
-
安装和设置 uCharts在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以与uCharts进行导航 - 加载
examples/integration/uni-api.md以使用UniApp API与uCharts
- 加载
-
处理平台特定行为:
- 加载
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和uCharts集成APIapi/config-api.md- 配置API参考
-
使用模板 快速启动:
templates/basic-uniapp-project.md- 带有uCharts的基本UniApp项目templates/pages-template.md- pages.json配置模板templates/manifest-template.md- manifest.json配置模板
重要注意事项:
- 此技能专注于UniApp集成,不是uCharts API文档
- 始终在pages.json中配置easycom以自动导入组件
- 使用条件编译(
#ifdef,#endif)用于平台特定代码 - 在部署前在所有目标平台(H5, 小程序, App)上测试
- 在UniApp中使用rpx单位进行响应式大小调整
示例和模板
入门
- 安装:
examples/getting-started/installation.md- 如何在UniApp项目中安装uCharts - 项目设置:
examples/getting-started/project-setup.md- 设置带有uCharts的UniApp项目 - Easycom配置:
examples/getting-started/easycom-config.md- 配置easycom以自动导入组件
集成
- Pages配置:
examples/integration/pages-config.md- 配置pages.json与uCharts - Manifest配置:
examples/integration/manifest-config.md- 配置manifest.json为uCharts - 导航:
examples/integration/navigation.md- 与uCharts的导航和路由 - UniApp API:
examples/integration/uni-api.md- 使用UniApp API与uCharts组件
平台特定
- H5:
examples/platform-specific/h5.md- 与uCharts的H5平台考虑 - 小程序:
examples/platform-specific/miniprogram.md- 与uCharts的小程序考虑 - App:
examples/platform-specific/app.md- 与uCharts的App平台考虑 - nvue:
examples/platform-specific/nvue.md- 与uCharts的nvue考虑
高级
- 自定义主题:
examples/advanced/custom-theme.md- 在UniApp项目中自定义主题 - 构建优化:
examples/advanced/build-optimization.md- 使用uCharts优化UniApp构建 - 多平台:
examples/advanced/multi-platform.md- 多平台部署策略
模板
- 基本项目:
templates/basic-uniapp-project.md- 带有uCharts的基本UniApp项目结构 - Pages模板:
templates/pages-template.md- pages.json配置模板 - Manifest模板:
templates/manifest-template.md- manifest.json配置模板
API参考
- 集成API:
api/integration-api.md- UniApp和uCharts集成API参考 - 配置API:
api/config-api.md- 为UniApp项目的配置API参考
最佳实践
- 使用easycom:在pages.json中配置easycom以自动导入uCharts组件
- 平台测试:在部署前在所有目标平台(H5, 小程序, App)上测试
- 使用rpx单位:在UniApp中使用rpx进行响应式大小调整,px用于固定大小
- Canvas支持:确保Canvas在目标平台上得到正确支持
- Manifest配置:为每个平台正确配置manifest.json
- 条件编译:使用条件编译(
#ifdef,#endif)用于平台特定代码 - 性能:针对每个平台的具体需求优化
- 数据格式:确保数据格式与uCharts要求兼容
- 生命周期管理:正确处理UniApp页面生命周期与uCharts实例
- 内存管理:在onUnload生命周期中清理图表实例
资源
- 官方UniApp插件:https://ext.dcloud.net.cn/plugin?id=271
- UniApp文档:https://uniapp.dcloud.net.cn/
- UniApp API参考:https://uniapp.dcloud.net.cn/api/
关键词
uniapp, ucharts, uniapp charts, uniapp integration, uniapp configuration, easycom, pages.json, manifest.json, uni-app, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异, 图表, canvas, 图表组件, UniApp 图表, 跨平台图表, 小程序图表, App 图表