讲师中心 微信公众号
AI工具推荐 视频效率加速

Gradle怎么把Android库打包为AAR

星敏小哥_9292

星敏小哥_9292

发布时间:2026-11-02 13:08:19

|

219人浏览过

|

来源于php中文网

原创

assembleRelease 仅生成 AAR 文件(如 my-sdk-release.aar),不自动包含混淆规则、依赖声明、源码或文档;必须确保模块为 com.android.library 类型、显式配置 consumerProguardFiles 和 maven-publish 的 publications,且正确导出 components['release'] 以保障依赖传递与下游集成可靠性。

gradle怎么把android库打包为aar

assembleRelease 是最直接有效的方式,但光执行这个命令远远不够——它只生成文件,不保证可被正确引用,尤其在跨项目或发布到私服时,容易因配置缺失导致调用方崩溃或依赖丢失。

确认模块类型是 com.android.library

Android 库模块和 App 模块的构建逻辑完全不同,如果 build.gradle 顶部写的是 com.android.application,哪怕你运行 assembleRelease,Gradle 也会报错或静默生成错误产物。

  • 必须确保模块根目录下的 build.gradle(或 build.gradle.kts)以 plugins { id 'com.android.library' } 开头
  • 删掉任何 applicationId 配置,它只属于 App 模块
  • 检查 android { ... } 块里没有 defaultConfig { applicationId "..." },否则构建会失败并提示 “applicationId cannot be set in library”

assembleRelease 能生成什么,又不能生成什么

执行 ./gradlew :my-sdk:assembleRelease 后,你会在 my-sdk/build/outputs/aar/my-sdk-release.aar 得到一个 ZIP 包,里面包含 classes.jar、res/、AndroidManifest.xml 等,但它不包含混淆规则、不包含依赖声明、不包含源码或文档——这些全靠你手动补全。

Android SMS Gateway
Android SMS Gateway

自托管短信服务,使用 Android 手机作为网关提供 HTTP API,支持发送/接收短信,兼容主流短信网关。

下载
  • 混淆规则必须通过 consumerProguardFiles 'consumer-rules.pro' 显式声明,否则引用方开启混淆后,你的公开类会被误删
  • 如果库本身依赖了 okhttp 或其他模块,assembleRelease 不会把它们打进 AAR,也不会在 pom 中声明——这意味着别人依赖你的 AAR 时,得自己再写一遍 implementation 'com.squareup.okhttp3:okhttp:4.12.0'
  • AAR 本身不带 sources.jar 或 javadoc.jar,调试时看不到源码跳转,除非你额外配置 generateSourcesJar 类型的任务

发布到 Artifactory 时,pom 文件比 .aar 还重要

Artifactory 只负责存和发,它不会帮你“猜”这个 AAR 依赖了什么。真正决定依赖能否自动传递的,是同名的 my-sdk-release.aar.pom 文件。如果你用默认 maven-publish,大概率这个 pom 里 <dependencies></dependencies> 是空的,或者 scope 全是 runtime,导致引用方编译通过、运行时报 NoClassDefFoundError。

  • 必须在 publishing { publications { ... } } 中显式调用 from(components['release']),且确保 components['release'] 已正确定义(AGP 8.0+ 默认不暴露 release 组件,需手动创建)
  • 对 api 引入的依赖,pom 中对应为 <scope>compile</scope>;implementation 则应为 <scope>runtime</scope>,否则依赖传递会失效
  • 若模块含多 flavor(如 free/pro),assembleRelease 只打默认 flavor,而 publish 任务默认不处理 flavor 变体,需要额外配置 variants.withType<libraryvariant></libraryvariant>
AAR 打包不是“点一下就完事”的操作,它的可靠性取决于三个隐性契约:模块类型声明正确、混淆规则主动导出、依赖关系如实反映在 pom 中。漏掉任意一个,下游集成时都会变成黑盒排查。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

922

2023.08.14

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2747

2023.08.22

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

5437

2023.09.19

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.10.18

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

964

2024.03.01

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

389

2026.05.09

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

100

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

60

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

220

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gradle 9 主版本升级指南
Gradle 9 主版本升级指南

共0课时 | 0人学习

Gradle 安全最佳实践
Gradle 安全最佳实践

共0课时 | 0人学习

Gradle 依赖校验手册
Gradle 依赖校验手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn