GitHub开发环境搭建方法

GitHub开发环境搭建方法

一、GitHub是个啥东东？

百度解释：GitHub 是一个面向开源及私有软件项目的托管平台，因为只支持 Git 作为唯一的版本库格式进行托管，故名 GitHub。
通俗解释：提供给个人或者小型企业的git管理平台。
应用情景：如果是从事单片机工作的小公司，开发人员几个人或者一个人，没有代码的管理规范。但是当开发一套大型的软件，软件版本的控制，代码使用权限，多人协作就尤为重要。而此时大公司会搭建自己的配置服务器，有自己的配置管理人员，而且代码都会有保密的协议。还有另一类需求，多人有共同爱好，用业余共同开发一套软件系统，大家又不在一个城市，而对代码的安全性又没有那么保密的要求，这时我们就可以使用GitHub了，其它提供免费与收费服务。免费就是代码要开源，任何国家，任何人都以看你的代码，fork你的代码。

二、GitHub注册

1、注册用户。GitHub官方网址
2、若自己有账户，填写账号密码登录.

3、登录后需要设置几个地方。
（1）完善个人信息
（2）完善Email地址，设置优先级（Primary）这个一定要填。

三、GitHub配置

1、创建自己的代码仓库（New repository）,就相当于在GitHub云端创建一个存储代码的位置。


2、配置Ubuntu下的git配置

• (1)使用apt 安装git：

$ sudo apt-get update  
$ sudo apt-get install git  

• (2)配置你的github：

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

• (3)查看配置信息：

$ git config --list  

• (4)编辑配置信息：

$ gedit ~/.gitconfig  

• (5)修改：

[user] 
name = Your Name 
email = youremail@domain.com

• (6)创建公钥：

$ ssh-keygen -C 'you email address@gmail.com' -t rsa  

这会在 用户目录 ~/.ssh/ 下建立相应的密钥文件。

• (7)上传公钥:
  在 github.com 的界面中 选择右上角的 Account Settings，然后选择 SSH Public Keys ，选择新加。
  Title 可以随便命名，Key 的内容拷贝自 ~/.ssh/id_rsa.pub 中的内容，完成后，可以再使用。
  

$ ssh -v git@github.com 

进行测试。看到下面的信息表示验证成功。

OpenSSH_5.9p1 Debian-5ubuntu1.10, OpenSSL 1.0.1 14 Mar 2012
:
:
:
Transferred: sent 2936, received 1816 bytes, in 0.5 seconds
Bytes per second: sent 5600.4, received 3464.0
debug1: Exit status 1

四、GitHub的使用

按照第三节的第一小节，我们已经完成仓库的建立，接下来需要初始化我们仓库（将代码上传到仓库），介绍两种方法初始化仓库：

• 方法一
  进入到工程目录下，我的工程目录名mx257_uboot:
  
  （1）执行如下命令，新建readme，初始化本地仓库。

touch README.md
git init

会在mx257_uboot目录下生成.git目录。

（2）执行如下命令，当前目录（mx257_uboot）所有文件添加到本地库中。

git add *

（3）执行如下命令，提交本地仓库修改。这个是提交到本地库的标识，也可以自己新建个模板来提交。

git commit -m 'initial project version'

（4）执行如下命令，获取远程地址，将本地代码库修改push远程（GitHub）仓库上。

git remote add origin git@github.com:runtimeco/mcuboot.git
git pull origin master   ##从远程库跟新代码
git push -u origin master   ##推送代码到远程代码库

其中这个git@github.com:runtimeco/mcuboot.git，可以从如下获得：

如果提交成功，会有如下信息显示

To https://github.com/xxxxxxx/xxxxxxxe.git
   e52efc0..08bb67c  master -> master

如果URL（git@github.com:runtimeco/mcuboot.git）加错误了，可以使用如下方法修改：

1. 修改命令 
git remote set-url origin URL(新) 
2.先删后加 
git remote rm origin 
git remote add origin git@github.com:Liutos/foobar.git 
3. 直接修改config文件

• 方法二
  直接从网上获取项目地址获取代码。

    git remote add origin git_address   
       #git_address即现有仓库的地址
       #如 git@github.com:TimorChow/baike_spider
    git push -u origin master

  常用指令操作

   #更新文件
　　vi README

　　#自动commit更改文件
　　git commit -a

　　#更新至远程
　　git push origin master


　　#创建和合并分支
　　git branch

　　#显示当前分支是master
　　git branch new-feature

　　#创建分支
　　git checkout new-feature

　　#切换到新分支
　　vi page_cache.inc.php
　　
　　git add page_cache.inc.php

　　#Commit 到本地GIT
　　git commit -a -m "added initial version of page cache"

　　#合并到远程服务器
　　git push origin new-feature

　　#如果new-feature分支成熟了，觉得有必要合并进master
　　git checkout master

　　git merge new-feature

　　git branch

　　git push

五、总结

　　GitHub也具备windows版本使用，操作比较简单，提供了图形化的操作界面，很直观的看到差异，比较适合单片机的开发使用。git指令很多，公司内一般会设置配置管理工程师职位，平常工作也需要工程师学会git的基本操作指令，以便顺利的完成工作。

---

参考文档
[1]: Ubuntu 中github的配置和使用
[2]: Ubuntu环境下GitHub安装与使用
[3]: github 在ubuntu 使用
[4]: github常见操作和常见错误！
[5]: How To Use Git Effectively