uni-app App Bundle 包含原生代码时未上传调试符号文件的建议

在处理uni-app开发的应用中，如果App Bundle包含了原生代码且未上传调试符号文件（通常指.proguard、.map或.dSYM文件等），将会对后续的崩溃分析和问题定位带来极大的不便。为了确保应用上线后的稳定性和可维护性，强烈建议在构建和发布过程中包含调试符号文件。以下是如何在uni-app项目中管理和上传调试符号文件的一些实践示例和代码片段。

1. 配置原生构建脚本

对于Android平台，可以在manifest.json中配置android原生构建选项，确保ProGuard等代码混淆工具生成必要的.proguard和.map文件。例如：

"android": {
  "build": {
    "release": {
      "proguard": true, // 启用ProGuard
      "signingConfig": {
        // 签名配置
      },
      "gradleArgs": {
        "assembleRelease": [
          "-Pandroid.useAndroidX=true",
          "-Pandroid.enableJetifier=true"
        ]
      }
    }
  }
}

在app/src/main/proguard-rules.pro中，可以定义保留哪些类或方法不被混淆，以确保调试信息完整。

2. 收集调试符号文件

构建完成后，调试符号文件通常位于build/outputs/mapping/（Android）或项目构建目录下的特定位置（iOS）。确保这些文件被妥善保存，并与发布的App Bundle一同上传至服务器或版本控制系统。

3. 使用第三方服务上传调试符号

许多第三方崩溃分析服务（如Firebase Crashlytics、Bugsnag等）支持自动或手动上传调试符号文件。以下是一个Firebase Crashlytics的示例，展示如何在Gradle脚本中配置符号文件上传：

android {
  ...
  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      // Firebase Crashlytics 配置
      crashlytics {
        enableNdk true // 如果包含NDK代码
      }
    }
  }
}

// 在app/build.gradle末尾添加任务，上传符号文件
tasks.register("uploadCrashlyticsSymbolFileRelease") {
  doLast {
    com.google.firebase.crashlytics.buildtools.gradle.tasks.UploadSymbolsTask.uploadSymbols(
      project,
      fileTree(dir: "${buildDir}/outputs/mapping/release/").include("*.txt")
    )
  }
}

// 确保在assembleRelease任务后执行
preBuild.dependsOn uploadCrashlyticsSymbolFileRelease

注意：上述Gradle脚本中的preBuild.dependsOn可能需要根据实际情况调整，以避免不必要的重复构建。

通过上述配置，可以确保在构建和发布过程中，调试符号文件被正确生成并上传至相应的服务，从而为后续的崩溃分析和问题定位提供有力支持。