Metro服务器无法启动或经常崩溃
原因： 端口冲突、缓存损坏或系统资源限制。 解决方案：-
清除Metro缓存：
-
检查端口冲突并使用其他端口：
-
使用详细日志记录重新启动Metro服务器：
- 如果问题仍然存在，请重新启动开发计算机以清除系统资源。
应用成功构建，但在设备上不可见
原因： 应用在后台运行或存在用户界面渲染问题。 解决方案：-
检查哪个应用当前处于前台：
-
如果您的应用处于后台，请将其置于前台：
-
在后台和前台之间切换以重新刷新：
将应用置于前台后应用仍不可见
原因： Metro服务器有多个应用在运行或用户界面代码错误。一次只能有一个应用使用Metro服务器。 解决方案： 检查是否有多个正在运行的应用：- 在运行Metro服务器的终端中按Ctrl+C以将其关闭。
-
停止应用：
-
重启应用：
- 监控Metro服务器输出中是否存在由不兼容的React Native程序包引起的错误。
- 修复代码中的错误。每次更改后，Metro服务器都会自动重建Bundle。
应用在启动时因JavaScript Bundle错误而崩溃
原因： 系统中的某个JavaScript Bundle导致冲突。您的应用不会出现在设备上或vlcm list输出中。日志显示“Requiring unknown module”（需要未知模块）或“Property __d doesn’t exist”（属性__d不存在）错误。
解决方案：
-
捕获设备日志：
-
使用以下命令之一启动您的应用：
-
如果使用Vega CLI：
-
如果在package.json中使用NPM脚本：：
-
如果使用Vega CLI：
-
检查日志流中是否存在错误模式。
以下示例显示了与此问题相关的常见错误：
“Requiring unknown module”错误：
“Property ‘__d’ doesn’t exist”错误：
- 在运行Metro服务器的终端中按Ctrl+C来停止Metro服务器。
-
清除Metro缓存并重新启动：
- 重建并重新启动应用。 如果错误仍然存在，请检查是否存在冲突的系统Bundle。有关详细信息，请参阅由于系统Bundle问题，应用崩溃或显示空白屏幕。
由于系统Bundle问题，应用崩溃或显示空白屏幕
原因： 系统Bundle缺失或配置错误。应用还可能具有替代默认Bundle拆分行为的旧标记。缺少系统Bundle通常意味着，设备上的操作系统版本与用于构建应用的SDK版本不匹配。 解决方案：-
在应用的根目录（主
package.json所在的位置）运行以下命令，以清理缓存并更新依赖项： -
运行以下命令，验证应用是否使用系统Bundle：
-
打开
keplerscript-app-config.json文件。 -
查找
"systemBundles: {"部分。 -
从项目中删除旧的Bundle拆分标记。
如果之前选择过退出Bundle拆分，则项目可能仍包含阻止系统Bundle正常运行的标记。你不需要这些标志。默认情况下，SDK v0.20及更高版本会启用Bundle拆分。
- 在
package.json中，从"kepler"部分中删除useSystemJsBundles。 - 在构建脚本中，从构建命令中删除
--split-bundle false和--use-system-js-bundles。
- 在
- 如果问题仍然存在，请验证设备上的操作系统版本是否与用于构建应用的SDK版本相匹配。如果不匹配，则更新SDK并重建。有关构建说明，请参阅使用Vega Studio构建应用。
设备未运行最新版操作系统，应用启动失败
原因： 设备尚未收到最新的无线 (OTA) 更新，因此其操作系统版本落后于构建应用所用的SDK版本。即使应用能够成功构建，操作系统过时的设备也可能导致系统包丢失、启动失败或运行时行为异常。 Solution:- 检查设备当前的操作系统版本，并将其与用于构建应用的SDK版本进行比较：
- 确保设备已连接互联网，并等待正在进行的更新完成。设备会自动检查OTA更新——更新完成前，请勿关机或重启设备。有关更多信息，请参阅在Vega虚拟设备或Fire TV上运行您的应用。
- 如果设备仍使用旧版操作系统，请在设置 > My Fire TV > About > Check for Updates（检查更新）中检查更新。如果更新仍未推送，请验证设备的网络连接并强制进行手动更新—请参阅Fire TV Stick未收到OTA更新。
- 设备运行当前操作系统版本后，请重新构建并重新部署您的应用：
有关完整的构建和部署步骤，请参阅使用Vega Studio构建应用和运行应用。如果操作系统版本和SDK版本仍不一致，请更新SDK并重新构建。
