权限申请说明——XPrinter 需要哪些手机权限
为什么要申请权限
XPrinter 作为一个"打印工具"看起来简单，但它要完成"连接硬件打印机 + 编辑模板 + 导入数据 + 分享结果"这一整条链路，确实需要涉及多项手机权限。
下面按操作系统分别说明。
Android 权限清单
以下是 XPrinter Android 版申请的所有权限，每条后面标注用途：
蓝牙相关
| 权限 | 用途 |
|---|---|
| 与蓝牙设备配对 | 连接蓝牙打印机 |
| 访问蓝牙设置 | 扫描附近蓝牙打印机 |
| 控制近距离通信 | NFC 标签打印机连接（部分机型） |
位置相关
| 权限 | 用途 |
|---|---|
| 大致位置（基于网络） | Android 12+ 强制要求——蓝牙搜索附近设备必须同时开启位置 |
| 精确位置（基于 GPS） | 同上，更精准的位置定位 |
存储相关
| 权限 | 用途 |
|---|---|
| 修改/删除存储卡内容 | 保存模板图片、缓存数据 |
| 读取存储卡内容 | 读取 Excel 文件、读取本地模板、导入 PDF/图片 |
| 访问 SD 卡文件系统 | 同上，兼容部分机型的 SD 卡 |
相机相关
| 权限 | 用途 |
|---|---|
| 拍摄照片和视频 | 识图新建（OCR）拍照、扫码新建/取模、拍摄要打印的图片 |
| 控制闪光灯 | 光线暗时辅助扫码 |
网络相关
| 权限 | 用途 |
|---|---|
| 完全网络访问 | 云同步、下载模板素材、OCR 联网识别 |
| 查看网络连接 | 判断当前是否在 WiFi 环境、云打印机通信 |
| 更改网络连接性 | 辅助部分配网场景 |
其他
| 权限 | 用途 |
|---|---|
| 麦克风 | 语音搜索模板（可选功能，不开也能用） |
| 防止手机休眠 | 长时间批量打印时防止手机自动息屏 |
| 控制振动 | 连接成功/打印完成时震动提示 |
| 在其他应用之上显示内容 | 浮动打印通知 |
| 向用户定义的字典添加字词 | 学习用户自定义的术语和缩写 |
Android 集成的第三方 SDK
XPrinter Android 版集成了以下第三方 SDK（隐私政策中有完整说明）：
| SDK | 用途 |
|---|---|
| 百度 OCR | 识图新建功能的文字识别 |
| 腾讯移动分析 | 匿名使用数据统计，帮助改进 App |
| QQ 分享 | 模板分享到 QQ 好友 |
| Facebook React | 部分机型的热更新机制 |
这些 SDK 各自也会申请少量权限（如百度 OCR 需要存储权限来缓存识别结果）。
iOS 权限清单
iOS 的权限申请方式和 Android 不同——通常在首次使用对应功能时才弹窗请求，而不是安装时一次全部请求：
| 权限 | 触发场景 | 用途 |
|---|---|---|
| 相机 | 首次使用识图新建、扫码新建 | 拍照识别文字 / 扫码 |
| 相册 | 首次从相册选图插入模板 | 导入图片素材 |
| 蓝牙 | 首次连接蓝牙打印机 | 发现并连接打印机 |
| 麦克风 | 首次使用语音搜索 | 语音输入模板名 |
| 通知 | 首次使用打印/云空间功能 | 打印完成、效期到期提醒 |
iOS 的权限管理比 Android 更严格——任何时候都可以在"设置 → 隐私与安全性"中单独关闭某个权限，关闭后对应功能不可用但其他功能照常。
权限安全建议
- 第一次打开 App 时不要急着拒绝权限——大多数权限都是功能必需的，拒绝后该功能会直接用不了
- 麦克风权限可选——如果你不用语音搜索，可以拒绝
- 定期在系统设置中审查权限——尤其在不常用某个功能后可以关掉对应权限
- XPrinter 不会读取你的通讯录、短信、位置轨迹——权限申请仅限于上表列出的用途，不会收集隐私数据
权限被拒后怎么办
如果某个功能突然用不了（比如识图新建打开后黑屏、蓝牙搜不到打印机），大概率是对应权限被拒了。解决方法：
- Android：设置 → 应用管理 → XPrinter → 权限 → 手动开启缺失的权限
- iOS：设置 → 隐私与安全性 → 对应权限类型 → 找到 XPrinter → 开启
开启后重新打开 App 即可恢复。