1. 项目背景与核心痛点

作为一名从Eclipse时代走过来的Android老开发，我深知在ADT环境下使用AAR文件的痛苦。虽然Android Studio早已成为主流，但仍有大量遗留项目运行在Eclipse环境中。最近在维护一个2016年的电商APP时，就遇到了必须使用第三方AAR库的情况。

传统方案需要解压AAR文件，手动导入jar和资源文件，过程繁琐且容易出错。更麻烦的是，当AAR更新时需要重复整个流程。经过多次实践，我总结出一套无需修改任何代码的极简方案，实测从开始到完成集成不超过1分钟。

2. 前置条件准备

2.1 环境要求确认

• Eclipse 4.4 (Luna) 及以上版本
• ADT插件版本23.0.0+
• Android SDK Tools 25.2.5+
• 确保已安装Android Support Repository

提示：可通过Eclipse菜单 Help > About Eclipse > Installation Details 查看ADT版本

2.2 必要工具安装

需要额外下载两个工具：

1. fat-aar 的eclipse适配版
2. aar2lib转换工具（推荐使用v1.3+版本）

将这两个工具放在同一目录下，例如：

D:\android_tools\ ├── fat-aar-eclipse.jar └── aar2lib-v1.3.jar

3. 零代码修改集成方案

3.1 自动化转换流程

新建一个批处理文件convert.bat，内容如下：

@echo off set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_202 set PATH=%JAVA_HOME%\bin;%PATH% java -jar D:\android_tools\aar2lib-v1.3.jar %1 java -jar D:\android_tools\fat-aar-eclipse.jar %~n1

使用时只需将AAR文件拖到bat文件上：

convert.bat library-release.aar

3.2 Eclipse项目配置

1. 右键项目 > Properties > Java Build Path
2. 选择Libraries标签页 > Add JARs
3. 导航到生成的library-release_lib/libs/目录
4. 选择所有jar文件（通常包含classes.jar和依赖库）

3.3 资源文件处理

转换工具会自动生成res和assets目录，需要：

1. 右键项目 > Import > General > File System
2. 选择library-release_lib/res和library-release_lib/assets
3. 勾选"Create top-level folder"选项

4. 原理深度解析

4.1 AAR文件结构拆解

标准的AAR文件实质上是zip压缩包，包含：

- /AndroidManifest.xml - /classes.jar - /res/ - /R.txt - /assets/ - /libs/ # 依赖的jar文件 - /jni/ # native库 - /proguard.txt

4.2 转换工具工作流程

1. 解压AAR到临时目录
2. 合并所有依赖的jar到classes.jar
3. 生成适配Eclipse的library项目结构
4. 自动处理资源冲突（添加前缀）

5. 常见问题解决方案

5.1 资源ID冲突

现象：编译时报resource already defined错误

解决方案：

1. 编辑library-release_lib/res/values/public.xml
2. 为所有资源ID添加前缀：

<public name="original_id" type="string" id="0x7f050001" /> 改为 <public name="lib_prefix_original_id" type="string" id="0x7f050001" />

5.2 依赖传递失效

现象：运行时出现ClassNotFoundException

处理步骤：

1. 检查library-release_lib/libs/是否包含所有依赖jar
2. 手动添加缺失的jar到Build Path
3. 在Order and Export中确保勾选所有库

5.3 多版本冲突

当主工程和AAR依赖不同版本的支持库时：

1. 解压AAR查看libs/下的版本
2. 统一使用较高版本
3. 删除重复的jar文件

6. 高级技巧

6.1 自动更新监控

创建watchdog脚本监控AAR文件变化：

import os, time from watchdog.observers import Observer from watchdog.events import FileSystemEventHandler class AARHandler(FileSystemEventHandler): def on_modified(self, event): if event.src_path.endswith('.aar'): os.system('convert.bat "{}"'.format(event.src_path)) observer = Observer() observer.schedule(AARHandler(), path='.') observer.start()

6.2 版本控制集成

在.gitignore中添加：

!*.aar library-*_lib/

这样原始AAR会被纳入版本控制，而转换产物自动忽略。

6.3 性能优化建议

1. 对大型AAR（>50MB）：
   • 增加JVM内存：java -Xmx1024m -jar aar2lib-v1.3.jar
   • 关闭实时防病毒扫描
2. 频繁更新的库：
   • 建立本地Maven仓库
   • 使用Jenkins自动构建

7. 实测数据对比

测试环境：Intel i7-9750H, 16GB RAM, Windows 10

8. 替代方案评估

8.1 迁移到Android Studio

优点：

• 原生支持AAR
• 更好的构建性能

缺点：

• 老项目迁移成本高
• 需要重新适应IDE

8.2 使用Maven本地仓库

步骤：

1. 安装Nexus Repository Manager
2. 部署AAR到本地仓库
3. 通过pom.xml引用

适合场景：团队协作开发

9. 遗留问题处理

9.1 包含JNI的情况

特殊处理步骤：

1. 手动创建jni目录
2. 复制.so文件到libs/armeabi-v7a/
3. 在Android.mk中添加：

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := native-lib LOCAL_SRC_FILES := libnative.so include $(PREBUILT_SHARED_LIBRARY)

9.2 使用注解处理器

需要额外配置：

1. 解压AAR获取META-INF/services/
2. 合并到主工程的相同目录
3. 添加APT插件依赖

10. 实际案例演示

以接入Glide 4.12.0为例：

1. 下载glide-4.12.0.aar
2. 拖拽到convert.bat
3. 观察输出：

[INFO] Processing glide-4.12.0.aar [INFO] Merged 17 dependent jars [INFO] Generated R.txt with 842 entries [INFO] Output to glide-4.12.0_lib

4. 在Eclipse中刷新项目即可使用

11. 工具优化方向

1. 图形界面版本开发
2. 支持批量转换
3. 自动依赖分析
4. 与Eclipse插件集成

目前已经实现了基础版的Eclipse插件，可以通过拖拽直接完成AAR导入。