用途
SAPUI5 技能用于构建基于 SAP UI5 框架的企业级应用。当开发 SAPUI5/OpenUI5 应用、XML 视图、控制器、自定义控件、路由、OData v2/v4 模型绑定、Fiori Elements 集成、QUnit/OPA5 测试,或进行无障碍、安全、性能改进,以及使用 UI5 MCP 辅助脚手架和 API 查询时,可使用本技能。
主要能力
- MCP 工具集成(v2.0.0 新增):集成官方 @ui5/mcp-server,提供实时开发工具,包括:脚手架(ui5-app-scaffolder 智能体或 /ui5-scaffold 命令)、API 参考(ui5-api-explorer 智能体或 /ui5-api 命令)、代码质量(ui5-code-quality-advisor 智能体或 /ui5-lint 命令)、迁移(ui5-migration-specialist 智能体)、版本信息(/ui5-version 命令)、工具目录(/ui5-mcp-tools 命令)。MCP 包版本由 sap-dependency-security 管理,并通过 npm run validate:mcp-security 校验。
- 优雅降级:所有功能在无 MCP 环境下也可通过参考文件和内置模板正常使用。
- 核心概念覆盖:MVC 架构、Component 与 manifest、数据模型(JSON、OData V2、Resource/i18n)、视图与控制器、路由与导航。
- SAP Fiori Elements:无需 JavaScript UI 代码,通过 OData 注解构建应用,支持 List Report、Object Page、Analytical List Page、Overview Page、Worklist 等应用类型。
- 元数据驱动控件(MDC):sap.ui.mdc 库提供 MDC Table、MDC FilterBar、MDC Value Help 等控件,可在运行时构建动态 UI。
- 测试:支持 QUnit 单元测试、OPA5 集成测试和 Mock Server 模拟 OData 后端。
- 最佳实践:始终使用异步模式、XML 视图、正确命名空间、国际化、数据绑定、安全、性能、无障碍。
使用方式
快速开始
使用 UI5 Tooling(推荐)或 SAP Business Application Studio:
# Install UI5 CLI
npm install -g @ui5/cli
# Create new project
mkdir my-sapui5-app && cd my-sapui5-app
npm init -y
# Initialize UI5 project
ui5 init
# Add UI5 dependencies
npm install --save-dev @ui5/cli
# Start development server
ui5 serve
项目结构
my-sapui5-app/
├── webapp/
│ ├── Component.js
│ ├── manifest.json
│ ├── index.html
│ ├── controller/
│ │ └── Main.controller.js
│ ├── view/
│ │ └── Main.view.xml
│ ├── model/
│ │ └── formatter.js
│ ├── i18n/
│ │ └── i18n.properties
│ ├── css/
│ │ └── style.css
│ └── test/
│ ├── unit/
│ └── integration/
├── ui5.yaml
└── package.json
模板
可将 templates/ 目录中的模板复制到项目并替换占位符(如 {{namespace}}、{{ControllerName}}):
- templates/basic-component.js:Component 模板
- templates/manifest.json:应用描述符模板
- templates/xml-view.xml:含常见模式的 XML 视图
- templates/controller.js:遵循最佳实践的控制器
- templates/formatter.js:常用格式化函数
开发工具
ui5 serve # Development server
ui5 build # Build for production
npm test # Run tests
UI5 Inspector 浏览器扩展用于调试,可查看控件树和绑定、进行性能分析。Support Assistant 通过 Ctrl+Alt+Shift+S 打开,是内置质量检查器。
适用场景
- 开发 SAPUI5/OpenUI5 企业应用
- 构建 XML 视图、控制器、自定义控件、路由
- OData v2/v4 模型绑定与后端服务集成
- 使用 Fiori Elements 模板和注解快速构建应用
- 使用 MDC 控件构建元数据驱动的动态 UI
- 编写 QUnit/OPA5 测试与 Mock Server
- 无障碍、安全、性能优化
- 使用 UI5 MCP 辅助脚手架和 API 查询
限制
- 本技能为 SAPUI5 开发技能,具体收费、价格、平台支持范围等商业信息暂未提供。
- MCP 集成需按 references/mcp-integration.md 进行设置,MCP 包版本受 sap-dependency-security 约束。
- 相关技能(sap-fiori-tools、sap-cap-capire、sap-btp-cloud-platform、sap-abap、sap-api-style、sap-dependency-security)为独立技能,需另行获取。
- 许可证为 GPL-3.0。
内置资源
参考文档(15 份):glossary.md、core-architecture.md、data-binding-models.md、testing.md、fiori-elements.md、typescript-support.md、routing-navigation.md、performance-optimization.md、accessibility.md、security.md、mdc-typescript-advanced.md、mcp-integration.md、code-quality-checklist.md、migration-patterns.md、scaffolding-templates.md。
模板(5 个):basic-component.js、controller.js、xml-view.xml、formatter.js、manifest.json。