SuperAPI AI 工具集

native-integration

编程与开发

查看项目

更新于 11-11 22:15

技能介绍

本技能针对 React Native 应用中跨越 JavaScript 与原生边界的开发与评审工作,适用于 iOS 和 Android,React Native 0.76+,默认假定应用处于新架构互操作模式(除非条目另有说明)。

适用场景包括:集成原生模块、Turbo Module 或平台 API;请求权限,或处理相机、生物识别、文件、位置;添加后台任务或原生监听器;审查跨越 JavaScript 与原生边界的改动。

严重级别:合并阻断项为本次改动新增的权限提示在拒绝后循环出现,或本次改动新增的监听器在卸载时未移除;应修复项为用途描述文案与提示出现时机(只要拒绝不会导致崩溃)。

权限方面,本技能负责提示何时展示及拒绝后的表现(分析同意归安全领域负责)。要求:在使用的当下请求权限,而非应用启动或页面挂载时;拒绝、受限、撤销状态都有不崩溃、不循环弹窗的处理路径;用户可在无该权限时继续,或被告知什么被阻断及如何在设置中开启;iOS 用途字符串说明具体目的,Android 只声明功能实际使用的权限。资料给出错误示例(在 useEffect 挂载时请求相机权限)和正确示例(在拍照动作中先查询状态,拒绝则请求,仍未授予则标记需前往设置,受限则直接标记需设置,否则打开相机)。

原生边界方面:JavaScript API 返回结果或类型化错误,不把非结构化原生异常抛到页面;原生实现缺失或过旧时有回退(隐藏功能或走受支持路径);跨桥传递的值必须可序列化,不传函数、类实例、循环对象;平台差异显式处理(Platform.OS 或分文件),不假定一致;应用处于新架构时使用新架构互操作,不为新模块无理由添加旧桥。

生命周期方面:原生监听器、传感器与订阅在卸载时移除;后台工作遵守系统限制(时间、网络、用户可见目的)且可取消;必须完成的工作(上传、支付)以服务端确认为准,而非仅凭原生回调;原生 UI 弹出模态或活动界面后,关闭时恢复 React Native 页面。

资料列出反模式及风险与修复:挂载时在 useEffect 请求权限(用户尚不理解原因即弹窗,拒绝后无恢复)应改为从需要该权限的动作中请求并处理拒绝;把“曾授予一次”当作永久有效(撤销或受限后下次调用崩溃)应在每次使用前检查状态;把 JS 回调对象传入原生且从不移除(泄漏及卸载后调用)应使用带清理函数的订阅;用 catch {} 吞掉原生错误(页面看似空闲而功能已失败)应暴露类型化错误并提供重试或回退。

陷阱包括:Android 可能在活动重启后才返回权限结果,不要假定调用请求的组件仍挂载;iOS 受限照片访问不等于完全访问,应按受限集合处理而非视为拒绝或授予;生物识别成功只证明设备解锁了密钥,不证明服务端已接受用户,需在服务端确认会话;触及 UI 或传感器的原生模块必须在平台主线程运行,后台线程调用可能崩溃或静默丢事件;相机或选择器返回的文件 URI 常为临时路径,必须保留的内容应复制,且路径含用户内容时不要记录日志。