使用git管理嵌入式软件版本

你现在的Keil工程的版本控制是怎么管理的？可能有些人的做法是发布一个版本软件后将代码打一个包保存起来，作为此版本的备份。有一种常见的情况，当开始一项新功能的开发，并且最终的效果不理想老板要求回退回去。又恰巧在开发前没有打个包保存一下初始版本，那就需要一处一处回改，这样手工回退后的版本可靠性就下降许多，需要完整的测试才行。为了避免这种尴尬的情况，有必要在keil工程也引入版本控制工具。

Git是一个开源的分布式版本控制系统，可以有效、高速地处理从很小到非常大的项目版本管理。Git 是 Linus Torvalds （Linux发明者）为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。这个诞生于2005年并且至今都使得开发者赞不绝口的工具，实际上Linus仅开发了两周并在一个月内就上线用于管理庞大的Linux内核了，不得不赞叹天才的伟大和凡人的不可企及。

时至今日，Git早已在Android开发、Linux开发、web开发等场景成为最通行的版本管理工具，另外一些IDE集成开发环境也加入了Git，例如Android Studio, Intellij IDEA等。嵌入式开发常用的Keil也在keil5.15后也已经集成了版本管理工具，但是本文仍然是就Windows版Git管理Keil工程的示例，方便老版本的keil项目建立git管理。Keil5内集成的git的使用方法有机会再整理出来。

Git的实用性也逐渐带来了git托管平台的流行，如GitHub、GitLab、Bitbucket、Codeing.net、Gitee等。无数崇尚软件开源的开发者挥洒着汗水在这些平台上贡献了数以亿计的开源项目，使得咱们这些普通人可也以参与其中，接触到最前沿的技术、最酷炫的功能。身为一个开发者也要学会在开源代码上汲取这些全球精英所奉献的新知识新技能。

关于Git的使用方法，可以参考廖雪峰的git教程，深入浅出非常实用。在这篇文章中主要讲的是将一个既有的Keil工程加入git管理的方法。

可以去官网下载windows版本的git, https://git-scm.com/downloads

安装完成后，在开始菜单内找到Git Bash并启动。启动后的操作窗口类似于windows的cmd窗口。在bash窗口内可以执行Linux的一些shell指令。

安装完成后，还需要设置邮箱地址和用户名，在命令行输入：

$ git config --global user.name "Your Name"$ git config --global user.email "email@example.com"

因为Git是分布式版本控制系统，可以多人在一起开发。所以每次提交，每次上传，都会带有你这台电脑的标记——邮箱地址和用户名。

以/D/PROJ/project的一个keil工程为例。

1.进入工程所在的目录,使用ls指令查看是否正确的进入了目录。

xxxx@DESKTOP-TH28NBD MINGW64 /$ cd /D/PROJ/project/ xxxx@DESKTOP-TH28NBD MINGW64 /D/PROJ/project (master)$ lsinc/ Libraries/ README.en.md README.md RVMDK/ src/

在project的目录下可以看到.git的目录，该目录包含让 git 能够正常工作所需的所有信息。

Github和Gitlab是最流行的托管平台，由于众所周知的原因，这些国外的网站在国内的访问速度很不理想，国内使用推荐gitee码云或coding.net。以Gitee来举例。

Gitee免费版可创建 1000 个仓库，不限制公私有。单仓库大小上限为 500M，单文件最大 50M，用户总仓库容量为 5G。对于一般的keil嵌入式开发，免费版已经绰绰有余了。

1.注册Gitee，根据网站的提示完成注册。

2.配置ssh

本地Git仓库和Gitee仓库之间的传输是通过SSH加密的,所以需要配置ssh，使得托管平台认可你这台电脑的git操作。在Git Bash内执行以下指令创建SSHkey。

ssh-keygen -t rsa -C youremail@example.com

把邮件地址换成你自己的邮件地址，然后回车一路使用默认值即可。完成后在用户主目录里找到.ssh目录，里面有id_rsa和id_rsa.pub两个文件，这两个就是SSH Key的秘钥对，id_rsa是私钥，不能泄露出去，id_rsa.pub是公钥，可以发送给他人。

Windows的目录在c盘的用户目录内。

3.上传ssh公钥到码云

4.创建项目仓库

点击页面右上角的加号，并选择新建仓库。

1.添加远端地址

git remote add origin ssh地址如 git remote add origin git@gitee.com:xxxx/xxxx.git

ssh地址在gitee仓库页面点击“克隆/下载”按钮获取。

可以通过 git remote -v指令查看远端的连接。

$ git remote -vorigin git@gitee.com:xxxx/PROJECTTEST.git (fetch)origin git@gitee.com:xxxx/PROJECTTEST.git (push)

2.拉取远端版本到本地

拉取成功后，本地目录可以看到刚才创建gitee仓库时创建的Readme文件。

3.本地提交代码

将project内原有的代码，inc/ src/目提交到本地仓库。

git add src/git add inc/git commit -m “first commit”

注意不要讲编译生成的文件add进去，只将代码add进仓库。因为编译生成的文件每次编译都会变化，这样每次的版本提交都包含了这些非代码改变的提交，不仅会使得版本很混乱也会占用很多远程仓库的空间。当然这也可以通过增加gitignore文件的方法来处理。

4.推送本地仓库到远端

git push origin master$ git push origin masterEnumerating objects: 32, done.Counting objects: 100% (32/32), done.Delta compression using up to 8 threadsCompressing objects: 100% (31/31), done.Writing objects: 100% (31/31), 22.22 KiB | 2.78 MiB/s, done.Total 31 (delta 12), reused 0 (delta 0)remote: Powered by GITEE.COM [GNK-5.0]To gitee.com:xxxx/PROJECTTEST.git 4d112e2..ebaf8bd master -> master

直接git push会提示警告

$ git pushfatal: The current branch mater has no upstream branch.To push the current branch and set the remote as upstream, use

git push --set-upstream origin master

按照提示执行git push --set-upstream origin master，以后再推送版本，只需要输入git push就可以了。

至此，将一个现有的keil工程加入git管理，并在远端托管平台备份的操作都完成了，后面在这个工程上做开发并提交版本，就按照常规的git操作 git add、git commit、git push就可以了。本文开始提出的版本回退问题，只需要执行git reset –hard的指令，代码就自动回退到指定的提交点了。更多的git功能，开发者可以在后续的实际开发中不断学习完善，

/ The End /

本文系嵌入式案例Show原创出品，未经许可，请勿转载。