如何从双模块Android项目提取库模块并推送到GitHub

别担心，这事儿其实挺简单的，我给你两种靠谱的方法，你选适合自己的来操作就行：

方法一：给库模块单独初始化Git仓库（推荐新手用） #

这是最直接的方式，完全和主项目仓库分开，操作起来没什么复杂的：

• 打开终端或者命令行，导航到你的库模块根目录（比如你的库叫awesome-library，路径就是你的项目根目录/awesome-library）
• 初始化本地Git仓库：

  git init
  

• 把库模块里的所有文件都加到暂存区：

  git add .
  

• 提交你的第一版库代码：

  git commit -m "Initial commit: 我的Android基础库"
  

• 去GitHub创建一个全新的空仓库（注意别勾选“Initialize this repository with a README”这些选项，保持完全空的状态）
• 把本地仓库和GitHub的远程仓库关联起来：

  git remote add origin https://github.com/你的GitHub用户名/你的库仓库名.git
  

• 最后推送到GitHub：

  git push -u origin main
  

方法二：从现有项目仓库拆分出库模块（保留提交历史） #

如果你的整个项目已经在Git管理下，还想把库模块之前的提交历史也一起拆分出来，就用这个方法：

• 回到项目根目录的终端，运行Git的过滤命令，只保留库模块的文件和对应的提交记录：

  git filter-repo --subdirectory-filter 你的库模块目录名
  

  举个例子，如果库模块叫network-library，命令就是git filter-repo --subdirectory-filter network-library
• 执行完后，当前仓库就只剩下库模块的内容和历史提交了，接下来重复方法一的最后两步：关联远程仓库、推送即可。

几个要注意的小细节 #

• 推送前一定要检查库模块的build.gradle（或build.gradle.kts），确保它是配置成Android Library的（顶部应该有plugins { id 'com.android.library' }）
• 如果库模块依赖了主模块里的代码，得先把这些依赖迁移到库内部，或者换成远程依赖，不然别人拉取你的库后会编译报错
• 记得给库模块加上自己的README.md和LICENSE文件，把库的功能、使用方法写清楚，方便其他开发者快速上手

内容的提问来源于stack exchange，提问作者Abhishek Kumar