使用ZegoCloud预构建UI Kit时Flutter APK启动崩溃求助

• 权限配置缺失
  ZegoCloud依赖相机、麦克风、网络等权限，务必在android/app/src/main/AndroidManifest.xml中添加以下权限声明：

  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  

  同时要确保在应用启动后动态申请权限，预构建UI Kit不会自动处理权限，需要先获取权限再初始化SDK。

• 混淆规则未配置
  Release打包时的代码混淆会破坏ZegoCloud的核心逻辑，在android/app/proguard-rules.pro中添加混淆白名单：

  -keep class im.zego.**{*;}
  -keep class com.zego.**{*;}
  

  并在android/app/build.gradle的release构建类型中确认混淆配置生效：

  buildTypes {
      release {
          // 确保签名配置正确
          signingConfig signingConfigs.release
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

• 版本兼容性问题
  检查Flutter SDK版本与ZegoCloud UI Kit的版本是否匹配，部分旧版ZegoKit可能无法兼容最新Flutter版本。建议查看pub.dev上对应Zego包的版本说明，升级或降级到适配的版本组合。

• 通过崩溃日志定位问题
  用adb命令抓取崩溃日志，这是最有效的排查方式：

  adb logcat *:E
  

  或者在Android Studio的Logcat面板中筛选Error级别日志，找到具体的异常栈信息，比如类找不到、初始化失败等，再针对性解决。

• 初始化时机错误
  避免在main函数中过早初始化ZegoCloud SDK，建议在首页的initState方法中完成初始化，确保Flutter上下文已完全加载。

• 签名信息不匹配
  ZegoCloud部分功能需要验证应用签名，确保Release包的签名SHA1值已在ZegoCloud控制台配置正确，且打包时使用的签名文件与配置一致。

内容的提问来源于stack exchange，提问作者Gagan Deep Narang