Android Studio使用Git分支管理

一、首先到Git平台上创建一个空的项目

由于是首次创建项目是空的，所以我们本地先提交一个工程代码上去
先找一个目录执行：git clone 拉取远程仓库

二、然后我们用Android Studio创建一个工程项目：
将创建的工程文件复制到刚才clone下来的仓库目录里，或者在AS创建项目的时候项目路径选择刚才clone下来的目录

由于是第一次提交，我们需要打开根目录下.gitignore文件忽略一些不必要的文件如build、.idea、iml等, 在.gitignore文件中输入下面内容并保

同样在工程下面的每个module目录下面也有一个.gitignore文件，我们在其中输入下面内容并保存：

*.iml
/build

•  

然后在该目录下依次执行下面命令：

git add .
git commit -m "添加项目文件"
git push

•  

这样项目就被提交到远程仓库了，其他人就可以从仓库上clone这个工程的代码

AS中clone远程仓库

我们重新打开AS，选择checkout刚才的提交项目：


在弹出框中输入远程仓库的地址，点击clone即可。当然你可以用命令先clone到文件夹，再从AS中File菜单选择open该目录也可以。

提交代码

AS中的更新和提交基本上都是在工具栏上的这两个按钮，提交代码点击右边的按钮，只不过在AS中提交代码到Git比Svn要多一步push操作。

由于项目没有变动所以提交会提交没有东西可以提交，我们先创建一个类，创建完毕会弹出下面的弹窗：

注意这里一定要勾选Remember, don't ask again, 不然后面新添加的文件你都得手动右键Git菜单去add，勾选之后新创建的文件就会自动被执行add操作。然后我们再修改一个原有的类，完了点击提交按钮：

在弹窗中会列出有变动的文件（包括新增的、修改的、删除的），输入提交日志点击commit, 注意Git到这一步只是提交到本地仓库，并没有提交到远程Git服务器。

这时在AS的Version Control面板中可以看到提交日志记录以及提交的文件：

接下来就是执行push操作，如果以前用惯了SVN的话可能会经常忘记最后一步的push操作：

或者直接在commit的时候点击commit按钮旁边的三角下来选择Commit and Push也可以进行push操作：

提交成功之后AS右下角会有个类似Toast的弹窗提示，并且这时我们再查看AS的Version Control面板中可以看到刚才的提交日志旁边的标签符合会有一点不一样，多了一个origin表示到这一步的改动已经提交到服务端。

这时到浏览器上去查看Gitlab上面的工程也能看到刚刚的提交日志


一般在进行提交操作之前，最好先执行update操作，因为有可能别人提交了代码跟你的有冲突。

创建分支

AS中创建分支可以直接点击右下角的底部工具栏点击Git:master选择New Branch

或者在右键选择Git-Repository-Branches也行
在弹出的弹窗中输入分支名称：

点击OK就会创建新的本地分支，注意这个弹窗有一个Checkout branch复选框，默认是勾上的，这意味着创建完该分支的同时AS会将当前工程切换到该分支下，如果你只是想创建一个新的分支并不想切换到该分支，还是打算留在当前分支的话，那么就不要勾选这个就可以了。

创建完毕后我们再次点击底部的按钮查看分支：

可以看到新创建的分支只是存在于Local Branches当中，Local Branches现在有三个分支，其中前面带有一个箭头符号的表示AS当前所处的分支，而在Remote Branches当中是只有master分支。

那怎么把本地分支提交到远程仓库呢，很简单，在当前分支下再执行一遍commit、push操作就可以了，提交完成后，我们再次查看分支情况：

这时在Remote Branches当中多了一个origin/develop分支，表示已经提交成功了，同时我们到Version Control面板中去看一下也会发现区别标志：

我们在浏览器中看一下GitLab上的分支情况，可以看到确实多了一个分支：

上面是在AS中创建的分支，当然你也可以直接在浏览器中创建：


这样创建完毕会直接在服务端生成新的分支：

我们可以在AS中看一下此时的分支情况（需要先执行一下update操作）：

可以看到在Remote Branches当中分支多了一个origin/zhaoyun分支

切换分支

切换本地分支

切换本地分支很简单，在Local Branches当中选择要切换的本地分支，然后执行CheckOut就可以：

这个菜单里除了CheckOut还可以CheckOut as New Branch即在当前分支的基础上再创建一个新分支。

切换完分支后底部会显示当前分支的名字：

切换远程分支

