执行Flutter Build APK时遇permission_handler_android构建错误求助

问题描述 #

执行构建命令：

/Users/mac/Downloads/flutter/bin/flutter --no-color build apk

运行Gradle任务assembleRelease时失败，具体报错：

/Users/mac/Desktop/Navigui-project/user-app/build/permission_handler_android/tmp/kotlin-classes/release不存在，任务:permission_handler_android:extractReleaseAnnotations执行失败，内部错误：执行com.android.build.gradle.internal.lint.AndroidLintWorkAction时出现unexpected lint return value -1。

已尝试将compileSdk改为33，但问题未解决。项目pubspec.yml配置如下：

name: booking_system_flutter
description: A new Flutter project.

publish_to: 'none' # Remove this line if you wish to publish to pub.dev
version: 10.10.1

environment:
  sdk: ">=3.0.0 <4.0.0"

dependencies:
  flutter:
    sdk: flutter

  # COMMON
  nb_utils: ^6.1.0
  google_fonts: ^6.1.0
  html: ^0.15.4
  http: ^1.1.0
  intl: ^0.18.1
  cached_network_image: ^3.3.0
  url_launcher: ^6.1.14

  # FIREBASE
  firebase_core: ^2.22.0
  firebase_crashlytics: ^3.4.4
  firebase_auth: ^4.14.0
  firebase_storage: ^11.5.1
  firebase_remote_config: ^4.3.4
  cloud_firestore: ^4.13.1

  # PUSH NOTIFICATION
  onesignal_flutter: ^5.0.4

  # STATE MANAGEMENT
  mobx: ^2.2.1
  flutter_mobx: ^2.2.0

  # ICON
  flutter_vector_icons: ^2.0.0
  flutter_svg: ^2.0.9

  # IMAGE
  image_picker: ^1.0.4
  photo_view: ^0.14.0
  lottie: ^2.7.0

  # OTHER
  country_picker: ^2.0.22
  flutter_custom_tabs: ^1.2.1
  permission_handler: ^11.0.1
  flutter_html: ^3.0.0-alpha.5
  firebase_pagination: ^3.0.0
  webview_flutter: ^4.4.2

  # SOCIAL LOGIN
  google_sign_in: ^6.1.6
  the_apple_sign_in: ^1.1.1

  # PAYMENT GATEWAYS
  phonepe_payment_sdk: ^1.0.3
  crypto: 3.0.3
  qr_flutter: 4.0.0 #required for in pix_flutter
  pix_flutter: ^2.2.0
  razorpay_flutter: ^1.3.5
  flutterwave_standard: ^1.0.8
  flutter_stripe: ^9.4.0
  cinetpay: ^1.0.7
  flutter_paypal_checkout:
    git:
      url: https://github.com/Raj-GMITS/flutter_paypal_checkout.git
      ref: main
      
  flutter_paystack:
    git:
      url: https://github.com/Raj-GMITS/flutter_paystack.git
      ref: master    

  # MAP
  google_maps_flutter: ^2.5.0
  geolocator: ^10.1.0
  geocoding: ^2.1.1

  flutter_localizations:
    sdk: flutter

dev_dependencies:
  flutter_test:
    sdk: flutter
  build_runner: ^2.4.6
  mobx_codegen: ^2.4.0
  #flutter packages pub run build_runner build --delete-conflicting-outputs

flutter:
  uses-material-design: true
  assets:
    - assets/icons/
    - assets/
    - assets/flag/
    - assets/images/
    - assets/icons/upi_payment/
    - assets/lottie/

解决方案 #

1. 清理构建缓存并重新构建 #

执行以下命令彻底清理缓存后重新构建：

flutter clean
rm -rf ~/.gradle/caches
flutter pub get
flutter build apk

缓存文件损坏或残留是这类文件缺失问题的常见原因，清理后重新生成构建文件可有效解决。

2. 升级permission_handler依赖 #

当前使用的permission_handler: ^11.0.1可能存在Lint兼容性问题，尝试升级到最新稳定版：
修改pubspec.yml中的依赖为：

permission_handler: ^11.1.0 # 或更高版本

执行flutter pub get后再次尝试构建。

3. 禁用目标模块的Lint检查 #

如果升级依赖无效，可以临时绕过permission_handler_android模块的Lint检查：
在项目根目录的android/build.gradle中添加以下配置：

subprojects {
    if (project.name == 'permission_handler_android') {
        tasks.withType(com.android.build.gradle.tasks.Lint) {
            enabled = false
        }
    }
}

或者在android/app/build.gradle的android代码块中添加全局Lint配置：

lintOptions {
    checkReleaseBuilds false
    abortOnError false
}

此方法可优先保证构建成功，后续再排查具体Lint规则问题。

4. 检查Gradle版本兼容性 #

确保Gradle版本与Flutter SDK版本匹配：

• 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为适配Flutter 3.x的版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip
  

• 同时在android/build.gradle中确保com.android.tools.build:gradle版本对应，比如：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      // 其他依赖...
  }
  

内容的提问来源于stack exchange，提问作者Ziadi Lotfi