Gradle 与 Android Gradle Plugin

1. Gradle 是一个强大且高度可配置的构建工具，本身只提供了核心的构建框架和任务管理机制，，为各类项目（例如，Java、Kotlin、C++ 项目）提供构建能力的基础

2. Android Gradle Plugin 是运行在 Gradle 之上的一个特定插件，它的作用是让 Gradle 能够理解并执行构建 Android 应用所需的一切复杂工作，例如

1. 编译资源文件和 Java / Kotlin 代码

2. 处理 AndroidManifest.xml

3. 对 APK 进行签名和对齐

4. 管理构建变体

Android Gradle 中的 android { namespace }

1. namespace 是 Android Gradle Plugin（AGP）7.0 版本中引入了新的概念，用来取代旧版的 applicationId 和 package 在资源访问层面的角色

2. namespace 的核心作用是给 App 的 R.java 文件指定一个包名路径

3. 旧方式的 R.java 的包名路径默认等于 AndroidManifest.xml 文件中的 package 属性

旧版 package 的属性身兼多职

1、基本介绍

1. 应用唯一标识：系统根据 package 识别你的 App、布到 Google Play 后不可更改、影响安装路径 /data/data/<package>/

2. 资源命名空间：决定 R.java 文件生成的包路径

3. 默认代码包名：如果没有显式指定，Java / Kotlin 文件的默认包名就是它，AndroidManifest.xml 文件中注册的四大组件可以省略包名

<!-- 完整写法 -->

<activity android:name="com.example.myapp.MainActivity" />

<!-- 省略包名 -->

<activity android:name=".MainActivity" />

2、AGP 7.0+ 的明确分工

1. 应用唯一标识：交给项目级 build.gradle 的 applicationId

2. 资源命名空间：交给项目级 build.gradle 的 namespace

3. 默认代码包名：交给项目级 AndroidManifest.xml 的 package

Android 模块打包

1、基本介绍

1. 如果模块只包含纯逻辑代码，那可以打 JAR 包

2. 但大多数 Android 模块会涉及资源文件，最推荐的还是打 AAR 包

布局文件（.xml）

图片、图标（drawable/）

颜色、尺寸、字符串（values/）

自定义 View 需要 attrs.xml

四大组件（Activity、Service 等）需要清单声明

3. 只有纯算法、工具类（没有 Android 资源）可以打 JAR 包；但凡有界面或资源，必须打 AAR 包

4. Gradle implementation 可以拉取 JAR 包或 AAR 包

2、打 AAR 包

1. 创建 Android Library 模块：【File】 → 【New】 → 【New Module】 → 【Android Library】

2. 构建 AAR 包：打开右侧 Gradle 面板 → 找到【模块名/Tasks/build/assemble] → 双击执行

3. 获取 AAR 包，生成位置如下

模块名/build/outputs/aar/
├── 模块名-release.aar  # 正式版（推荐）
└── 模块名-debug.aar    # 调试版