uniapp-ucharts

name	uniapp-ucharts
description	A comprehensive skill for integrating and using uCharts with UniApp projects. This skill focuses on UniApp-specific integration, configuration, and platform-specific considerations when using uCharts in UniApp applications. Use this skill whenever the user needs to integrate uCharts into UniApp projects, configure UniApp-specific settings, or handle platform differences.
license	Complete terms in LICENSE.txt

When to use this skill

Use this skill whenever the user wants to:

• Integrate uCharts into UniApp projects
• Configure UniApp projects to work with uCharts (pages.json, manifest.json, easycom)
• Handle platform-specific behaviors when using uCharts in UniApp (H5, mini-program, App, nvue)
• Use UniApp features (navigation, APIs, lifecycle) with uCharts components
• Build cross-platform UniApp applications with uCharts charts
• Configure easycom for automatic uCharts component import in UniApp
• Handle navigation and routing with uCharts in UniApp
• Optimize UniApp projects using uCharts
• Deploy uCharts-based UniApp applications to multiple platforms

How to use this skill

This skill is organized to match UniApp integration patterns and the official UniApp plugin structure (https://ext.dcloud.net.cn/plugin?id=271). When working with uCharts in UniApp:

1. Install and setup uCharts in UniApp project:

   • Load examples/getting-started/installation.md for installation in UniApp
   • Load examples/getting-started/project-setup.md for UniApp project configuration
   • Load examples/getting-started/easycom-config.md for easycom configuration

2. Integrate with UniApp features:

   • Load examples/integration/pages-config.md for pages.json configuration
   • Load examples/integration/manifest-config.md for manifest.json configuration
   • Load examples/integration/navigation.md for navigation with uCharts
   • Load examples/integration/uni-api.md for using UniApp APIs with uCharts

3. Handle platform-specific behaviors:

   • Load examples/platform-specific/h5.md for H5 platform considerations
   • Load examples/platform-specific/miniprogram.md for mini-program considerations
   • Load examples/platform-specific/app.md for App platform considerations
   • Load examples/platform-specific/nvue.md for nvue considerations

4. Advanced integration:

   • Load examples/advanced/custom-theme.md for theme customization in UniApp
   • Load examples/advanced/build-optimization.md for build optimization
   • Load examples/advanced/multi-platform.md for multi-platform deployment

5. Reference the API documentation when needed:

   • api/integration-api.md - UniApp and uCharts integration API
   • api/config-api.md - Configuration API reference

6. Use templates for quick start:

   • templates/basic-uniapp-project.md - Basic UniApp project with uCharts
   • templates/pages-template.md - Pages configuration template
   • templates/manifest-template.md - Manifest configuration template

Important Notes:

• This skill focuses on UniApp integration, not uCharts API documentation
• Always configure easycom in pages.json for automatic component import
• Use conditional compilation (#ifdef, #endif) for platform-specific code
• Test on all target platforms (H5, mini-programs, App) before deployment
• Use rpx units for responsive sizing in UniApp

Examples and Templates

Getting Started

• Installation: examples/getting-started/installation.md - How to install uCharts in UniApp projects
• Project Setup: examples/getting-started/project-setup.md - Setting up UniApp project with uCharts
• Easycom Config: examples/getting-started/easycom-config.md - Configuring easycom for automatic component import

Integration

• Pages Config: examples/integration/pages-config.md - Configuring pages.json with uCharts
• Manifest Config: examples/integration/manifest-config.md - Configuring manifest.json for uCharts
• Navigation: examples/integration/navigation.md - Navigation and routing with uCharts
• UniApp API: examples/integration/uni-api.md - Using UniApp APIs with uCharts components

Platform-Specific

• H5: examples/platform-specific/h5.md - H5 platform considerations with uCharts
• Mini-Program: examples/platform-specific/miniprogram.md - Mini-program considerations with uCharts
• App: examples/platform-specific/app.md - App platform considerations with uCharts
• nvue: examples/platform-specific/nvue.md - nvue considerations with uCharts

Advanced

• Custom Theme: examples/advanced/custom-theme.md - Customizing themes in UniApp projects
• Build Optimization: examples/advanced/build-optimization.md - Optimizing UniApp builds with uCharts
• Multi-Platform: examples/advanced/multi-platform.md - Multi-platform deployment strategies

Templates

• Basic Project: templates/basic-uniapp-project.md - Basic UniApp project structure with uCharts
• Pages Template: templates/pages-template.md - pages.json configuration template
• Manifest Template: templates/manifest-template.md - manifest.json configuration template

API Reference

• Integration API: api/integration-api.md - UniApp and uCharts integration API reference
• Config API: api/config-api.md - Configuration API reference for UniApp projects

Best Practices

1. Use easycom: Configure easycom in pages.json for automatic uCharts component import
2. Platform Testing: Test on all target platforms (H5, mini-programs, App) before deployment
3. Use rpx Units: Use rpx for responsive sizing in UniApp, px for fixed sizes
4. Canvas Support: Ensure canvas is properly supported on target platforms
5. Manifest Configuration: Properly configure manifest.json for each platform
6. Conditional Compilation: Use conditional compilation (#ifdef, #endif) for platform-specific code
7. Performance: Optimize for each platform's specific requirements
8. Data Format: Ensure data format is compatible with uCharts requirements
9. Lifecycle Management: Properly handle UniApp page lifecycle with uCharts instances
10. Memory Management: Clean up chart instances in onUnload lifecycle

Resources

• Official UniApp Plugin: https://ext.dcloud.net.cn/plugin?id=271
• UniApp Documentation: https://uniapp.dcloud.net.cn/
• UniApp API Reference: https://uniapp.dcloud.net.cn/api/

Keywords

uniapp, ucharts, uniapp charts, uniapp integration, uniapp configuration, easycom, pages.json, manifest.json, uni-app, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异, 图表, canvas, 图表组件, UniApp 图表, 跨平台图表, 小程序图表, App 图表

能力边界

✅ 适用场景

• 当你需要使用此技能对应的技术栈时
• 当项目需要遵循最佳实践时
• 当需要快速上手或深入理解核心概念时

⚠️ 需要注意

• 复杂业务逻辑需要结合具体场景调整
• 性能优化需要根据实际数据量评估

❌ 不适用场景

• 不相关的技术栈或框架
• 需要完全自定义的特殊场景

常见陷阱 (Gotchas)

1. 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
2. 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
3. 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
4. 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
5. 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题

使用流程

Step 1: 环境准备

确保开发环境已安装必要的依赖和工具。

Step 2: 配置初始化

根据项目需求进行基础配置。

Step 3: 核心功能使用

按照示例代码实现核心功能。

Step 4: 测试验证

运行测试确保功能正常。

Step 5: 部署上线

完成开发后进行部署和监控。