Android Git之旅

  • 前言
  • 正文
    • 一、安装Git
    • 二、准备工作
    • 三、旅行开始
      • ① git init
      • ② git add .
      • ③ git commit
      • ④ git config
      • ⑤ git remote
      • ⑥ git push
      • ⑦ git branch
      • ⑧ git pull
      • ⑨ git log
      • ⑩ git show
      • ⑪ git commit –amend
      • ⑫ git checkout
      • ⑬ git merge
      • ⑭ git clone
    • 四、结束

前言

  作为一个程序员,你保存代码的方式是什么?更新代码的方式是什么?你还在用拷贝的方式保存代码吗?U盘?移动硬盘?还是网盘?

正文

  以上的一些方式你可能在刚开始学习或工作的时候会用到,但不是长久之计,因此你需要学会使用git。git的用法虽然不难,但是精通不易,如果不是经常使用,容易看了就忘记,特别是一些指令的使用,这里做一个记录,从头开始了解git。

一、安装Git

  点击Git进入官网。

  官网会根据你的电脑系统为你推荐最新的Git版本,这里你会看到2.37.0,Windows安装版本,点击Download for Windows进入下载页面。

  点击下载符合你电脑的.exe程序,我是windows11,我下载的是64-bit Git for Windows Setup,下载过程慢慢等待即可。下载好之后双击exe进行安装,安装过程没啥好说的,前面一顿点击Next,碰到Install点击即可。安装完成之后我们在Android Studio中配置Git。


  点击Android Studio导航栏File → Settings → Version Control → Git ,然后点击文件夹图标选择Git安装路径下的git.exe,之后点击Test,会出现你所安装的Git的版本,表明你安装的Git没有问题,配置完成。

二、准备工作

  为了方便演示,我们通过Android Studio创建一个项目来进行git的了解,创建一个名为GitStudy的项目。

  创建好之后就可以开始提交代码了,我们需要确认提交代码的平台,目前最火热的当然是GitHub(有时候访问不了,可能需要翻墙),然后是Gitee(码云,稳定)、GitLab。

GitHub

Gitee

GitLab

  你要在那个代码托管平台保存自己的代码就去那个平台注册账号。

  作为开源爱好者,我选择的是GitHub,账号注册这些环节就没有啥好说的,下面要做的就是把代码提交的GitHub上。那么我们可以在Android Studio中配置我们的Git账号,点击导航栏File → Settings → Version Control → GitHub。

  点击Add account进行账号添加,会出现一个弹窗。

  这里我们选择使用使用Token进行登录,点击 Log In with Token…,会出现一个弹窗。


  这里我们需要输入Token,点击右侧的**Generate…**按钮去GitHub中构建Token。

  这里需要你验证一下,输入密码之后点击Confrim password。身份验证通过之后进入Token创建页面。

  这里Token的有效期是30天,你可以设置时间更长,其他的地方不用设置,滑动到页面底部。

  点击Generate token按钮,Token的创建好了。

  点击右侧的复制按钮,将Token复制一下,然后再回到Android Studio中,将token粘贴到输入框中。

  点击Add Account即可完成GitHub账户添加,添加后就能看到账户的信息。

  点击弹窗右下角的Apply进行账户应用,此时右上角的Reset就会消失,再点击OK关闭弹窗。

三、旅行开始

首先看一下我的GitHub主页。

  现在是91个代码仓库,下面我们来提交第92个。首先我们在GitHub上创建一个新的仓库。

  这里输入仓库的名称和描述,勾选Add a README file,这会在创建仓库的时候添加一个README.md文件,这个仓库默认是public公有的,表示任何人都可以看到,private则是私有的,仅自己和仓库成员可见。然后我们滑动到页面底部,点击Create repository 按钮,完成仓库的创建。

  仓库创建成功,现在里面就只有一个md文件,下面我们要将自己的项目代码提交到这个仓库中。

  回到我们刚才创建的项目,点击Android Studio底部导航栏的Terminal。

