Flutter 构建失败：namespace未指定解决方案

问题描述

运行 Flutter 项目时出现以下构建错误：

FAILURE: Build failed with an exception.
* What went wrong:
A problem occurred configuring project ':wakelock'.
> Could not create an instance of type com.android.build.api.variant.impl.LibraryVariantBuilderImpl.
   > Namespace not specified. Please specify a namespace in the module's build.gradle file

关键特征：

• 发生在配置 Android 子模块时（如 :wakelock）
• 即使主模块的 build.gradle 已声明 namespace 仍报错
• 通常出现在更新 AGP（Android Gradle Plugin）至 8.0+ 或重装开发环境后

根本原因

第三方库未适配新版 AGP 要求（Android Gradle Plugin 8+），其 namespace 未在库的构建脚本中声明

---

最佳解决方案：强制所有依赖设置 namespace

核心思路

在项目级构建脚本中强制为所有子模块（包括第三方库）配置 namespace

步骤

1. 打开项目级构建脚本文件（非 app 模块）:
   android/build.gradle（或 build.gradle.kts 若使用 Kotlin DSL）

2. 在 allprojects 块内添加如下配置：

allprojects {
    repositories {
        google()
        mavenCentral()
    }
    // 新增 subprojects 配置
    subprojects {
        afterEvaluate { project ->
            if (project.hasProperty('android')) {
                project.android {
                    if (namespace == null) {
                        namespace project.group // 自动为库分配命名空间
                    }
                }
            }
        }
    }
}

Kotlin DSL 用户 (build.gradle.kts)

allprojects {
    repositories {
        google()
        mavenCentral()
    }
    // Kotlin DSL 配置
    subprojects {
        afterEvaluate {
            if (plugins.hasPlugin("com.android.library")) {
                extensions.configure<com.android.build.gradle.LibraryExtension>("android") {
                    if (namespace == null) {
                        namespace = group.toString()
                    }
                }
            }
        }
    }
}

3. 重建项目：

flutter clean  # 清除构建缓存
flutter run    # 重新运行项目

位置要求

确保 subprojects 块直接置于 allprojects 内，且在其他 subprojects 配置之前

---

补充验证与调整

1. 排查过时依赖（如 wakelock）

若报错涉及特定库（如 :wakelock），替换为适配 AGP 8+ 的新版：

# 在 pubspec.yaml 中替换
dependencies:
  wakelock_plus: ^5.0.0 # 替代弃用的 wakelock

2. 检查 AndroidManifest.xml

确保模块的 AndroidManifest.xml 包含必要声明：

<!-- 添加 tools 命名空间（通常位于 app/src/main 目录） -->
<manifest 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"> 
</manifest>

3. 降级 AGP 版本（备选）

若问题仍存，可在 gradle-wrapper.properties 中降级：

# android/gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip

并同步修改项目级设置：

// android/build.gradle
plugins {
    id "com.android.application" version "7.3.0" apply false
}

---

核心原理

AGP 8 开始强制要求：

1. 每个模块需显式声明 namespace
2. 主模块声明对库模块无影响
3. 传统 package 属性（在 AndroidManifest 中）需迁移至 namespace

技术背景

LibraryVariantBuilderImpl 是 AGP 用于处理库模块的类，缺乏 namespace 会导致其初始化失败

---

结论排查流程