用途:add-native 是原生设备能力与原生控件的公共入口,为上游模板已内置的原生模块生成 src/native/ 下的类型化封装,界面通过封装调用,避免直接接触 Expo 模块,保持判别联合结果契约一致。
主要能力:覆盖相机/拍照、图片选择、条码与二维码扫描、文档选择、文件选择、安全存储、文件系统、分享、定位、生物识别、剪贴板、邮件撰写、音频、视频、传感器、屏幕方向、触觉反馈、设备信息等;部分能力有专用内部实现(相机、PDF 报告、PDF 查看器、手写输入、地理定位),调用时仍统一使用 /add-native <capability>。
使用方式:先运行 node "${PLUGIN_ROOT}/scripts/check-version.js" 并阅读 shared-instructions.md;执行任何项目读取或命令前先完成 native-artifact-compatibility.md 的 Step 0,解析 --working-dir 与 owner 上下文,后续所有 shell 与文件操作使用解析出的绝对根路径。能力需从实际 package.json 解析,确认未被运行时禁用后再生成封装。
限制:禁止运行 npx expo install、npm install 或 yarn add 安装原生模块;禁止编辑 app.config.js 与 package.json 的原生依赖;若所需模块不在 package.json 中应停止,不得绕过安装。绑定 Dataverse File/Image 列的表单字段应使用 @microsoft/power-apps-native-host 的 <FilePicker>/<ImagePicker>,而非原生封装或原始 Expo 模块;PDF 查看器仅接受 https:// 或 file:// 输入。资料未提供收费、价格与平台支持信息。