SuperAPI AI 工具集

maui-platform-apis

通用与其它

查看项目

更新于 10-16 11:36

技能介绍

用途

该技能为智能体提供在 .NET MAUI 应用中使用设备能力的最佳实践、模式与跨平台抽象方案,覆盖权限、传感器、文件选择器、地理位置、相机访问、通知以及平台特定 API。其目标是确保所有平台 API 的使用安全、一致,并符合 MAUI 的跨平台架构。

核心原则

  1. 权限优先设计:在访问设备能力前,始终请求并检查权限。
  2. 跨平台抽象:尽可能使用 MAUI Essentials API。
  3. 优雅降级:如果某平台不支持某能力,需妥善处理。
  4. 关注点分离:将平台 API 调用封装在服务与接口中。
  5. 用户透明:在请求权限时提供清晰说明。

支持的平台能力

  • 地理位置
  • 相机与媒体选择器
  • 文件选择器
  • 剪贴板
  • 振动
  • 手电筒
  • 连接状态
  • 传感器(加速度计、指南针、陀螺仪)
  • 通知(本地)
  • 权限

推荐目录结构

Services
└─ Platform
   ├─ Implementations
   └─ Interfaces

智能体使用指南

  • 生成使用设备能力的代码时:
    • 始终先检查权限。
    • 使用 Permissions.RequestAsync<T>()。
    • 使用 MAUI Essentials API(例如 Geolocation、MediaPicker)。
    • 将逻辑封装在服务中(例如 IGeolocationService)。
  • 当被要求“访问相机”时,生成:
    • 服务抽象
    • 平台安全的实现
    • 权限检查
  • 当被要求“获取用户位置”时,应用:
    • 权限检查
    • 回退处理
    • 取消令牌

范围之外

  • 认证(由 maui-authentication 覆盖)
  • UI 布局(由 maui-ui-best-practices 覆盖)
  • 数据库存储(由 maui-data-storage 覆盖)

安装与使用方式

暂未提供。

适用场景与限制

该技能适用于在 .NET MAUI 应用中需要访问设备能力(如地理位置、相机、文件、传感器、通知等)的代码生成场景。限制在于其仅聚焦平台 API 使用,不涉及认证、UI 布局与数据库存储;其他具体平台支持细节、版本要求与运行环境限制暂未提供。