首次按架构拆分多APK遇Gradle错误：dimension()方法未找到，求指导

嘿，我来帮你搞定这两个问题！首先，AndroidPdfViewer确实会引入不少架构相关的SO文件，导致APK体积膨胀，按架构拆分多APK是个很好的解决方案；而你遇到的dimension()方法找不到的错误，其实是Gradle配置的问题，和gradle-wrapper.properties的配置有一定关联，但不是“添加特定配置”，而是要确保Gradle和Android Gradle Plugin（AGP）版本匹配，同时正确配置Flavor维度。

一、先解决Gradle 'dimension()'方法找不到的问题 #

这个错误的核心原因是：dimension()方法是AGP 3.0.0及以上版本才引入的Flavor维度配置方法，要么你的AGP版本太低，要么你没先定义全局的Flavor维度就直接用了dimension()。

1. 确保Gradle和AGP版本匹配 #

不需要给gradle-wrapper.properties添加特殊配置，但需要升级Gradle版本到和AGP匹配的范围（比如AGP 7.x对应Gradle 7.x）：
打开根目录下的gradle-wrapper.properties，修改distributionUrl为对应版本，比如：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

2. 更新项目级build.gradle的AGP版本 #

打开根目录下的build.gradle，在buildscript的dependencies中升级AGP版本到3.0.0以上的稳定版，比如：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // 用最新稳定版，比如7.4.2，和上面的Gradle 7.5匹配
        classpath "com.android.tools.build:gradle:7.4.2"
        // 其他依赖（如Kotlin插件）保持对应版本
    }
}

3. 正确配置App级build.gradle的Flavor维度 #

打开app模块下的build.gradle，必须先定义全局的flavorDimensions，再在Product Flavors中使用dimension()：

android {
    // 其他基础配置（compileSdk、defaultConfig等）...

    // 第一步：定义Flavor维度，比如我们用"abi"作为架构维度
    flavorDimensions "abi"

    // 第二步：定义不同架构的Product Flavor，每个都指定对应的维度
    productFlavors {
        armv7 {
            dimension "abi"
            ndk {
                abiFilters "armeabi-v7a"
            }
        }
        arm64 {
            dimension "abi"
            ndk {
                abiFilters "arm64-v8a"
            }
        }
        x86 {
            dimension "abi"
            ndk {
                abiFilters "x86"
            }
        }
        x86_64 {
            dimension "abi"
            ndk {
                abiFilters "x86_64"
            }
        }
    }

    // 第三步：开启多APK生成，只保留对应架构的SO文件
    splits {
        abi {
            enable true
            reset()
            include "armeabi-v7a", "arm64-v8a", "x86", "x86_64"
            universalApk false // 关闭通用APK生成，进一步减小体积
        }
    }
}

二、验证效果 #

配置完成后，执行./gradlew assembleRelease（Windows用gradlew.bat assembleRelease），就能在app/build/outputs/apk/下看到对应架构的APK文件，每个APK的体积会比原来的通用APK小很多，因为只包含对应架构的SO文件。

额外提示 #

如果你不想用Product Flavors，也可以直接用splits.abi来拆分APK，这种方式不需要配置flavorDimensions和dimension()，配置更简单：

android {
    // 其他配置...
    splits {
        abi {
            enable true
            reset()
            include "armeabi-v7a", "arm64-v8a", "x86", "x86_64"
            universalApk false
        }
    }
}

这种方式同样能生成按架构拆分的多APK，也能解决体积问题，而且不会触发dimension()的错误。

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