老张不嚣张
2026-11-10 17:54:33 发布HarmonyOS 应用开发的一项重要工作,就是根据业务需求接入系统能力。例如,应用可能需要访问相机、选择图片、获取定位、调用文件管理能力,或者使用系统提供的其他功能。这些能力能够让应用突破普通页面交互的限制,提供更加完整的使用体验。
但对开发者来说,接入系统能力并不总是一件简单的事。不同能力可能涉及不同的 API、权限声明、授权状态、异常处理和生命周期管理。如果把这些逻辑全部写在页面组件中,页面代码很快就会变得臃肿。更麻烦的是,当多个页面需要使用同一项系统能力时,开发者可能不得不重复编写类似代码。
AI Coding 可以帮助开发者处理这类重复工作。相比让 AI 直接在页面中接入系统 API,更推荐的方式是让它先分析项目需求,再搭建一个统一的平台能力封装层。页面只负责触发业务操作,系统能力的调用、权限检查和异常处理则由独立模块承担。
以一个需要上传头像的用户中心页面为例,用户点击头像后,可以从系统提供的图片选择能力中选择图片,再将图片展示在个人中心页面中。最直接的做法,是在页面组件中编写图片选择逻辑。但如果后续商品发布、动态发布、资料编辑等页面也需要选择图片,重复代码就会越来越多。
此时可以先让 AI 分析当前工程:
当前 HarmonyOS 应用需要接入图片选择能力。
使用场景:
1. 用户中心修改头像;
2. 商品发布页面选择商品图片;
3. 动态发布页面选择多张图片。
请先分析当前工程的模块结构、SDK 版本和已有系统能力调用代码。
暂时不要编写实现代码。
请输出:
1. 哪些页面需要使用图片选择能力;
2. 是否适合建立统一的图片选择封装模块;
3. 各业务场景需要的输入参数和返回结果;
4. 权限、取消操作、异常情况需要如何处理;
5. 当前 SDK 下适用的 API 和调用限制。
AI 完成分析后,开发者可以进一步明确封装层的职责。比如,图片选择模块负责调用系统图片选择能力、接收用户选择结果、处理取消和异常情况,并将结果以业务页面能够使用的形式返回。至于图片上传、压缩、裁剪和服务器存储,则属于不同的业务职责,不应该全部塞进同一个模块。
这种边界非常重要。AI 经常倾向于把一个功能涉及的所有操作都写在一起,生成一个看起来很完整、实际上难以维护的大模块。开发者需要告诉它哪些事情应该由平台能力封装层完成,哪些事情应该留给业务层。
可以使用下面的提示词:
请为当前项目设计统一的图片选择能力封装模块。
封装层职责:
1. 根据业务传入的配置调用当前 SDK 支持的图片选择能力;
2. 处理用户取消选择的情况;
3. 对选择结果进行必要的有效性检查;
4. 向业务层返回清晰的数据结构;
5. 对异常情况提供统一处理方式。
不属于封装层的职责:
1. 不负责服务器上传;
2. 不负责业务页面 UI;
3. 不擅自增加图片压缩和裁剪流程;
4. 不修改现有页面的业务逻辑。
请先给出模块结构和接口设计,经确认后再生成代码。
接口设计确定后,再让 AI 分步实现。对于图片选择这样的系统能力,尤其需要注意 API 的使用约束。不能仅凭 AI 生成的代码判断它是否正确,应让 AI 对照当前工程的 SDK 版本和项目已有示例,确认 API 的导入方式、参数类型、调用上下文和返回结果。
系统能力封装还需要考虑异常路径。例如,用户打开图片选择界面后主动取消,应用不应该把取消操作当成系统错误;如果系统能力调用失败,也不能让页面进入一个无法恢复的状态。对于需要授权的能力,还要区分权限尚未申请、用户拒绝授权、权限被撤销等不同情况。具体权限流程应根据对应系统能力的要求设计,不能让 AI 为所有系统能力套用同一套授权逻辑。
完成封装后,建议让 AI 帮助检查模块是否真正实现了复用:
请检查图片选择封装模块。
重点检查:
1. 是否与具体业务页面耦合;
2. 是否重复实现了系统能力调用;
3. 是否正确处理用户取消操作;
4. 是否对异常情况进行了区分;
5. 返回数据是否具有明确类型;
6. 是否存在不必要的全局状态;
7. 是否符合当前工程的 ArkTS 和 SDK 使用规范。
请列出检查结果,并只修改确认存在的问题。
接下来可以将这个模块接入头像修改页面和商品发布页面。两个页面使用相同的平台能力,但业务行为不同:头像页面可能只需要一张图片,商品发布页面则可能需要多张图片。封装层应提供合理的配置能力,而不是让业务页面通过复制代码来适应不同场景。
需要提醒的是,系统能力封装并不意味着所有系统 API 都应该统一包装。对于只有一个页面使用、调用逻辑非常简单的能力,过度封装反而会增加维护成本。更适合封装的是那些多个业务页面都会使用、调用流程相对稳定、异常处理比较复杂的能力。
AI Coding 最有价值的地方,是帮助开发者把重复的平台能力调用整理成可维护的工程模块。开发者负责确定业务边界和架构规则,AI 负责生成代码、补充异常处理和检查重复逻辑。这样既能提高系统能力接入效率,也能让 HarmonyOS 应用在持续增加功能时保持清晰的代码结构。
老张不嚣张
我还没有写个人简介......
帖子
提问
粉丝
HarmonyOS 系统能力接入太复杂?让 AI Coding 帮你搭建平台能力封装层
2026-11-10 17:54:33 发布AI Coding 写网络请求代码,如何避免 HarmonyOS 应用出现接口调用混乱?
2026-11-10 17:53:22 发布



0
京公网安备:11010502051901号