158 lines
7.9 KiB
Markdown
158 lines
7.9 KiB
Markdown
---
|
|
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: 部署上线
|
|
完成开发后进行部署和监控。
|