Android Studio生成aar包全流程与优化实践

1. Android Studio中aar包生成全流程解析在Android开发中模块化是提升工程可维护性的重要手段。aar(Android Archive)作为Android特有的二进制分发格式相比jar包能包含资源文件、Manifest等Android特有元素。最近在重构一个电商App时我将用户中心模块独立为aar团队协作效率提升了40%。下面分享从创建到发布的完整实践。关键认知aar不同于jar它专为Android设计可以包含res资源、assets、JNI库和ProGuard规则是组件化的理想载体。1.1 基础环境准备确保你的Android Studio版本在2022.3.1以上通过Help About查看。我在Windows 11和macOS Ventura双环境测试过以下流程。Gradle版本建议使用8.0以上对应AGP(Android Gradle Plugin)7.4.0这是2023年主流稳定组合。检查gradle-wrapper.propertiesdistributionUrlhttps\://services.gradle.org/distributions/gradle-8.0-bin.zip国内开发者建议配置镜像源加速。修改项目根目录的build.gradlebuildscript { repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } // 其他仓库... } }1.2 模块化工程结构设计典型的多模块项目结构如下project-root/ ├── app/ # 主应用模块 ├── library-aar/ # 要打包的库模块 ├── build.gradle # 项目级配置 └── settings.gradle在Android Studio中新建Android Library模块File New New Module选择Android Library模板命名规范建议功能名 -library如usercenter-library2. Gradle配置深度优化2.1 基础配置要点库模块的build.gradle需要特别注意以下配置plugins { id com.android.library // 关键区别于应用的com.android.application id org.jetbrains.kotlin.android } android { namespace com.example.mylibrary compileSdk 33 defaultConfig { minSdk 24 targetSdk 33 versionCode 1 versionName 1.0 // 配置consumerProguardFiles consumerProguardFiles consumer-rules.pro } buildTypes { release { minifyEnabled true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt), proguard-rules.pro } } } dependencies { // 声明为api还是implementation取决于是否要暴露依赖 api com.squareup.retrofit2:retrofit:2.9.0 implementation androidx.core:core-ktx:1.9.0 }避坑指南consumerProguardFiles的作用是当主工程使用该aar时这些ProGuard规则会自动应用。我曾因漏配导致release包方法数超标。2.2 高级发布配置如需发布到Maven仓库添加maven-publish插件plugins { id maven-publish } afterEvaluate { publishing { publications { release(MavenPublication) { from components.release groupId com.example artifactId mylibrary version 1.0.0 } } } }配置签名信息可选android { signingConfigs { release { storeFile file(keystore.jks) storePassword System.getenv(STORE_PASSWORD) keyAlias System.getenv(KEY_ALIAS) keyPassword System.getenv(KEY_PASSWORD) } } buildTypes { release { signingConfig signingConfigs.release } } }3. 构建与测试全流程3.1 本地构建命令在Terminal执行# 构建debug版本 ./gradlew :library-aar:assembleDebug # 构建release版本含代码混淆 ./gradlew :library-aar:assembleRelease生成的aar文件路径library-aar/build/outputs/aar/library-aar-release.aar3.2 本地测试方案测试aar包的三种方式直接文件引用快速验证 在主模块build.gradle中添加dependencies { implementation files(libs/library-aar-release.aar) }模块依赖开发阶段推荐dependencies { implementation project(:library-aar) }Maven本地仓库模拟远程./gradlew publishToMavenLocal然后引用dependencies { implementation com.example:mylibrary:1.0.0 }3.3 兼容性测试要点测试时需要特别关注资源ID冲突使用前缀避免resources attr namemylib_theme formatreference / /resources多DEX处理minSdk21时第三方库版本冲突使用exclude或强制版本implementation(com.example:lib) { exclude group: com.google.code.gson, module: gson }4. 发布与集成实战4.1 发布到私有Maven仓库以Nexus为例的完整配置publishing { repositories { maven { url http://nexus.example.com/repository/maven-releases/ credentials { username System.getenv(NEXUS_USERNAME) password System.getenv(NEXUS_PASSWORD) } } } }执行发布命令./gradlew clean build publish4.2 主工程集成规范推荐版本管理方式在项目根目录创建versions.gradleext { mylibraryVersion 1.0.0 }主工程引用dependencies { implementation com.example:mylibrary:$mylibraryVersion }4.3 版本更新策略遵循语义化版本(SemVer)MAJOR不兼容的API修改MINOR向下兼容的功能新增PATCH向下兼容的问题修正建议配合Git Tag自动化发布git tag -a v1.0.0 -m Release version 1.0.0 git push origin v1.0.05. 高级技巧与问题排查5.1 资源混淆方案为避免资源冲突在库模块的build.gradle中添加android { resourcePrefix mylib_ // 强制资源前缀 }同时建议使用shrinkResourcesbuildTypes { release { shrinkResources true zipAlignEnabled true } }5.2 常见构建问题解决问题1AGP版本不匹配Deprecated Gradle features were used in this build...解决方案升级AGP版本保持与Gradle版本对应。参考官方兼容表 https://developer.android.com/studio/releases/gradle-plugin问题2重复类错误Duplicate class com.google.gson.Gson found in modules jetified-gson-2.8.9...解决方案dependencies { implementation(com.example:lib) { exclude group: com.google.code.gson } }问题3资源合并冲突Error: Duplicate resources解决方案使用resourcePrefix检查Manifest合并规则在application模块添加android { packagingOptions { exclude META-INF/* } }5.3 性能优化建议按需编译对大型库启用按需构建./gradlew :library-aar:assembleRelease -x lint构建缓存在gradle.properties中添加org.gradle.cachingtrue并行构建org.gradle.paralleltrue配置CI缓存缓存$GRADLE_USER_HOME/caches和.gradle目录6. 扩展应用场景6.1 分发SDK的最佳实践当aar作为SDK分发时提供详细的API文档建议用Dokka生成plugins { id org.jetbrains.dokka version 1.8.10 } task dokkaJavadoc(type: org.jetbrains.dokka.gradle.DokkaTask) { outputFormat javadoc outputDirectory $buildDir/javadoc }包含示例工程版本兼容性矩阵如minSdk要求6.2 动态功能模块(DFM)从Android 5.0开始可以通过Play Feature Delivery分发android { dynamicFeatures [:dynamic-feature] }6.3 多风味构建支持不同构建变体android { flavorDimensions environment productFlavors { dev { dimension environment versionNameSuffix -dev } prod { dimension environment } } }生成不同风味的aar./gradlew :library-aar:assembleDevRelease ./gradlew :library-aar:assembleProdRelease在持续集成中我发现配置Gradle缓存目录能显著提升构建速度# 在~/.gradle/gradle.properties中添加 gradle.user.home/path/to/custom/cache