问题背景
不少从 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 的正确加载方式
思路很简单,三步:
积木逻辑如下(可直接照抄):
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 在线查看器直接翻出每块积木,不用导入项目。
小结
- 网页版能显示 ≠ 真机能显示,差异在于 WebView 拿到的 URL 是否真实存在;
- 动态生成的 HTML 在真机上的标准做法是:拼字符串 → 保存文件 → 在文件存储完毕事件里用
file://+ 返回的完整路径加载; - 静态 HTML 用相对文件名作为首页地址,伴侣和 APK 通吃;
- 别用 data URI 硬扛,别手拼
/storage/...绝对路径。
按这个流程改一遍,”网页正常、真机白屏”基本就绝迹了。
扫码添加客服咨询