App Inventor WebViewer 显示动态生成的 HTML 白屏?真机与网页版差异一次讲清

« 返回首页

问题背景

不少从 Thunkable、Kodular 迁移过来的开发者都踩过同一个坑:应用在积木里动态拼接出一段 HTML(比如根据用户数据算出来的表格),把它塞给 Web 浏览器(WebViewer)显示。在网页版、在线预览、甚至把 HTML 粘贴到 Chrome 里都一切正常,可一旦装到真机或导出 APK,WebViewer 就是一片白屏。

一个典型场景:App 内计算胰岛素剂量,动态生成带数值的 HTML 表格——因为数值是运行时算出来的,不可能提前把 HTML 做成素材文件打包进项目。这类需求在网页版好好的,到了 APK 上就白屏,非常让人怀疑人生。

本文把网页版和 APK 的加载路径差异讲清楚,并给出在真机上稳定可用的做法。

环境

  • App Inventor 2(含 MIT 官方版及中文修改版,逻辑通用)
  • 测试环境:网页预览 / AI 伴侣实时调试 / 编译后的 APK
  • 涉及组件:Web 浏览器(WebViewer)、文件管理器(File)

原因分析:同一个 WebViewer,三种环境三种路径

WebViewer 本质是系统 WebView 加载一个 URL。三种环境下,”URL 能不能被解析”完全不同:

1. 网页预览 / 在线版

WebViewer 运行在浏览器 iframe 里,data: 这类内联内容、相对路径都能被浏览器直接消化,所以看起来”一切正常”。这恰恰说明 HTML 本身没问题——问题出在加载方式上。

2. AI 伴侣(实时调试)

伴侣 App 走的是自己的资源路径,和编译后的 APK 不一样。你在网上抄来的 file:///android_asset/xxx.html 写法,很多时候只在 APK 里成立,在伴侣里就是白屏(或反过来)。

3. 编译后的 APK

APK 内打包素材位于 file:///android_asset/ 下;而运行时用文件管理器写出的文件,位于应用的数据目录。动态生成的 HTML 没有对应的 URL,WebView 根本无处可加载——如果你直接把 HTML 字符串当 URL 传给 WebViewer,或者依赖一个真机上不存在的路径,结果就是白屏。

一句话总结:不是设备安全限制挡住了你,而是你没给真机上的 WebView 一个真实存在的、可读的文件 URL。

完整步骤:动态 HTML 的正确加载方式

思路很简单,三步:

  1. 在积木里把 HTML 拼成完整字符串;
  2. 用文件管理器的保存文件写到应用数据目录;
  3. 等文件存储完毕事件回来后,再用 file:// 路径让 WebViewer 加载。

积木逻辑如下(可直接照抄):

global 剂量列表 = []

when Screen1.Initialize() {
  剂量列表 = [6.2, 7.8, 5.4]
  生成并显示()
}

procedure 生成并显示() {
  var html = "<html><body><h3>今日剂量记录</h3><table border='1' cellpadding='6'>"
  var i = 1
  while i <= length(剂量列表) {
    html = join(html, "<tr><td>第 ", i, " 次</td><td>", 剂量列表[i], "</td></tr>")
    i = i + 1
  }
  html = join(html, "</table></body></html>")
  文件管理器1.SaveFile(html, "report.html")
}

when 文件管理器1.AfterFileSaved(文件名) {
  Web浏览器1.GoToUrl(join("file://", 文件名))
}

几个关键点:

  • 必须等文件存储完毕。写文件是异步的,拼完 HTML 立刻调访问网址,文件还没落盘,照样白屏——这是最常见的”我明明照做了还是白屏”的原因。
  • 文件存储完毕事件的参数文件名是完整路径,前面拼上 file:// 即可,不要自己再去猜 /storage/emulated/0/... 这种绝对路径。
  • HTML 字符串里的属性值用单引号(border='1'),避免和外层字符串的双引号冲突。
  • 每次内容变化,重新执行”生成并显示”过程即可,WebViewer 会重新加载。

如果是打包进项目的静态 HTML

若 HTML 是固定的(只是里面引用了 CSS/JS 素材),不需要文件管理器,直接把素材上传到 Media,然后用相对文件名:

when Screen1.Initialize() {
  Web浏览器1.HomeUrl = "page.html"
}

相对文件名是关键:App Inventor 会在伴侣里解析到伴侣的资源路径、在 APK 里解析到 file:///android_asset/page.html,两种环境都正确。硬编码 file:///android_asset/ 前缀,往往就是”伴侣白屏但 APK 正常”或相反的元凶。

data URI 方案为什么不推荐

理论上可以 Web浏览器1.GoToUrl(join("data:text/html;charset=utf-8,", html)),在部分设备上有效。但 HTML 较长时容易超出长度限制,特殊字符还需编码,不同 WebView 版本表现不一——”网页版正常、真机白屏”的怪象很多就是它贡献的。真机方案请优先用上面的写文件法。

常见错误与排查

现象 原因 解决
拼完 HTML 立即加载,白屏 没等文件写完 加载逻辑放进文件存储完毕事件
伴侣正常,APK 白屏(或反之) 硬编码了某个环境的绝对路径 改用相对文件名让系统自动解析,或用事件返回的完整路径
HTML 显示了但图片空白 相对路径引用的图片和 HTML 不在同一目录 图片也用文件管理器写到同一目录,或改用网络图片
部分手机白屏 HTML 字符串里混入了未转义的引号或换行 属性用单引号;确保字符串一行写完
文件名含中文时报错 某些 WebView 对非 ASCII 路径处理不稳 文件名用英文
file:///storage/... 提示权限拒绝 自己拼了绝对路径,且指向了应用沙盒外的位置 相信文件存储完毕给的路径,不要手拼

另外提一句排查利器:拿到一个别人的 .aia 想看看它 WebViewer 里到底写了什么路径,可以用站内的 aia 在线查看器直接翻出每块积木,不用导入项目。

小结

  1. 网页版能显示 ≠ 真机能显示,差异在于 WebView 拿到的 URL 是否真实存在;
  2. 动态生成的 HTML 在真机上的标准做法是:拼字符串 → 保存文件 → 在文件存储完毕事件里用 file:// + 返回的完整路径加载;
  3. 静态 HTML 用相对文件名作为首页地址,伴侣和 APK 通吃;
  4. 别用 data URI 硬扛,别手拼 /storage/... 绝对路径。

按这个流程改一遍,”网页正常、真机白屏”基本就绝迹了。

文档反馈