无INTERNET权限、无分析、无账号:离线查看器Gander如何实现并自证"绝对隐私"
无INTERNET权限、无分析、无账号:离线查看器Gander如何实现并自证"绝对隐私"
Gander 是一款开源的 Android 离线文件查看器,可以查看 PDF、Word、Excel、PowerPoint、图片、视频、音频、Markdown、代码和 ZIP 归档,却拥有 零权限 —— 它连 INTERNET 权限都不申请,没有分析统计、没有账号、没有服务器,文件永远只在你手机上打开。这篇文章带你拆解 Gander 是如何做到的,以及它又是如何用构建任务和自动化测试,把"隐私"从一句口号变成可以反复验证的代码事实。
隐私基线:零权限、无 INTERNET、无账号
大多数文件查看器要么要存储权限,要么内嵌"在线预览"—— 把文件上传到云端再渲染回来。Gander 选择了另一条路:Private by construction(靠结构实现隐私)。
- 零权限:合并后的清单里没有任何用户可见的权限,商店详情页的权限列表是空的
- 无 INTERNET 权限:应用从机制上就不可能发起任何网络请求
- 无分析、无广告、无崩溃上报:依赖列表里没有任何网络 SDK
- 无账号、无服务器:所有渲染都在设备本地完成
上面这张截图来自 docs/permissions.png:系统"应用信息"页中 Gander 的 Permissions 一栏写着 No permissions requested —— 这不是宣传图,而是安装后可以直接在手机上核实的状态。
关键设置一:不申请 INTERNET,从源头断掉出口
Android 中,一个应用没有 INTERNET 权限就无法建立网络连接,这是操作系统层面的硬约束,比任何代码审计都可靠。
更值得注意的是,第三方依赖会悄悄带来权限。比如 Gander 播放音视频用的 Media3 库会传递性地声明 ACCESS_NETWORK_STATE,作者在 AndroidManifest.xml 中直接用 tools:node="remove" 把它剥离,并注释说明:Gander 只播放本地文件,这个权限毫无意义。
关键设置二:文件靠 SAF 临时授权,而不是存储权限
没有存储权限,Gander 凭什么读到文件?答案是 Android 的 Storage Access Framework(SAF):用户通过系统文件选择器选中一个文件、文件夹,或从其他应用"用 Gander 打开/分享"时,系统会发放一次性的只读 content URI 授权。
在 AndroidManifest.xml 中,ViewerActivity 的 intent-filter 只接受 content:// 协议,明确拒绝了 file:// 路径——注释写得很直白:
其他应用发来的
file://路径会用 Gander 自身的权限去读取,而没有存储权限时,Gander 能读到的只有自己的私有目录。
授权是"用完即走"的:文件关掉,授权随应用卡片一起消失;重启后,对方的读取授权也不会存活,因此连"最近文件"列表都不会跨重启残留。
关键设置三:云端备份与换机迁移,全部关死
这是最容易被忽视的一条数据出口:Android 自动备份会把应用数据(比如"最近打开的文件名列表")复制到用户的 Google Drive。
Gander 的回答是"备份出来的东西毫无价值":最近列表里的 URI 授权是每次安装独立的,恢复之后必然失效、渲染为空。既然如此,让文件名和时间戳离开手机就毫无意义。实现分布在三处:
| 位置 | 作用 |
|---|---|
| AndroidManifest.xml | android:allowBackup="false",关闭旧版自动备份 |
| data_extraction_rules.xml | Android 12+:云端备份和换机迁移逐域排除,一个都不留 |
| backup_rules.xml | Android 11 及更早:同样逐域排除 |
规则文件里有一个反直觉的细节:一个空的规则段不等于"什么都不备份",Android 会把它读成"全部数据减去排除项"。所以 Gander 把 root、file、database、sharedpref 等全部 9 个域显式写进了 exclude。
关键设置四:WebView 的默认"上报行为"也被关掉
Gander 用 WebView 离线渲染 PDF 和 Office 文档。但 WebView 组件本身有自己的默认行为,会绕过应用的权限体系:
- WebView 指标上报:系统 WebView 会从它自己的进程(拥有网络访问)为每个内嵌应用上传使用指标,连包名一起。AndroidManifest.xml 通过
WebView.MetricsOptOut元数据显式退订; - Safe Browsing:会把 WebView 加载的 URL 拿去查询 Google 的黑名单。Gander 的 URL 只来自它自己的本地页面,直接关掉,见 AndroidManifest.xml。
同时,文档的渲染链路完全离线:PDF 走内置的 pdf.js,JS 库全部打在 APK 的 assets 里(见 assets/viewer/),文档内容从 content URI 直接流式读取,WebViewAssetLoader 拦截所有请求——网络栈从头到尾没有被触碰。
自证机制:测试与构建流水线,不让隐私"悄悄回归"
一句"我们不收集数据"谁都会说,Gander 的差异在于:它把承诺写成了会失败的检查。
构建期硬拦截:checkPermissions
在 build.gradle.kts 中,check<Variant>Permissions 任务会读取合并后的 AndroidManifest,只要发现白名单之外的权限,构建直接失败,并打印是谁带进来的。而且它同时挂在 assemble(APK)和 bundle(AAB)两个产物上——因为上架商店的正是 AAB,只查 APK 就会留下"用户当作承诺读到的权限列表"无人看管。
三层测试,从三个独立角度复读同一句承诺
| 测试 | 验证角度 |
|---|---|
| ZeroPermissionTest.kt | 在真机上查询已安装包:平台权限列表为空、INTERNET 明确被拒 |
| FormatRegistryTest.kt | 在 Robolectric 沙箱中从包管理器反向读回权限,与构建门禁互为镜像 |
| PrivacyManifestTest.kt | 逐条断言备份规则"零包含、全域排除"、WebView 指标已退订、Safe Browsing 已关闭 |
三者刻意不共用代码——注释里写道:如果门禁的两半读的是同一份白名单,那它实际上只检查了一个东西。任何一个角度失真,另外两个都能抓住。
文档与代码的定期对账
docs/play-data-safety.md 记录了 Google Play 数据安全问卷的逐项答案及其依据,并要求每次发版前重新核对权限列表、依赖清单与隐私政策 docs/privacy.html 是否仍然与代码一致。发版卫生甚至由 ReleaseHygieneTest.kt 守护:商店描述、变更日志、版本号之间不允许悄悄脱节。
结语:把"绝对隐私"变成可验证的工程属性
Gander 的做法可以浓缩成一条思路:隐私不应依赖开发者的好意,而应依赖无法绕过的机制。
- 机制层:不申请
INTERNET权限,让"外传数据"在操作系统层面不可能发生; - 数据层:SAF 一次性只读授权 + 关闭一切备份与迁移通道;
- 验证层:构建任务失败拦截 + 真机/沙箱/清单三层测试 + 商店文档对账。
对一个查看器来说,打开文件是功能,而什么都看不见才是它的隐私承诺。Gander 值得借鉴的,正是后半句。