会自动进入当前项目的所在目录。

  要提交代码首先需要创建一个本地代码仓库,有这个仓库才能去提交代码。

① git init

git init

在输入前我们先看一下当前项目的文件夹。

下面在Terminal中输入git init 然后回车,如下图所示。

  初始化一个空的git仓库,此时你会发现你的项目的文件夹下多了一个.git文件夹。

它是一个隐藏文件,如果看不到,就需要设置一下查看方式。

② git add .

然后我们需要将所有的文件拷贝到暂存区。

git add .

  通过这个命令就可以提交当前目录下所有的文件,注意这个命令后面有一个点,不要省略空格。在Terminal中输入git add .然后回车,如下图所示。

  这里就是把所有的文件添加到git中,你会发现你的MainActivity.kt这个文件名的颜色变成了绿色,这也是一个小细节,如果你看到的是红色,那么你在重新打开一下看看,就会变成绿色,有时候Android Studio的检查机制没有那么及时。

③ git commit

  文件添加到暂存区之后,我们就可以将暂存区内容添加到本地仓库中。

git commit -m "第一次提交"

  这个命令稍微有一些长,在 Git 中,每次提交代码,都要写 Commit message(提交说明),否则就不允许提交。上面代码的-m参数,就是用来指定 commit mesage 的。你得让别人之后你这一次提交的代码是什么意思,当然也方便你以后查询。

  下面我们在Terminal中输入git commit -m “第一次提交”指令,然后回车,如下图所示。


  失败了,为什么呢?因为在执行这一步时需要知道提交的人是谁,另外这个信息里面也告诉你该怎么做了。

  我们需要输入这两条指令,一条设置邮箱,一条设置名称。

  例如我的邮箱是lonelyholiday@qq.com,名称是llw。

④ git config

git config --global user.email "lonelyholiday@qq.com"
git config --global user.name "llw"

  下面在Terminal中就可以这么输入,先输入第一条,然后回车。

  再输入第二条,然后回车。


  你会发现似乎没有什么变化,实际上变化是有的。怎么查看这个变化呢?

通过

git config --global user.email

git config --global user.name

  这两条指令和之前的区别就是没有设置值,下面我们执行回车看一下有什么变化。

  这个变化是很明显的,现在解决提交人的信息问题,我们继续执行之前的未完成的git commit指令。

  你有没有觉得每一条命令都要一个一个的敲很麻烦,实际上你刚才敲过的指令可以通过键盘的上下键进行切换,试试看吧。

  现在我切换回git commit -m “第一次提交”,再回车一次。

  这一次执行成功了。

⑤ git remote

  因为要提交到GitHub中创建GitStudy上,所以我们需要将本地仓库提交到远程仓库并关联。关联需要一个重要的内容那就是远程仓库的地址。

  复制仓库地址之后需要通过一个命令去关联。

git remote add origin "https://github.com/lilongweidev/GitStudy.git"

  这里的仓库地址请使用自己的,你用我的肯定是提交不上去的,在Terminal中输入指令,回车。似乎没有打印什么内容,但是指令已经生效了。

⑥ git push

  最后推送上去

git push origin main

  上面命令表示,将本地的main分支推送到origin主机的main分支。如果main不存在,则会被新建。这个main是从哪里来的呢?

  推送之前要注意推送的分支是哪一个。在Terminal中下面执行命令,回车。

  然后就报错了,这里的报错是因为分支不同。

⑦ git branch

  通过命令来查看当前的分支,

git branch

  在Terminal中输入指令回车,来看看有什么不同。

  原来本地的分支默认是master,而GitHub上创建的分支默认是main。分支需要统一,所以将本地的master改成main。

git branch -m master main

  在Terminal中执行这个命令,回车。然后再查看当前分支,确认有没有改成功。

  这里改好了,那么我们再来push。


  哦豁,又有问题!是不是很烦呢?这是连接重置,国内访问GitHub有时候会这样,再来一次,我的原则就是不服输。


  人麻了,又报错了,这个错误还有一点不太一样,这个错误的根源在哪里呢?经过我的百度了解之后,预测是远程仓库里面的README.md文件导致的,我们这样提交代码,可能会导致它丢失。这个颜色的字体是警告,我们无视它,执行。

