uni-halo/.agents/bak-skills/uniappx-uview-pro/SKILL.md

name, description, license

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

When to use this skill

Use this skill whenever the user wants to:

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

How to use this skill

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

1. Install and setup uView Pro in UniAppX project:

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

2. Integrate with UniAppX 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 uView Pro
   • Load examples/integration/uniappx-api.md for using UniAppX APIs with uView Pro

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 UniAppX
   • 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 - UniAppX and uView Pro integration API
   • api/config-api.md - Configuration API reference

6. Use templates for quick start:

   • templates/basic-uniappx-project.md - Basic UniAppX project with uView Pro
   • templates/pages-template.md - Pages configuration template
   • templates/manifest-template.md - Manifest configuration template

Important Notes:

• This skill focuses on UniAppX integration, not uView Pro API documentation
• UniAppX uses TypeScript (.uts files) and Composition API (setup syntax)
• 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 UniAppX

Examples and Templates

Getting Started

• Installation: examples/getting-started/installation.md - How to install uView Pro in UniAppX projects
• Project Setup: examples/getting-started/project-setup.md - Setting up UniAppX project with uView Pro
• 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 uView Pro
• Manifest Config: examples/integration/manifest-config.md - Configuring manifest.json for uView Pro
• Navigation: examples/integration/navigation.md - Navigation and routing with uView Pro
• UniAppX API: examples/integration/uniappx-api.md - Using UniAppX APIs with uView Pro components

Platform-Specific

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

Advanced

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

Templates

• Basic Project: templates/basic-uniappx-project.md - Basic UniAppX project structure with uView Pro
• 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 - UniAppX and uView Pro integration API reference
• Config API: api/config-api.md - Configuration API reference for UniAppX projects

Best Practices

1. Use easycom: Configure easycom in pages.json for automatic uView Pro 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 UniAppX, px for fixed sizes
4. SCSS Support: Ensure SCSS is properly configured in UniAppX project
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. TypeScript: Use TypeScript (.uts files) and proper type definitions
9. Composition API: Use Composition API and setup syntax (recommended for UniAppX)
10. Lifecycle Management: Properly handle UniAppX page lifecycle with uView Pro components

Resources

• Official UniAppX Plugin: https://ext.dcloud.net.cn/plugin?id=24633
• UniAppX Documentation: https://uniapp.dcloud.net.cn/uni-app-x/
• UniAppX API Reference: https://uniapp.dcloud.net.cn/uni-app-x/api/

Keywords

uniappx, uniapp-x, uview-pro, uview pro, uniappx integration, uniappx configuration, easycom, pages.json, manifest.json, uni-app-x, 小程序, 跨平台, H5, App, nvue, 条件编译, 平台差异, TypeScript, Composition API, setup 语法, .uts 文件, UniAppX 组件, 跨平台组件, 小程序组件, App 组件

能力边界

✅ 适用场景

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

⚠️ 需要注意

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

❌ 不适用场景

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

常见陷阱 (Gotchas)

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

使用流程

Step 1: 环境准备

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

Step 2: 配置初始化

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

Step 3: 核心功能使用

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

Step 4: 测试验证

运行测试确保功能正常。

Step 5: 部署上线

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