uni-app HBuilderX 真机运行时白屏

在uni-app开发中，遇到HBuilderX真机运行时白屏的问题，通常与多种因素有关，包括但不限于项目配置错误、资源文件缺失、代码错误或者设备兼容性问题。以下是一些可能的排查方向和代码案例，帮助你定位和解决白屏问题。

1. 检查manifest.json配置

确保manifest.json中的app-plus配置正确无误，特别是usingComponents、plugins等部分。

{
  "app-plus": {
    "usingComponents": true,
    "plugins": {
      // 确保插件配置正确
    }
  }
}

2. 检查pages.json页面配置

确认pages.json中所有页面的路径配置正确，没有遗漏或错误。

{
  "pages": [
    {
      "path": "pages/index/index",
      "style": {
        "navigationBarTitleText": "首页"
      }
    },
    // 其他页面配置
  ]
}

3. 检查App生命周期函数

确保在App.vue中的onLaunch、onShow等生命周期函数中没有导致应用崩溃或白屏的代码。

export default {
  onLaunch: function () {
    console.log('App Launch');
    // 初始化代码
  },
  onShow: function () {
    console.log('App Show');
    // 显示时执行的代码
  },
  // 其他生命周期函数
}

4. 检查静态资源加载

确保所有静态资源（如图片、字体等）路径正确，且在真机上可访问。

<template>
  <view>
    <image src="/static/logo.png"></image>
  </view>
</template>

5. 调试和日志输出

在关键代码位置添加console.log输出，以便在真机上通过开发者工具查看日志，定位问题所在。

onLoad() {
  console.log('Page Loaded');
  // 页面加载时的逻辑
}

6. 清理项目并重建

有时候，简单的清理项目并重建可以解决一些莫名其妙的问题。

# 在HBuilderX中，你可以通过“工具”->“清理项目”->“重建项目”来完成这一步

7. 检查设备兼容性

确认你的代码和设备兼容性，特别是在使用特定API或组件时。

如果以上步骤仍未解决问题，建议查看HBuilderX的开发者社区或uni-app的官方文档，寻找是否有其他开发者遇到并解决了类似问题。此外，确保HBuilderX和uni-app框架都是最新版本，以利用最新的功能和修复。