git push --force

  再回车看看。

  没想到吧,还是不行,为什么不行呢” />git push set-upstream origin main

  试试呗。


  还是没有什么用,现在是不是心态崩了呢?莫慌,再尝试别的方式。

⑧ git pull

  刚才我们一直是提交,但是因为远程仓库里面有一个README.md导致本地库和远程库有差异,所以我们反向操作一下,先把远程库的内容拉取到本地,试试看。

git pull --rebase origin main

执行

  拉取成功了,我们再提交看看。

git push origin main

  妈耶,终于成功了!我们看看GitHub上,这个库有没有变化。

  来人,奏乐,这不得庆祝一下吗?嗯?

  现在代码提交成功了,那我们修改一下AndroidStudio中的代码,然后再提交一次看看,这也是我们下班关闭电脑前要做的事情,保存代码。例如我们刚才写的指令都写到README.md中,代码如下:

# GitStudyGit学习git init git add .git commit -m "第一次提交"git config --global user.email git config --global user.name git remote add origin "https://github.com/lilongweidev/GitStudy.git"git push origin maingit push --forcegit push --set-upstream origin maingit branchgit branch -m master maingit pull --rebase origin maingit push origin main


你看到这个README.md文件名称变成了蓝色,这说明文件有改动,提交的时候就会把这个改动提交上去。

这里只需要先后执行。

git add .
git commit -m "修改README.md"
git push origin main

既可,如图所示:

我们再看看GitHub上的变化。

  这个文件提交上来了,有时候我们会去查询之前提交的内容。

⑨ git log

  可以通过git log进行查询。

git log

  在Terminal中执行,回车。

  注意看,这里的修改记录是按时间排序的,最近的一次修改在最上面,也就是修改修改README.md。

如果要查询当前最新的commit呢?

⑩ git show

git show

执行回车

  这里就是查看当前最新的commit,这个日志中带有 绿色 + 号的表示是本次提交中新增的内容,我们滑动到最底下,你会看到光标没有结束,回车一下。

  这里会看到我们的提交内容,你注意看,@@ -1,2 +1,29 @@表示之前是第1行到第2行,现在是到第29行。你就一直回车,直到看到End。

如果不需要查看了。

点击左上角的关闭按钮,关闭Local窗口。

  有时候有这种情况,我们提交了一个commit之后发现好像还漏掉了什么内容,比如请求动态权限时忘记在AndroidManifest.xml中注册静态权限了,这时候我们需要将之前的commit改成本次的commit。也就是合并commit,我们来演示一下。修改一下MainActivity中的代码,如下所示:

