Flutter集成Rive包时出现:rive_common:externalNativeBuildDebug构建错误

一、处理CMAKE链接错误（librive_text.so链接失败） #

• 彻底清理构建缓存：

  flutter clean
  rm -rf android/.gradle android/app/build
  flutter pub get
  

  清理后重新构建，多数缓存冲突导致的链接错误可解决。
• 指定匹配的NDK版本：
  在android/build.gradle的android代码块中添加Rive官方推荐的NDK版本（如25.2.9519653）：

  android {
      ndkVersion "25.2.9519653"
      // 其他配置项...
  }
  

• 检查CMake与minSdk配置：
  确保android/app/build.gradle中minSdkVersion不低于21（Rive最低要求），同时配置CMake的STL类型：

  defaultConfig {
      minSdkVersion 21
      externalNativeBuild {
          cmake {
              arguments "-DANDROID_STL=c++_shared"
          }
      }
  }
  

• 手动指定clang路径：
  若系统clang路径异常，在local.properties中添加clang的绝对路径（根据你的系统和NDK版本调整）：

  clang.path=/Users/你的用户名/Library/Android/sdk/ndk/25.2.9519653/toolchains/llvm/prebuilt/darwin-x86_64/bin/clang++
  

二、解决USB连接正常、断开后无法运行的问题 #

• 测试Release构建：
  断开USB后可能默认运行Release包，手动构建并安装测试：

  flutter build apk --release
  adb install build/app/outputs/apk/release/app-release.apk
  

• 检查Release模式权限：
  确认AndroidManifest.xml中添加必要权限（如Rive加载网络资源需INTERNET权限）：

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

• 配置Release签名：
  未签名的Release包无法正常运行，在android/app/build.gradle中完善签名配置：

  signingConfigs {
      release {
          keyAlias '你的密钥别名'
          keyPassword '你的密钥密码'
          storeFile file('你的密钥库文件.jks')
          storePassword '你的密钥库密码'
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 其他配置项...
      }
  }
  

三、获取详细构建日志 #

Flutter run不支持--stacktrace和--info，可通过以下方式获取完整错误信息：

• 在Android目录下直接执行Gradle命令：

  cd android
  ./gradlew assembleDebug --stacktrace --info
  

• 使用Flutter verbose构建模式：

  flutter build apk --debug --verbose
  

内容的提问来源于stack exchange，提问作者Arjun Malhotra