Gradle 相关问题解决记录 & 疑难杂症记录
-
-
- 双清解决一大部分问题
- 小知识&&参考
- 疑难杂症
-
- 解决在Java7的项目引用了Java8的第三方库:
- 第三方依赖冲突
- 多种风味,设置默认打包渠道,否则可能会导致打不进去包
- 接入三方aar,或者遇到 java.lang.NoClassDefFoundError 问题
- Unable To Merge Dex
- Failed to execute aapt
- module层级依赖,遇到风味(productFlavors )缺失的问题
- library中有某个demension维度,但是app中没有
- 集成第三方SDK android.arch.core.util.Funtion缺少
- Android Studio 3.6以上版本关闭gradle离线版本
- No resource found that matches the given name: attr 'colorPrimaryDark'.
- 强制刷新gradle依赖&& 发布到Maven
- AndroidManifest 读取纯数字meta值错误
- java.lang.AbstractMethodError: org.jetbrains.plugins.gradle.tooling.util.ModuleComponentIdentifierIm
- 打包打不进so库
- Application需要继承不同的SDK基类
- Android X 转移开启的Jetifier导致编译缓慢
- 新版本AS gradle JDK需要依赖Java11
- 新版AS debug gradle插件
- Android studio Installed Build Tools revision 31.0.0 is corrupted. Remove and install again
- JDK版本错误JAXBException或unrecognized Attribute name MODULE
- dex 分包,方法数超过65536
- java kotlin混编模块居然找不到java类引用?
- 升级gradle版本及build tools导致could not find the AndroidManifest.xml file, using generation folder
- 开启混淆:java.io.IOException: Please correct the above warnings first.
- 升级三方库crash java.lang.NoSuchMethodError: No static method metafactory
-
双清解决一大部分问题
- 遇到奇怪的问题先clean 删除build文件夹等清除缓存操作!!
- .gradle .idea build等目录文件
- 实在不行试试删除C盘User目录下的.gradle文件夹
小知识&&参考
查看 module依赖树
gradlew :modulename:dependencies
查看gradle task时间和性能分析
- 使用gradle profile输出性能报告
示例:gradlew AssembleDebug --profile,会在build/reports/profile生出相应的时间统计数据
- 在task插入时间戳
import java.time.*
gradle.taskGraph.beforeTask {
Task task ->
task.ext.setProperty("startTime", Instant.now())
}
gradle.taskGraph.afterTask {
Task task, TaskState state ->
println task.name + " took " + Duration.between(task.ext.startTime, Instant.now()).toMillis() + " millis"
}
build.gradle 配置manifest占位符值
在BuildConfig文件 生成对应的变量:buildConfigField “boolean”, “LOG_DEBUG”, “true”
在manifest文件的占位符 manifestPlaceholders = [UMENG_CHANNEL_VALUE: “xxx”]
获取AndroidManifest文件的值
/**
* 不同的类型要区别获取,以下是String类型的
* @param context 上下午
* @param metaName meta-data定义的名字
* @param defaultValue 默认值
* @return
*/
public static String getAppMetaDataString(Context context, String metaName, String defaultValue) {
try {
//application标签下用getApplicationinfo,如果是activity下的用getActivityInfo
//Sting类型的用getString,Boolean类型的getBoolean,其他具体看api
String value = context.getPackageManager()
.getApplicationInfo(context.getPackageName(), PackageManager.GET_META_DATA)
.metaData.getString(metaName, defaultValue);
return value;
} catch (PackageManager.NameNotFoundException e) {
e.printStackTrace();
return defaultValue;
}
}
排除不需要的变体
variantFilter {
variant ->
def names = variant.flavors*.name
def types = variant.buildType.name
if (names.contains("abi") && types == "debug") {
// Gradle ignores any variants that satisfy the conditions above.
setIgnore(true)
}
}
迁移至AndroidX
最近把测试项目迁移到了androidX 发现现在迁移已经很方便了,特别是不用手动去解决第三方依赖库
修改gradle.properties文件
- Refactor - migrate to android x
android.useAndroidX=true // 使用Android X
android.enableJetifier=true // 将第三方依赖库也一起迁移到AndroidX!!!
- 然后将一些迁移错误的例如 ConstraintLayout 全局搜索替换一下 根据提示解决冲突就可以了(包名之类的)
附带网上搜的剔除support库依赖方法:未验证但是可以作为参考
implementation('第三方库的依赖') {
exclude group: 'com.android.support' }
推荐参考:AndroidX终极迁移指南
疑难杂症
解决在Java7的项目引用了Java8的第三方库:
- 将工程和模块的JavaVersion设置为 Java7语言
- defalutConfig 里配置 jackOptions{ enable = true}
- 升级至Java8,可能遇到乱七八糟的问题可以通过一起升级gradle版本解决
第三方依赖冲突
- exclude 语法,剔除冲突文件
- 通过删除jar包里面相关的类(直接解压缩删除相关类)
多种风味,设置默认打包渠道,否则可能会导致打不进去包
// gradle 插件3.0后无效
defaultPublishConfig "guestDebug"
publishNonDefault true
接入三方aar,或者遇到 java.lang.NoClassDefFoundError 问题
问题背景:接入的方法数超过65536,开启multidex分包;
解决:
- 网上查询了资料发现5.0以下的系统,分包可能会导致通过library的类分到不同的包找不到,需要配置一下哪些类在主dex;或者配置dexOptions的一个选项:
dexOptions{
preDexLibraries = true
}
- 然后还是不解决,并且我的机子是5.0以上的系统,应该不存在这个问题,检查各类资源文件后发现so库的架构和之前的不一样了,配置相关选项解决(坑了我差不多一个星期)
ndk {
abiFilters 'armeabi'
// abiFilters 'armeabi-v7a'
}
Unable To Merge Dex
- 检查是否第三方aar包与已引入的依赖库冲突,查看日志一般可以看到冲突的类: Multiple dex files define:Lcom.xxx.xxx.xxx
删除相关依赖包或者其他方式解决
- 如果没有提示冲突类,检查依赖aar、jar等是否重复,比如升级SDK忘记删掉老的aar包会报这个错误
- 使用exclude 排除
Failed to execute aapt
报错:
- com.android.ide.common.process.ProcessException Failed to execute aapt…
- …with arguments {package -f --no-crunch -I
- …finished with non-zero exit value 1-3
解决:
- 先检查所需要的资源、库有没有打入,一般是少了某项资源比如supportv4包没有打入
- 检查buildtools 和compileSdkVersion 版本是否对应得上
module层级依赖,遇到风味(productFlavors )缺失的问题
场景: module A 依赖了 moduleB ,B中有许多中风味例如 :flavor1、flavor2,但是A没有,此时会报错
解决方法:
- 给A或者B加上相应的风味,让他们能够匹配到
- 在A的风味中加上 matchingFallbacks
flavorDimensions "default"
productFlavors {
"moduleAFlavor" {
dimension "default" // 每个风味必须制定一个demension维度
...
matchingFallbacks = ['flavor1','flavor2']
}
在BuildType 也可以用相同的方法解决BuildType缺失的问题
library中有某个demension维度,但是app中没有
// In the app's build.gradle file.
android {
defaultConfig{
// 下面这句话告诉gradle,当遇到一个module中有个app中没有的'minApi'维度时,
// 它应该按照下面这个顺序去匹配这个维度的flavors
missingDimensionStrategy 'minApi', 'minApi18', 'minApi23'
// 若其他module中还有更多app中没有的维度,你必须为所有的维度定义回退策略
missingDimensionStrategy 'abi', 'x86', 'arm64'
}
flavorDimensions 'tier'
productFlavors {
free {
dimension 'tier'
// 你可以在一个特定的flavor中覆盖defaultConfig的配置
missingDimensionStrategy 'minApi', 'minApi23', 'minApi18'
}
paid {
}
}
}
集成第三方SDK android.arch.core.util.Funtion缺少
集成小米单机游戏SDK 发现出现这个问题,文档要求集成V4的27.1.1的库,项目使用了26.1.0,出现这个问题 升级库即可,一般是使用的support版本不匹配
Android Studio 3.6以上版本关闭gradle离线版本
加完库依赖发现报错,原来是开启了离线模式,找了下设置居然没找到关掉离线模式的开关,搜了下发现移动到右侧gradle这边了
No resource found that matches the given name: attr ‘colorPrimaryDark’.
发现这个是这个SDK引用到了 AppCompat库的东西,而文档未告知,所以Theme.AppCompat.Light.DarkActionBar相关主题就报错了,引入com.android.support:appcompat-v7:27.1.1 后解决(具体版本号根据项目而定)
强制刷新gradle依赖&& 发布到Maven
- Windows:
gradlew build --refresh-dependencies
gradle build --refresh-dependencies- Mac:
./gradlew build --refresh-dependencies
- 发布到Maven私服
- 第三方工具
AndroidManifest 读取纯数字meta值错误
最近接入小米SDK的时候appkey 和 appid 都是纯数字,最后发现取值的时候被解析成int类型导致取不到值,其实应该是一个string类型的key;解决方法:
在需要被当成string类型的纯数字参数加一个斜杆: / ;
比如数值 1234567890,需要写成 /1234567890
java.lang.AbstractMethodError: org.jetbrains.plugins.gradle.tooling.util.ModuleComponentIdentifierIm
Android Studio 版本太低 尝试用高版本打开
打包打不进so库
这个问题比较奇葩,查看日志发现压缩so库资源的task被跳过了,在so库路径设置正确的情况下:
- 设置NDK环境
- 检查自己的gradle脚本 是否跳过了此任务(例如含debug字段)
Application需要继承不同的SDK基类
- 动态修改application继承
- 区分多风味
- 改他们的SDK,迁移他们的逻辑(不推荐)
Android X 转移开启的Jetifier导致编译缓慢
推荐参考解决:再见,Jetifier
新版本AS gradle JDK需要依赖Java11
新版AS debug gradle插件
直接这样执行,原先监听端口方式无效
Android studio Installed Build Tools revision 31.0.0 is corrupted. Remove and install again
- 出现原因:高版本AS下载的SDK在低版本的AS上面使用(新版不兼容)
- 解决方案:将 SDK路径\build-tools\31.0.0(SDK版本),目录下的
d8.bat
、d8.jar
改为/复制 一个为dx.bat
、dx.jar
(\lib 目录下) - 参考
JDK版本错误JAXBException或unrecognized Attribute name MODULE
- 背景:一般出现其中一个,只要切换JDK版本即可,但是在改老项目的时候发现改了一个错误就报另一个错误
- 原因:查找后发现是打开了DataBinding影响的,查找资料后发现是因为DataBinding 需要的build tools版本为4.0以上,升级版本即可解决
dex 分包,方法数超过65536
- 需要开启dex分包,参考
java kotlin混编模块居然找不到java类引用?
- 发现模块引用正常,打包出来的aar居然没有kotlin的类,检查后发现没有带上kotlin插件,带上就好了
plugins {
id 'com.android.library'
id 'org.jetbrains.kotlin.android'
}
升级gradle版本及build tools导致could not find the AndroidManifest.xml file, using generation folder
老项目找不到AndroidManifest文件导致编译不过,添加以下配置即可
defaultConfig {
javaCompileOptions {
annotationProcessorOptions {
arguments = [
"androidManifestFile": "$projectDir/src/main/AndroidManifest.xml".toString()
]
}
}
}
开启混淆:java.io.IOException: Please correct the above warnings first.
What went wrong:
Execution failed for task ':android_sdk:proguardJar'.
> java.io.IOException: Please correct the above warnings first.
- 报出的警告太多
- 根据提示解决警告
- 忽略或者直接不混淆一些错误比较多的非关键类
# proguard-rules.pro 文件
#不警告编译过程中的警告:Please correct the above warnings first
#-dontwarn com.mobile.emm.**
升级三方库crash java.lang.NoSuchMethodError: No static method metafactory
三方库使用了lambda表达式,但是当前sdk的编译版本依然是JDK7 ,需要将当前SDK module以及app module改为JDK8
android {
...
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
...
}