<think>我们正在解决Android打包时的manifest合并
错误，特别是与quickstep相关的重复权限声明和versionName属性冲突问题。
根据用户上一次的问题，我们知道quickstep是Android系统编译中的一个参数，用于启用手势导航等特性。但在应用打包过程中，可能会因为引入的库（如quickstep）与主项目的manifest存在冲突。
常见
错误类型：
1
. 重复的<
uses-permission>声明：多个模块声明了相同的权限。
2
. versionName冲突：主模块和库模块在
AndroidManifest.xml中定义了不同的versionName。
解决方案：
一、处理重复权限声明（以QUICKSTEP权限为例）
错误示例：
> Manifest merger failed
: Attribute applic
ation@label value=(@string/app_name) from
AndroidManifest.xml:xx
> is also present
at [com
.android
.launcher
:quickstep]
AndroidManifest.xml:yy
> Suggestion
: add 'tools
:replace="android
:label"' to <applic
ation>
element
或者
> Multiple entries with same key
: android
.permission.xxx
解决方法：
1
. 使用tools
:node="remove"移除重复权限
在项目的
AndroidManifest.xml中，对重复声明的权限使用tools
:node="remove"进行移除。
例如，如果quickstep库声明了某个权限（如android
.permission.B
ATTERY_ST
ATS）而你的应用也声明了，导致重复，可以这样处理：
```
xml
<manifest
... xmlns
:tools="http
://schemas
.android
.com/tools">
<!
-- 移除库中引入的重复权限
-->
<
uses-permission android
:name="android
.permission.B
ATTERY_ST
ATS" tools
:node="remove"/>
...
</manifest>
```
2
. 使用tools
:replace替换冲突属性
如果冲突发生在<applic
ation>标签的属性（如label、icon等），可以在<applic
ation>标签中使用tools
:replace替换。
```
xml
<applic
ation
...
tools
:replace="android
:label, android
:icon"/>
```
二、处理versionName冲突
错误示例：
> All com
.android
.launcher3 libraries must use the exact same version specific
ation (mixing versions can lead to runtime crashes)
解决方法：
1
. 在项目的build
.gradle中统一版本
确保所有引入的com
.android
.launcher3库（如quickstep）使用相同的版本号。
```gradle
dependencies {
implement
ation 'com
.android
.launcher3
:quickstep
:7
.1
.2'
// 其他依赖也使用相同的版本
}
```
2
. 如果主模块和库模块都声明了versionName，可以在主模块的build
.gradle中覆盖版本信息：
```gradle
android {
defaultConfig {
versionName "1
.0
.0" // 统一版本名
versionCode 1
}
}
```
3
. 在
AndroidManifest.xml中使用tools
:overrideLibrary临时覆盖库的minSdkVersion等（但versionName通常不在此列，所以主要靠gradle解决）
三、针对quickstep库的特殊处理
由于quickstep是系统库，有时可能需要排除传递依赖或强制使用同一版本：
```gradle
configur
ations
.all {
resolutionStr
ategy {
force 'com
.android
.launcher3
:launcher
:7
.1
.2'
force 'com
.android
.launcher3
:quickstep
:7
.1
.2'
}
}
```
四、使用manifest merger的日志诊断
在模块的build
.gradle中增加以下配置，查看详细合并日志：
```gradle
android {
applic
ationVariants
.all { variant
->
variant
.outputs
.all {
// 输出合并报告
def outputFile = outputFile
if (outputFile != null && outputFile
.name
.endsWith('
.apk')) {
// 在
构建时生成manifest合并报告
task("process${variant
.name
.capitalize()}Manifest")
.doLast {
def manifestOutputFile = file("${buildDir}/intermedi
ates/merged_manifests/${variant
.name}/
AndroidManifest.xml")
println "Merged manifest written to
: ${manifestOutputFile}"
// 更详细的日志在build/outputs/logs/manifest
-merger
-{variant}
-report
.txt
}
}
}
}
}
```
构建后，在build/outputs/logs/目录下查看详细的合并报告。
五、清理和重建
有时简单的清理重建可以解决临时问题：
- Clean Project
: Build
-> Clean Project
- Rebuild Project
: Build
-> Rebuild Project
总结步骤：
1
. 检查
错误日志，确定冲突的具体权限或属性。
2
. 在
AndroidManifest.xml中使用tools
:node="remove"移除重复权限，或使用tools
:replace替换冲突属性。
3
. 在build
.gradle中统一依赖版本，特别是quickstep相关库。
4
. 使用resolutionStr
ategy强制依赖版本。
5. 查看详细合并日志进行诊断。
6
. 清理并重建项目。
注意：在操作前备份项目，避免误操作。
相关问题：
1
. Android Manifest合并规则有哪些？
2
. 如何解决多个库之间的资源冲突？
3
. Gradle依赖管理中的force和exclude有什么作用？
4
. 如何查看Android Manifest合并的详细报告？</think>### 解决 Android Manifest 合并
错误：QuickStep 重复权限与 versionName 冲突
#### 问题分析
当 Android 项目引入 QuickStep 库（手势导航相关）时，可能因以下原因导致 Manifest 合并
错误：
1
. **重复权限声明**
QuickStep 库的 Manifest 已声明某些权限（如 `B
ATTERY_ST
ATS`），与主项目重复声明
2
. **versionName 冲突**
主项目的 `versionName` 与 QuickStep 库的版本属性冲突
---
#### 解决方案
##### 1
. 处理重复权限声明（以 `B
ATTERY_ST
ATS` 为例）
在 **主项目的
AndroidManifest.xml** 中添加合并工具指令：
```
xml
<manifest
xmlns
:android="http
://schemas
.android
.com/apk/res/android"
xmlns
:tools="http
://schemas
.android
.com/tools"> <!
-- 关键：引入 tools 命名空间
-->
<!
-- 移除库中声明的重复权限
-->
<
uses-permission
android
:name="android
.permission.B
ATTERY_ST
ATS"
tools
:node="remove" /> <!
-- 从最终 Manifest 中删除此权限声明
-->
<!
-- 其他配置
-->
</manifest>
```
**原理**：`tools
:node="remove"` 指示 Gradle 在合并时移除该权限声明[^2]。
##### 2
. 解决 versionName 冲突
在 **app/build
.gradle** 中统一版本控制：
```gradle
android {
defaultConfig {
// 强制覆盖所有库的 versionName
manifestPlaceholders = [versionNameOverride
: "1
.0
.0"]
}
}
```
在 **
AndroidManifest.xml** 中引用该变量：
```
xml
<manifest
...>
<applic
ation
...>
<!
-- 使用占位符统一版本
-->
<meta
-d
ata
android
:name="android
.app
.version"
android
:value="${versionNameOverride}"
tools
:replace="android
:value"/> <!
-- 替换库中的值
-->
</applic
ation>
</manifest>
```
##### 3
. 查看合并日志定位问题
1
. 在 **gradle
.properties** 中启用详细日志：
```properties
android
.verbose=true
```
2
. 构建后检查日志文件：
```
/app/build/outputs/logs/manifest
-merger
-debug
-report
.txt
```
其中会明确标注冲突来源：
```log
CONFLICT
: Duplic
ate
attribute android
:versionName
- Found in
: /app/src/main/
AndroidManifest.xml
- Also found in
: /
.gradle/caches/
.../quickstep
-7
.1
.2/
AndroidManifest.xml
```
---
#### 高级处理技巧
**场景**：需要保留库中的权限但避免冲突
```
xml
<
uses-permission
android
:name="android
.permission.B
ATTERY_ST
ATS"
tools
:remove="android
:maxSdkVersion" /> <!
-- 仅移除冲突属性
-->
```
**强制使用主项目 Manifest 属性**：
```
xml
<applic
ation
tools
:replace="android
:label,android
:icon,android
:versionName">
...
</applic
ation>
```
---
#### 预防措施
1
. **统一依赖版本**：确保所有 QuickStep 相关库版本一致
```gradle
dependencies {
implement
ation 'com
.android
.launcher3
:quickstep
:7
.1
.2'
implement
ation 'com
.android
.launcher3
:launcher
:7
.1
.2' // 必须相同版本
}
```
2
. **检查库的 Manifest**：解压 AAR 文件查看 `
AndroidManifest.xml`：
```bash
unzip quickstep
-7
.1
.2
.aar
-d quickstep
-manifest
```
---
#### 核心概念回顾
| 操作 | 指令 | 作用 |
|
-----------------------|
--------------------------|
----------------------------------|
| 删除整个权限节点 | `tools
:node="remove"` | 完全移除声明 |
| 替换特定属性 | `tools
:replace="
attr"` | 覆盖库中的属性值 |
| 移除特定属性 | `tools
:remove="
attr"` | 删除冲突属性保留其他 |
| 版本占位符 | `manifestPlaceholders` | 动态统一版本信息 |
> ⚠️ 注意：所有 `tools` 指令仅在合并时生效，不会影响编译后的 APK[^2]。
本文介绍了在构建Android项目过程中遇到的权限重复声明问题及解决方法。通过检查AndroidManifest.xml文件，找出并删除重复的权限声明，从而解决了构建错误。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
