Android平台Moodle移动应用启动页卡顿问题排查求助

问题概况 #

Android版本构建后卡在启动页无法正常运行，测试GitHub最新及多个历史版本均存在该问题。已确认应用兼容最新版Moodle，Android Studio编译无错误，尝试过不同Android版本、模拟器与真机，网络连接正常。控制台日志显示：

CordovaWebViewImpl    -   D  onPageDidNavigate(--domain--)
PluginManager         -   D  postMessage: onPageStarted
CordovaWebViewImpl    -   D  onPageFinished(--domain--)
PluginManager         -   D  postMessage: onPageFinished
chromium              -   I  [INFO:CONSOLE(4755)] "Page is missing a drawer region", source: --domain--lib/requirejs.php/1697804096/core/first.js (4755)
2023-11-07 15:39:13.009 27526-27526 chromium              -   I  [INFO:CONSOLE(4755)] "Page is missing a drawer toggle link", source: --domain--lib/requirejs.php/1697804096/core/first.js (4755)
2023-11-07 15:39:13.010 27526-27526 chromium              -   I  [INFO:CONSOLE(1089)] "Starting Moodle session timeout warning.", source: --domain--lib/requirejs.php/1697804096/core/first.js (1089)

排查与解决步骤 #

1. 检查Moodle站点主题的移动端兼容性 #

日志中的抽屉区域/切换按钮缺失警告，是核心线索：

• 登录Moodle后台，进入站点管理→外观→主题，确认当前使用的主题（如官方Boost主题）原生支持移动端布局。
• 若用自定义主题，检查主题的layout模板文件，确保包含$OUTPUT->drawer()（抽屉区域）和$OUTPUT->navbar_trigger()（抽屉切换按钮）的渲染代码。

2. 验证应用与Moodle站点的通信配置 #

• 进入Moodle后台站点管理→移动应用→移动应用设置，确认已正确添加Android应用的包名和签名哈希值。
• 检查应用config.xml文件，确保域名权限配置正确：

<access origin="https://你的Moodle域名/*" />
<allow-navigation href="https://你的Moodle域名/*" />

3. 清理缓存与重建项目 #

• 在Android Studio执行Build→Clean Project+Build→Rebuild Project，清除编译缓存。
• 卸载设备上的应用，重启设备后重新安装，清除WebView残留缓存。

4. 排查Moodle站点自身的资源加载问题 #

• 用手机浏览器直接访问Moodle站点的移动端页面，若同样无法显示抽屉菜单，说明问题出在站点端而非应用端。
• 进入Moodle后台站点管理→开发→清除缓存，清理站点所有缓存后重新测试。

5. 开启WebView调试深挖细节 #

• 在Android Studio的Logcat中过滤chromium标签，查看是否有未捕获的JS错误或资源加载失败日志。
• 启用WebView调试模式，添加以下代码后，用Chrome的chrome://inspect工具连接设备，查看WebView控制台和网络请求：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

内容的提问来源于stack exchange，提问作者Yasir UGRAK