App Inventor 首次运行建目录失败、第二次才成功?运行时权限的时序问题

« 返回首页

问题背景

一个很典型也很容易被误判的问题:App 里用文件管理器(File)的创建目录创建数据目录,在大多数手机上一直正常,但第一次全新安装运行时,系统弹出存储权限请求,你点了”允许”,结果目录没建成、也没有任何报错;第二次运行(权限已在,不再弹窗)却一切正常。

有开发者描述得很准确:他怀疑”Android 在执行这行时弹出权限请求,授权还没注册完成就执行了这行”。这个直觉完全正确——这是运行时权限的异步时序问题,不只是建目录,所有”需要权限的首次操作”(读文件、定位、蓝牙、相机)都可能踩到。

环境与现象

  • 典型代码:屏幕初始化(Screen1.Initialize)里直接调创建目录
  • 系统:Android 6.0 及以上(都走运行时权限)
  • 现象:
    • 首次安装运行 → 弹权限对话框 → 授权 → 目录创建静默失败
    • 再次运行 → 不弹窗 → 目录创建成功

原因分析

关键在于理解两件事:

1. 权限申请是异步的。 App Inventor 的组件在首次操作需要权限的资源时,会替你自动发起运行时权限请求。弹窗出现时,代码并不会停下来等你点”允许”——请求发出后程序继续往下走。你点”允许”的那几百毫秒里,后面的指令早已带着”未授权”状态执行完了,于是失败,而这类操作失败往往只是不抛错、目录不存在,你根本感知不到。

2. 第二次为什么成功? 权限已经授予,系统直接返回结果、不再弹窗,权限状态在那一刻就是”已授权”,所以同一行代码这次能正常工作。这也解释了为什么这问题在开发机上很少暴露——你反复运行,权限早就给过了。

一句话总结:不是代码写错了,而是把”需要权限的操作”放在了”权限还没确定下来”的时机执行。

正确写法:权限回调后再初始化

标准做法分三步,适用于文件管理器、位置传感器、蓝牙客户端、照相机等一切运行时权限场景:

第一步: 在屏幕初始化里只做一件事——主动请求权限。

第二步: 把所有需要权限的初始化逻辑(建目录、读配置、连蓝牙……)全部放进权限被授予时事件里。这个事件在权限真正到手后才会触发;如果权限早已授予(第二次及以后运行),它会立即触发,不会卡住流程。

第三步: 加一个”已就绪”标志,防止重复初始化。

global 目录已就绪 = false

when Screen1.Initialize() {
  Screen1.AskForPermission("android.permission.WRITE_EXTERNAL_STORAGE")
}

when Screen1.PermissionGranted(权限名称) {
  if not (目录已就绪) {
    文件管理器1.MakeDirectory("App", "我的App数据")
    目录已就绪 = true
  }
}

两个细节:

  • 请求权限只带一个参数(权限名),权限被授予时事件带一个参数(权限名称)。如果你的逻辑要区分不同权限——比如同时申请了存储和定位——可以在事件里用 if 权限名称 = "..." 分支分别初始化。
  • 创建目录有两个参数:作用域和目录名称。作用域传 "App" 表示建在应用专属目录(不需要任何权限,见下文),传其它值才涉及公共目录授权。

需要读文件的话,读取文件本身也是异步的——发起读取后,内容要从获得文本事件里拿,不能在下一行直接用:

when 文件管理器1.GotText(文本) {
  if not (isEmpty(文本)) {
    标签_昵称.Text = 文本
  }
}

这样改完后:首次运行授权 → 回调触发 → 建目录 → 正常;第二次及以后运行 → 回调立即触发 → 同样正常。两个路径走的是同一段代码,不存在”第一次特殊”了。

两个补充要点

1. Android 11+ 可以完全绕开这个权限。 从 Android 11 起,应用专属目录(App 专属存储)不需要任何存储权限。把文件管理器的默认作用域属性设为 App,读写都限制在自己沙箱内,创建目录根本不会触发权限请求,问题从根上消失。只有需要写公共目录(如下载文件夹)时才需要走上面的授权流程。想搞清各作用域对应的真实路径,看这篇分区存储详解。

2. Android 10 及以下的版本差异。 在 Android 10 以下,申请 WRITE_EXTERNAL_STORAGE 时会隐含获得读权限,不用重复申请;Android 10 以上存储策略收紧,优先考虑应用专属目录方案。

常见错误与排查

错误做法 后果
在屏幕初始化里直接调需要权限的操作 首次运行静默失败,权限对话框还没确认就执行了
授权后延迟几秒再重试一次 治标不治本,慢设备上时序仍不可靠
把初始化逻辑散落在多个事件里 权限回调触发时可能重复初始化,记得加”已就绪”标志
在 Android 11+ 上申请 WRITE_EXTERNAL_STORAGE 并写公共目录 很多设备上即使授权也写不进去,改用应用专属目录

排查口诀:“首次失败、二次成功”八成是权限时序;建目录/读文件静默失败,先确认默认作用域和系统版本,再检查是否走了权限被授予时回调。

小结

这个问题的本质是一个通用工程原则:运行时权限的授予是异步事件,任何依赖权限的操作都必须放到授权回调里执行,而不是在申请语句的下一行。 Screen 的权限被授予时事件就是为此设计的。这个模式改一次,以后所有需要权限的功能都有了标准入口,值得沉淀成你自己的项目模板。

文档反馈