如何将一个Android Studio项目合并到另一个Android Studio项目中

前期准备 #

• 完整备份两个项目的源码，避免操作失误导致文件丢失
• 对齐两个项目的compileSdk、minSdk、targetSdk版本，减少后续兼容报错
• 提前检查两个项目的资源命名、类名、自定义属性，避免出现命名冲突

步骤1：将项目1导入为项目2的依赖模块 #

• 打开目标项目（项目2），点击顶部菜单栏 File → New → Import Module
• 在弹窗中选中项目1的根目录，自定义模块名称（比如修改为project1_lib，避免和项目2默认的app模块重名），点击Finish完成导入
• 打开项目1模块的build.gradle文件，将头部插件配置中的id 'com.android.application'修改为id 'com.android.library'，同时删除文件中的applicationId配置项（只有应用模块允许配置applicationId，库模块无需该配置）
• 打开项目2根目录的settings.gradle文件，确认已自动添加导入模块的声明，示例如下：

include ':app', ':project1_lib'

步骤2：配置模块依赖关系 #

• 打开项目2主模块（默认app模块）的build.gradle文件，在dependencies代码块中添加对导入模块的依赖：

implementation project(':project1_lib')

• 点击右上角的Sync Now同步Gradle配置，等待同步完成无报错即可

步骤3：处理冲突与跳转逻辑 #

• 解决命名冲突：如果出现重复的资源名、类名，修改其中一方的命名即可
• 合并清单配置：将项目1AndroidManifest.xml中声明的权限、四大组件（Activity、Service、广播、内容提供者）合并到项目2的主清单文件中，注意按系统要求配置组件的android:exported属性
• 跨模块跳转示例：需要从项目2页面跳转到项目1页面时，直接引用对应类即可，参考代码如下：

Intent intent = new Intent(项目2主Activity.this, 项目1目标Activity.class);
startActivity(intent);

步骤4：功能验证 #

• 点击顶部菜单栏 Build → Clean Project 清理缓存，再执行 Rebuild Project 全量编译
• 运行项目测试所有功能逻辑、跳转路径，确认无类找不到、资源加载失败等问题
• 如果出现三方库依赖冲突，使用exclude关键字排除重复依赖即可

内容的提问来源于stack exchange，提问作者Prosign company