企业官网建设流程全解析

Unity2021升级实战：用.androidlib重构Android资源打包方案

当Unity2021的打包日志突然抛出那行刺眼的红色报错时，我意识到这次版本升级远不止是简单的"点击更新"就能搞定。作为长期使用2019 LTS版本的开发者，面对全新的Android资源管理机制，不得不重新审视那些已经沿用多年的项目结构。本文将完整还原从报错分析到解决方案落地的全过程，不仅告诉你如何创建.androidlib文件夹，更重要的是理解Unity2021为何要做出这样的架构调整。

1. 报错背后的技术变革

那个看似简单的错误信息——"OBSOLETE - Providing Android resources in Assets/Plugins/Android/res was removed"，实际上标志着Unity对Android插件管理方式的重大改革。在早期版本中，开发者习惯将Android资源直接放在Assets/Plugins/Android/res目录下，这种直白的做法虽然方便，却存在几个致命缺陷：

• 资源隔离性差：与主工程资源混在一起，容易发生命名冲突
• 构建流程混乱：Unity需要特殊处理这些"外来"资源文件
• 维护成本高：无法享受Android标准库的版本管理机制

Unity2021开始强制要求使用AAR（Android Archive）或Android Library格式封装资源，这实际上是向Android开发的标准实践靠拢。理解这一点很重要，因为：

# 新旧资源管理方式对比 传统方式：Assets/Plugins/Android/res/... 新规范：.androidlib/res/... → 生成AAR → 最终打包

2. 快速解决方案实施

对于大多数不需要深度定制Android插件的中小型项目，创建完整的AAR可能有些杀鸡用牛刀。这时.androidlib方案就成为了理想选择，它本质上是一个简化版的Android Library项目。以下是具体操作流程：

2.1 创建基础结构

首先在项目中找到Assets/Plugins/Android目录（如果没有就新建），然后：

1. 右键 → Create → Folder，命名为CustomAndroidResource.androidlib
2. 将原有的res文件夹拖入新建的.androidlib文件夹内
3. 确保目录结构变为：

   Plugins/ └── Android/ └── CustomAndroidResource.androidlib/ ├── res/ │ └── ...（原有资源文件） ├── AndroidManifest.xml └── project.properties

2.2 关键配置文件编写

在.androidlib根目录需要创建两个核心配置文件：

AndroidManifest.xml（基础模板）：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="custom.android.res"> </manifest>

project.properties（必须包含）：

target=android-9 android.library=true

这两个文件的作用分别是：

• AndroidManifest.xml：声明这个库的基本属性，package名可以自定义但需保证唯一性
• project.properties：告诉Unity这是一个Android库项目，target版本应与主工程保持一致

3. 进阶配置与疑难排查

完成基础配置后，90%的简单项目应该已经可以正常打包。但如果你的资源比较复杂，可能还需要注意以下细节：

3.1 资源命名冲突预防

当.androidlib中的资源与主工程或其它插件资源重名时，构建系统会随机选择其中一个，导致不可预期的结果。建议采用前缀命名法：

# 推荐命名规范 res/ ├── drawable/ │ └── lib_icon_settings.png # 添加lib_前缀 ├── layout/ │ └── lib_activity_main.xml └── values/ └── lib_strings.xml

3.2 多库依赖管理

如果你的项目需要同时使用多个.androidlib库，且它们之间存在依赖关系，需要在project.properties中添加：

# 假设依赖另一个库CommonLib.androidlib android.library.reference.1=../CommonLib.androidlib

依赖顺序很重要，数字编号必须连续且从1开始递增。

4. 方案对比与选型建议

虽然.androidlib方案简单易用，但它并不是万能的。下表对比了三种主流方案的特点：

对于大多数Unity开发者来说，当遇到：

• 少量布局/图片资源需要打包
• 简单的原生代码扩展
• 快速验证方案可行性

.androidlib都是最平衡的选择。而当你需要：

• 深度定制Android组件
• 复用现有Android库
• 复杂的资源组合

这时就应该考虑建立完整的Android Library工程，通过Gradle构建生成AAR后再导入Unity。

5. 版本兼容性实战技巧

不同Unity版本对Android支持存在细微差别，这里分享几个版本适配的经验：

• Unity 2021.1+：强制要求.androidlib结构，但支持最新的Android Gradle插件
• Unity 2020 LTS：过渡版本，两种方式都可工作但会显示警告
• Unity 2019 LTS：完全兼容旧模式，适合维护老项目

如果项目需要跨版本协作，可以在.androidlib同级保留旧版res文件夹，然后通过条件编译控制：

#if UNITY_2021_1_OR_NEWER // 使用.androidlib方案 #else // 回退到传统res文件夹 #endif

在编辑器扩展脚本中，也可以通过UnityEditor.EditorApplication.version动态判断当前Unity版本，自动切换打包策略。