[分享][问答]Android Git 项目结构讨论

[lixiaoyi]

场景是这样的，一个团队里面同时开发几个app，每一个android app项目包含app模块和若干library，其中一些核心library会被其他app项目公用。
讨论如何设计git的项目结构，欢迎有经验的开发者提供好的思路，此讨论不涉及代码实践，只讨论普遍问题，欢迎大家放心分享。
下面是两个方案抛砖引玉，欢迎讨论大家正在使用的结构。

方案一:

用Android Repo，把app，lib分别独立放在不同的 git repository，用repo sync同步和checkout

＊优点是各个模块分离，代码提交纪录清晰，在不同app开发只看到属于各自的提交纪录，pull request 和code review也分别在不同的repository中，非常清楚修改了哪个模块，同时还有Repo manifest工具的其他优点，部署，版本控制等等
＊缺点是在开发其中一个app时修改了核心library，不能直接看到在另一个app是否编译通过，比如类或方法名改变了，必须到检出另一个app才可以

方案二：

所有模块放在同一个git repository，也就是无论几个app都在一个repository，共享核心library。
＊优点是修改核心library可以在同一个branch看到是否所有app都可以运行
＊缺点是不管开发和修改了哪个app或module，所有提交纪录都在一个repository里面，所有pull request也是，别人review时难以明白到底是改了哪个app，非常不方便模块化管理

[kyleinfo]

既然是一个团队的，可以试试放在同一个 repo 里面，用不同的分支，所有对 lib 的修改提交到 lib 的分支，其它的 app
提交到各自的分支，想要额外建立分支的话在分支前加入对应 lib, 或者 app 的前缀。这样的话，有上面所有的优点，也避开了你说的缺点。

XiaoyiLI notifications@github.com于2015-10-2 5:00 周五写道：

场景是这样的，一个团队里面同时开发几个app，每一个android
app项目包含app模块和若干library，其中一些核心library会被其他app项目公用。
讨论如何设计git的项目结构，欢迎有经验的开发者提供好的思路，此讨论不涉及代码实践，只讨论普遍问题，欢迎大家放心分享。
下面是两个方案抛砖引玉，欢迎讨论大家正在使用的结构。
方案一:

用Android Repo，把app，lib分别独立放在不同的 git repository，用repo syn c同步和checkout

＊优点是各个模块分离，代码提交纪录清晰，在不同app开发只看到属于各自的提交纪录，pull request 和code
review也分别在不同的repository中，非常清楚修改了哪个模块，同时还有Repo manifest工具的其他优点，部署，版本控制等等
＊缺点是在开发其中一个app时修改了核心library，不能直接看到在另一个app是否编译通过，比如类或方法名改变了，必须到检出另一个app才可以

方案二：

所有模块放在同一个git repository，也就是无论几个app都在一个repository，共享核心library。
＊优点是修改核心library可以在同一个branch看到是否所有app都可以运行
＊缺点是不管开发和修改了哪个app或module，所有提交纪录都在一个repository里面，所有pull
request也是，别人review时难以明白到底是改了哪个app，非常不方便模块化管理

—
Reply to this email directly or view it on GitHub
#268.

[ipcjs]

一个project里面的module特别多的话，AS会不会特别卡呀。。。

[kyleinfo]

多了的话肯定会卡，不过既然有多个 module 的需求，那就考虑提升电脑的性能，加个固态硬盘吧

[lixiaoyi]

确实是一个思路，只是这样就要把各自的branch当作各自的development分支，如果需要master分支的话还需增加分支，在同一个repository的话分支实在太多。各个模块又会产生新的feature分支进行pull request。git flow的图形会很肥大。

[ipcjs]

@kyleinfo 公司电脑不是我想升就能升的～～

[ipcjs]

repo，貌似不是用来管理多个项目依赖同一个lib的。我试用过，感觉repo是Google用来把大型项目拆分成各各子模块，分开来开发用的，同时规避git在1G+的项目上会特别卡的问题

git submodule貌似可以在一个仓库里面，添加lib的仓库，不过听说命令蛮复杂～～，我没试过。你可以试下～

[lixiaoyi]

git submodule用过，是因为命令复杂，所以转到repo

[ipcjs]

@lixiaoyi 用repo管理lib？目录结构是怎么样的？
.repo、lib、app_1、app_2同一级目录？app_1和app_2怎么引用lib目录？AS里面lib和app貌似要在
同一个目录里面吧？

[ipcjs]

@lixiaoyi 能不能共享下你的manifest？我想看下要怎么设置才能两个app共享同一个lib

[lixiaoyi]

你说的问题是lib、app_1、app_2同一级目录，怎么让在AS里面又有其他gradle配置文件也在同一级目录，只要用linkfile就可以。
你把这些gradle配置文件放在其中一个repository里面，比如app1里面有一个config文件夹，按下面这样：

<project name="app1" remote="origin" path="app1" revision="development" >
        ...
        <linkfile src="config/build.gradle" dest="build.gradle"/>
        <linkfile src="config/gradle.properties" dest="gradle.properties"/>
        <linkfile src="config/gradlew" dest="gradlew"/>
        <linkfile src="config/gradlew.bat" dest="gradlew.bat"/>
        <linkfile src="config/settings.gradle" dest="settings.gradle"/>
               ...
</project>
<project name="lib1" remote="origin" path="lib1" revision="development" >
<project name="lib2" remote="origin" path="lib2" revision="development" >
<project name="lib3" remote="origin" path="lib3" revision="development" >

checkout app1的时候按照这个manifest，Repo会把你设置的文件移动到外面，建立AS识别的正常项目结构

[ipcjs]

@lixiaoyi
这两天重新比较了下repo和submodule；决定用submodule：
repo功能更强大，管理再多的git仓库复杂度都不会上升；但电脑用的windows平台，要用repo还要装个Cygwin，给自己装到没什么，给同事装，简直要人命；关键是，建gerrit的那个人不会用repo，居然没给我们修改manifest仓库的权限，review的地址也配置错了，用repo upload上传不了代码。。。唉，想着就蛋疼
git submodule，看这个教程老长，但实际上敲下来，也就几个命令，理解之后其实也很简单。submodule多了后貌似会更麻烦，但对于我那个小工程，应该是够了~~

关于你方案一里面所说的，修改lib的时候，希望能同时修改app_1、app_2
可以通过临时在settings.gradle中把app_2的module目录include过来，实现一个project里同时打开两个app的module，然后就可以统一改文件了~~
如图：

[lixiaoyi]

@ipcjs 谢谢你说的办法，可以解决。
我组里都是mac和linux环境，正在用repo。windows环境确实阻力较大。
就是想在这里抛出来看看别人是怎么做的，欢迎有更好的想法讨论

[renkangke]

建议library都是单独的库，然后建一个内部maven库，所有的library打成jar或者aar,其它项目只需要连接本地maven，编译时自动拉取aar即可，简单方便。