class MainActivity : AppCompatActivity() {private val requestCamera =registerForActivityResult(ActivityResultContracts.RequestPermission()) {Toast.makeText(this, if (it) "权限授予" else "未授予", Toast.LENGTH_SHORT).show()}override fun onCreate(savedInstanceState: Bundle" />) {super.onCreate(savedInstanceState)setContentView(R.layout.activity_main)requestCamera.launch(Manifest.permission.CAMERA)}}

  这里的代码很简单,就是动态权限的申请。这种运行起来肯定是不会请求权限的,因为你没有注册静态权限,所以连那个询问用户权限是否开启的弹窗都不会出现,但是我们现在需要提交了。

  这时候我们发现没有注册静态权限。现在去AndroidManifest.xml中注册静态权限。

<uses-permission android:name="android.permission.CAMERA"/>

⑪ git commit –amend

执行

git add .
git commit --amend -m "添加静态权限。"

然后推送上去。

再查看commit日志。

这样就避免出现两次commit了。

  有时候我们开发项目,会有多个环境的项目,例如正式版,测试版,通常用不同的分支进行管理,现在我们只有一个main分支,那么我们可以通过命令去创建分支。首先我们会用到创建分支的指令。

git branch develop

  这里的develop就是我们要创建的分支名称,意思是开发,下面执行一下,然后再查看分支。

  可以看到这里有两个分支了,你会发现main分支前面有一个*号,同时是绿色的,这表示当前分支。

⑫ git checkout

  那么如果要让develop变成当前分支呢?

执行

git checkout develop

然后我们再查看所有分支。

  切换成功了,不过develop分支还没有内容的,为了让develop和main分支的内容不一样,我们com.llw.gitstudy包下创建一个ToastUtils.kt文件。

然后你会看到弹出一个窗口。

  就是在询问你,是否要将此文件添加到git上,你会发现此时文件名是红色,当你点击了Add按钮就会变成绿色,如果你不希望每次创建文件时都询问你,就选中弹窗左下角的Don‘t ask again即可,现在我们点击Add。

然后我们在ToastUtils中写入如下代码:

import android.content.Contextimport android.widget.Toastfun String.showToast(context: Context) =Toast.makeText(context, this, Toast.LENGTH_SHORT).show()fun String.showLongToast(context: Context) =Toast.makeText(context, this, Toast.LENGTH_LONG).show()

然后我们在MainActivity中使用它。

private val requestCamera =registerForActivityResult(ActivityResultContracts.RequestPermission()) {if (it) "权限授予" else "未授予".showToast(this)}

下面我们将刚才所写的代码提交,还记得是什么指令吗?

最后我们推送当前的develop到服务器上,推送的时候可能会出现。

这样的异常,没事的,多试几次,总能推送上去,实在不行就更换网络再尝试。

  这里我们就推送上去了,可以看到当服务器上没有这个分支的时候就会创建这个分支,下面我们去GitHub上看看。

  分支提交成功。现在服务器加上本地就有四个分支了,我们可以通过命令查看一下。

执行

git branch -a

-a就是-all,表示全部。红色的就是服务器上的分支,四个分支没错。

  现在develop分支代码和main分支不一致,当我们在develop分支中验证代码没有问题之后,将它合并到main分支中,首先要切换分支到main。

git checkout main

切换成功,下面进行合并

⑬ git merge

git merge --no-ff develop

–no-ff 在这的作用是禁止快进式合并。

然后打开GitHub,切换到develop分支,你会看到

点击Contribute会出现一个弹窗。

  点击左边的Compare表示比较代码,点击右边的Open pull request表示同意这一次的分支请求,因为我已经知道我在develop中添加了什么内容,因此就无需比较了,直接点击右边Open pull request

添加描述后点击Create pull request按钮。

  由于之前操作过快,忘记截图了,所以这里我回退了一下,重新搞了一次,上面的Test不重要,你注意下面这个Merge pull request按钮,点击它。

再点击Confirm merge。

  最后写入描述,然后点击Comment按钮,然后你观察main分支中,就会发现那里有了之前没有的ToastUtils。

那么现在develop分支就没有什么用了,因此我们可以删除这个分支。

git branch -d develop

我们在删除前查看一下分支,然后执行删除,删除后再查看一下:

  -d表示删除标识,要删除的不能是当前显示分支,同时不能包含未合并的更改和未提交的推送。

现在远程仓库中还有两个分支,我们也可以将远程仓库的分支删除掉。

git push origin -d develop

执行之前查看所有分支,执行删除,删除之后再查看所有分支。

  很多时候我们会参考别的的代码,框架。会先运行别人的源码看看效果,这里就需要用到克隆。

  例如我可能自己的项目到当前电脑指定文件夹下,项目地址是:Android12Bluetooth

点击Code按钮。

点击复制按钮,然后我们进入一个指定目录。

克隆指令如下

⑭ git clone

git clone https://github.com/lilongweidev/Android12Bluetooth.git

进入PowerShell,先进入到指定文件夹下,然后克隆。

然后再看文件夹。


克隆成功。

四、结束

  Git的使用需要经常使用才能印象深刻,关于git的使用网络上有很多很多,遇到问题解决的方法也有很多,遇到问题不要慌,要坚定自己能解决这个问题,加油奥里给!!!