切换远程分支可以在Remote Branches当中选择一个想要切换的远程分支进行CheckOut

切换完成以后当前工作空间就会切换到该分支并且在Local Branches当中多了名为zhaoyun的分支：


当然这里在切换远程分支时最好选一个本地没有的对应的远程分支，如果你选了一个本地已有的分支，比如这里选develop, 弹出的弹窗就会提示该分支已存在：

当然你如果改一个名字也是可以再check出来一个的：


这样本地就会存在两个对应远程develop的本地分支，这两个分支可以分开开发互不影响。

合并分支代码

合并本地分支代码

这种情况下一般是你自己在本地check了好几个远程分支的本地分支，然后自己想要合并不同的分支代码，在Local Branches当中选择要合并的本地分支执行Merge操作即可，比如现在是master本地分支，我要合并develop的本地分支：

合并后只是在本地进行了代码合并，如果想要在远程仓库也合并，需要在合并之后当前分支执行commit和push操作。

合并本地分支冲突

两个本地分支合并以后，如果没有冲突，并且被合并以后的代码没有被commit, 这时他们会共用相同的工作空间共用一份代码，修改代码的时候，所有merge过的本地分支代码都会被修改。

假如这时你commit了其中一个分支的修改的代码，那么再切换分支的时候，不同分支的代码就又会分隔开来。

假如这时你commit了其中一个本地分支的代码后又修改了代码，那么再次进行checkout另一个分支的时候，可能会发生冲突：

我们点击Smart Checkout按钮，会弹出冲突合并的弹窗：

点击merger按钮：

这个弹窗当中左边的框中是当前本地分支的尚未进行commit的代码，右边的框中是要checkout的目标分支的本地代码，而中间的框是最终合并的结果，你可以点击左右两边的 x 或者 >> 来选择保留或者舍弃某一边的代码。点击Apply按钮会保留merge的结果，如果你点击了关闭弹窗，则冲突会被保留到代码当中：

这时即便你手动删除了冲突的代码，当你再次尝试切换分支的时候，依然会提示你冲突未解决：

点击提示中resolve，可以看到又会弹出刚才的merge弹窗：

保证冲突被解决后AS才会进行分支切换

本地分支合并远程分支

这种情况最常见，一般是多人开发，别人开的分支提交了代码之后，你的本地分支想去合并它提交的代码。

操作跟合并本地分支一样，直接在Remote Branches当中选择要合并的本地分支执行Merge操作即可：

合并之后不要忘了把合并的结果执行push操作

合并远程分支冲突

如果在本地分支合并远程分支的过程中出现冲突，AS会自动弹出合并冲突的弹窗：

点击Merge按钮会弹出下面的弹窗：

这个弹窗当中左边的框中是当前本地分支的代码，右边的框中是要merge的目标分支的远程代码，而中间的框是最终合并的结果，你可以点击左右两边的 x 或者 >> 来选择保留或者舍弃某一边的代码，当然为了保险有的时候还是需要仔细检查后手动去复制修改，以免误操作导致代码丢失错乱。注意，点击Apply按钮才会保留merge的结果，如果你点击了关闭弹窗，则不会做任何改变。

远程分支合并远程分支

这个AS中没有找到对应的操作菜单，只能在服务端进行了，打开浏览器在GitLab上选择Merge Requests—New Merge Request:

这里会让你选择从哪个分支合并到哪个分支：

确认好后点击按钮继续：


最终会生成一个merger请求，我们点击下面的Accept Merge Request按钮才会真正的执行Merge操作：

Merge成功会有下面的提示，同时去commit history里也能看到提交记录

删除分支

AS可以选择删除本地分支和远程分支：


删除远程分支可能需要权限，删除分支后代码就没有了，所以一定谨慎。

更新代码

更新代码有两种方式，第一种是前面提到的直接点击工具栏上的更新按钮：


弹出的弹窗中会有一些选择项，如果你是单人单个分支开发的话，用默认的就可以，默认是更新的当前分支的代码。如果是多人开发的话，可以选择merge，这样如果别人有提交代码跟你的冲突的时候AS会自动弹出merge弹窗。

另一种更新代码的方式可以在右键菜单中选择Git–>Repository–>Pull：

这时会弹出下面的弹窗：

可以看到这里pull操作不仅可以选择当前分支，还可以选择服务器的其他远程分支进行一并Pull，如果有冲突的话，AS会自动弹出前面合并冲突的merge弹窗进行merge操作。

