一句话结论: 找不到文件、读不出文件,九成是 Scope(文件范围)和路径写法不匹配。App 自己的文件放 ASD 私有目录(App 范围,只写文件名,免权限);要对外可见就写共享标准目录(Shared 范围,路径以 / 开头);别人的私有目录和别人的非媒体文件,走 SAF 或干脆别碰。原生组件就能解决,不需要付费扩展。
问题背景
不少从 Kodular、Thunkable 迁移过来的开发者都会卡在同一个地方:用下载组件把文件下下来之后,在手机文件管理器里翻遍了也找不到;或者反过来——自己往某个目录写了个 txt,App 却怎么都读不出来,报 file not found;再或者直接崩在权限申请上,Logcat 里一串 content:// URI 相关的报错。
于是有人告诉你「装个付费扩展就好了」。其实先别急,这个问题在原生 App Inventor 里就能解决,你只是需要把 Android 10 以后的「分区存储(Scoped Storage)」规则搞清楚。本文把原理和可照抄的做法一次讲完;想系统了解 App 专属目录(ASD)的来龙去脉,也可以先读站内的 ASD 专题文章。
环境
- App Inventor 2 中文网(MIT 版项目 .aia 互相导入导出没有差别)
- Android 10 及以上(分区存储强制执行的版本);Android 9 及以下行为不同,见后文 Legacy 说明
- 用到的组件只有内置的文件管理器(File)和下载组件,不需要任何 .aix 扩展
原因分析:三种文件范围(Scope)
文件管理器组件有一个关键概念:Scope(文件范围),在属性面板里叫默认作用域,可选三个值:
| Scope | 实际路径 | 需要权限? | 卸载 App 后 |
|---|---|---|---|
| App(ASD,应用专属目录) | /Android/data/<你的包名>/files/ |
不需要 | 文件一起删除 |
| Shared(共享存储) | /storage/emulated/0/Download/ 等 |
媒体文件不需要,其他类型受限 | 保留 |
| Legacy(旧行为) | 任意路径随意读写 | 需要 WRITE_EXTERNAL_STORAGE |
保留 |
理解了这张表,你的困惑基本就解开了:
- 下载组件默认把文件存到共享存储的
/Downloads(即 Shared 范围),而不是 App 的私有目录。所以你在 App 里按「只用文件名」的方式去找,是找不到的——那个路径在 ASD 里根本没这个文件。 - ASD 就是
/Android/data/包名/files/,这是 Android 官方设计给你「放自己文件、不需要任何权限」的地方。它对用户不可见(Android 11 以后文件管理器隐藏了其他应用的/Android/data),卸载即清空——所以放素材缓存正合适,放用户的重要数据就不合适。 - 你读写不了其他应用的
/Android/data目录,这是系统级限制,任何扩展都绕不过去。 - 想读取「不是你的 App 创建的」非媒体文本文件(比如你手工放到手机根目录某个文件夹里的 txt),在 Android 11+ 上必须走 SAF(存储访问框架,即文件选择器让用户挑)。这是很多老帖子折腾半天 Legacy、改路径、去空格都失败的根本原因——不是路径写错,是这条路系统就不让走。
另外注意:Legacy 范围只在 Android 10 以下才能真正「为所欲为」,Android 10 以上系统会逐步忽略它,新项目不建议依赖。
完整做法
场景 A:下载文件并收进自己的私有目录
流程是:下载组件把文件存到共享 /Downloads,在下载完成事件里用文件管理器的移动文件积木搬进 ASD。它有四个参数:
- 源作用域:选 Shared
- 源文件名:填
/Downloads/你的文件.mp3(共享目录的文件名要带路径,以/开头) - 目标作用域:选 App
- 目标文件名:填
我的文件.mp3(App 范围只写文件名,不要带任何路径)
搬完之后,你的 App 里所有读写这个文件的积木,都只写文件名 我的文件.mp3,Scope 用默认的 App 即可。
场景 B:在私有目录里保存和读取文本
这是最干净的方式,全程不需要任何存储权限:
global 配置文件名 = "config.txt"
when Screen1.Initialize() {
文件管理器1.ReadFrom(配置文件名)
}
when 文件管理器1.GotText(text) {
标签_状态.Text = text
}
when 按钮_保存.Click() {
var 内容 = 文本输入框1.Text
// SaveFile 积木的参数顺序是:先文本内容,后文件名
文件管理器1.SaveFile(内容, 配置文件名)
}
说明两点:
- 读取文件读到内容后会触发获得文本事件,内容通过参数
文本传进来——它是异步的,不要在 Click 里紧接着就取结果。 - 保存文件存的位置就是 ASD(
/Android/data/包名/files/config.txt),读写都用同一个文件名就闭环了。
场景 C:想让用户在相册、文件管理器里看到文件
那就别搬进 ASD,让它留在共享存储。音频、图片、视频这类媒体文件写到 Shared 的标准目录(如 /Download/、/Pictures/)是允许的。如果是纯文本等非媒体文件想放共享目录,在 Android 10+ 上系统会限制写入——这种需求请回到场景 A + B 的组合:数据放 ASD,需要分享时用信息分享器(Sharing)组件把文件分享出去。
常见错误与排查
file not found,但你明明看得到文件:九成是 Scope 和路径不匹配。App 范围只写文件名(screenshot.jpg),Shared 范围写以/开头的完整路径(/Pictures/xx.jpg)。把 ASD 的文件复制到共享目录时,from 写文件名、to 写/Pictures/...,别反过来。- 报
content://URI 相关错误:你把文件选择器返回的 content URI 直接当路径用了。要么用支持 content URI 的组件方法,要么先把这个 URI 指向的文件复制到 ASD 再按文件名操作。 - 权限崩溃:Android 6.0 以上需要运行时申请权限,用 Screen 的请求权限;但走 ASD + Shared 媒体文件的正规路线,通常根本不需要存储权限。出现权限弹窗崩溃时先检查是不是在 Legacy 思路上硬写公共目录。
- 卸载重装后文件没了:文件放在 ASD 里,卸载即删,这是设计行为。用户的重要数据要么存微数据库 / SQLite(同样在 ASD,但至少别指望它跨卸载),要么导出到共享目录。
- 想读别的 App 私有目录里的文件:做不到,系统限制,别再试了。用 SAF 文件选择器让用户自己挑。
小结
记住三个口诀:App 范围只写文件名;Shared 范围路径以 / 开头;Legacy 只留给 Android 10 以下的老设备。 搞清这三个范围,从 Kodular/Thunkable 迁移过来的文件存储问题基本都能在原生组件内解决,不需要付费扩展。
文件管理器各方法、作用域属性的完整中文说明见组件中文文档「文件管理器」,配套的下载组件、信息分享器文档也在同一个组件索引里。
扫码添加客服咨询