回退本地分支代码到某个版本

可以在Version Control面板的Log记录列表中选择某一条你想要回退的记录，然后右键Revert:

这步操作将会把你当前本地分支的代码和你选中的那条提交记录对应状态的代码进行合并操作，当然如果此时有冲突，AS依然会弹出merge弹窗。

或者，你也可以选择Reset Current Branch to Here:

这个操作会弹出下面的弹窗：

这里有几种选择模式：Soft、Mixed、Hard、Keep，不同的模式含义也不同：

Reset模式	含义
Soft	当前的代码文件不会发生任何变化，只是提交的记录指针会恢复到该次记录，下次提交时的变化将会是该次记录之后的所有变化
Mixed	当前的代码文件不会发生任何变化，提交记录指针会移动到该次记录，下次提交时的变化将会是当前代码基于该次记录之上的变化
Hard	该操作会将本地的工作区缓存区完全重置为选中的记录状态，当前任何代码的改动都会丢失
Keep	该操作会将本地的工作区缓存区完全重置为选中的记录状态，但是当前代码的改动任然会被保留下来

假如提交记录以及当前代码的状态如下：

那么此时我们选择第三次commit进行Reset不同模式的情况如下：




根据Tag检出代码

除了分支管理代码以外，我们也可以通过Tag来管理代码，Tag可以理解为某次提交的时刻打一个标记，一般用于比较重要的里程碑，例如你可以用它来进行发布版本的管理。

首先创建一个Tag:


这里弹窗中填写Tag名称与Tag信息，点击Create Tag即可创建本地标签。其中Commit可填写以前某次提交记录的id，表示在该次提交上打Tag，如果不填表示Tag打在最新提交的commit上。

创建完Tag后，需要将Tag推送到远程分支：

这里的弹窗中勾选Push Tags即可，Push之后我们可以在GitLab浏览器上看到刚刚提交的Tag：

然后我们可以根据Tag检出代码了：

这样检出代码以后，你会发现当前不处于任何分支：

此时工程文件处于一个没有名字的分支，如果你修改了代码后进行Push操作会发现处于Detached HEAD状态无法进行Push：

这是因为 Tag 相当于是一个快照，是不能更改它的代码的, 如果要在 Tag 检出的代码的基础上做修改，你需要创建一个新的branch：git checkout -b branch_name tag_name，这个操作在AS中无法通过菜单按钮完成，只能通过命令行执行：

执行完成后再回到AS中看一下：


可以看到我们的分支终于有了名字，这时就可以正常提交了，剩下的操作就跟之前的操作一样。其实最终还是将当前代码作为一个新的分支进行管理了，但这个只是本地分支，并不会在远程服务器创建新的分支，这样好处是可以避免创建过多的远程分支。

前面提到创建Tag时不填commit是为最新的一次commit打标记，如果我想为某一次打标记呢，有个便捷的方法，就是在Version Control的日志面板中选中某一条记录，然后右键执行New Tag: 


弹出框中输入tag名称即可，然后同样进行Push 操作（不过这样创建的tag好像并不会在远程服务器端存在？），之后可以同前面操作一样去检查这个tag作为一个新的分支使用。

通过Revision Number ( 版本号 ) 检出代码

这个操作几乎跟tag检出过程一样，不过我们不需要先创建Revision Number，每次commit的时候Git都会生成一个id这个就是Revision Number，我们可以在Version Control的日志面板中选中某条提交记录，然后右键选择Copy Revision Number:

这样就能获得该次提交的id版本号，然后选择去CheckOut这个版本号的代码：

在弹出框中黏贴刚才Copy的版本号：

然后就能检出这个版本号的代码了，不过检出之后也会处于Detached HEAD状态无法进行Push状态，同样我们需要通过命令执行git checkout -b branch_name commit_id 来创建一个新的branch，其中commit_id就是刚才Copy的Revision Number。

感觉这个好像比Tag更加方便一点

补充Gitlab命令拉取分支的三种方式：

1. 直接执行命令git clone -b branch_name branch.git branch_name是分支名字

2. 可以先clone master.git 到本地， cd到项目目录，然后执行git checkout -b dev origin/branch_name, branch_name是分支名字

3. 可以先clone master.git到本地， cd到项目目录，然后使用命令 git branch -r # 查看远程分支 或 git branch -a # 查看所有分支, 会显示:

然后直接 git checkout origin/branch_name即可