Github入门使用教程，并托管Android项目

转载请注明出处：http://blog.csdn.net/sinat_14849739/article/details/78907640
本文出自Shawpoo的专栏
我的简书：简书

一、准备工作

准备工作其实很简单，只需要在我们的操作系统上安装好Git客户端，有一个Github账号即可。下面具体来说一下：

1、安装Git客户端

首先需要在电脑上安装Git客户端，来个Git的传送门，选择相应的操作系统，下载即可。

安装过程就不截图了，一直Next即可安装成功。

安装成功可以配置环境变量，在Path中添加git的bin目录即可：

配置好环境变量后，我们可以通过cmd命令输入git version来查看git的安装版本，如果正常显示，则配置成功。

2、注册Github账号

Github账号的话，这个就更简单了，仍然来个传送门。只要三步，填写账号密码用户名，然后选择一下免费仓库，当然你可以选择每月几美元的私有仓库，然后邮件确认即可完成注册。步骤很简单，这里就不在截图了。

二、使用Github

1、登录Github

在Github登录页，填写用户名、邮箱和密码进行登录。

2、创建仓库

点击左下方New repository按钮新建一个仓库：

需要填写的东西，通过下面一张来解答，填写完成之后，最后点击Create repository按钮确定创建此仓库。

这样的话，我们就创建好了仓库，并且可以通过Github的域名加上自己的用户名和项目名就可以直接访问了。

3、生成SSH密钥

创建好仓库之后，可以通过点击Clone or download按钮进行克隆或下载项目。点击之后我们发现有两种克隆方式，一种是HTTPS方式，一种是SSH方式。这两种方式都可以克隆，但是前者在对仓库中的文件进行操作时，每次都需要登录验证，但是后者的话只需要一次验证即可。所以我们要在本地生成一个SSH密钥来避免账户的重复验证。

接下来运行git的git-bash.exe程序进入命令行模式，进行以下设置：

• 1、设置git的username和email

  设置username和email

  $ git config --global user.name "用户名"
  $ git config --global user.email "邮箱"

  查看设置的username和email(不加用户名和邮箱即为查看)

  $ git config --global user.name
  $ git config --global user.email

  

• 2、查询本地是否存在ssh密钥

  $ cd ~/.ssh

  如下图所示这种情况，显示No such file or directory，则说明本地不存在ssh密钥。

• 3、生成ssh密钥对

  输入以下命令生成ssh密钥：

  $ ssh-keygen -t rsa -C "邮箱"

  执行命令之后按3次回车，这里的密码一般为空即可。
  

  同时会在本地C盘用户的目录下生成一个.ssh的文件夹，里面包含id_rsa和id_rsa.pub两个文件。

  

• 4、添加公钥到Github账户

  a、生成密钥对之后，需要将公钥添加到Github账户，首先点击账户下的Settings选项。

  

  b、选择左侧的SSH and GPG keys选项，点击右侧的New SSH key按钮，下面的SSH keys是另一台电脑添加的，这里我们再添加一个就可以了。

  

  c、填写SSH keys的名称和本地公钥文件(id_rsa.pub)的内容：

  

• 5、测试密钥，连接Github

  $ ssh -T git@github.com

  如下图，表示SSH keys生效。
  

4、使用Github

• 1、克隆项目

  克隆项目的方式有两种，一种是HTTP方式，另一种是SSH方式，既然我们已经配置了SSH keys，那么就采用SSH方式进行克隆：

  SSH方式：$ git clone git@github.com:用户名/xxxxx.git
  HTTPS方式：$ git clone https://github.com/用户名/xxxxx.git

  

• 2、简单的git操作

  克隆之后我们可以对仓库(项目)进行操作了，这简单的介绍几条git命令：
  例如在仓库中添加一个test.txt的文件并同步到Github上。

  

  可以通过以下命令完成：

  $ git add .     // 添加文件或文件夹到版本控制(注意后面的点)
  $ git commit -m "commit message"   // 提交改动的文件
  $ git push origin master  // 将改动的文件推送(同步)到master上

  

  这时候刷以下Github的仓库，会发现我们提交的文件已经上去了：

  

  当然我们可以删除这个文件，通过文件管理器删除后，进行查看状态，然后通过命令删除，删除之后仍然是commit和push。

  $ git status  // 查看文件的状态
  $ git rm test.txt // 删除文件
  
  $ git commit ...  git push...

  

  到这一步其实基本Git + Github就入门会用了，接下来的话应该需要补习Git命令了，或者不想使用命令的话，我们也可以使用SourceTree等这种可视化工具进行操作。《Git教程》的话，可以学习廖雪峰老师的。

三、使用Android Studio上传项目到Github上

有了前面的基础后，我们现在就可以在Android Studio上创建项目并托管到Github上，托管后就和我们平时开发项目一样了。仍然是先commit后push。

• 1、创建项目，添加忽略文件

  首先创建一个项目或者使用现有的项目，然后添加git的忽略文件，这个在平时项目协作的时候也是需要的，这里就不多说了。提供有一份Github选择Android项目后自动生成的.gitignore文件 ，因为比较全面详细，可以直接使用。

  
  # Built application files
  
  *.apk
  *.ap_
  
  
  # Files for the ART/Dalvik VM
  
  *.dex
  
  
  # Java class files
  
  *.class
  
  
  # Generated files
  
  bin/
  gen/
  out/
  
  
  # Gradle files
  
  .gradle/
  build/
  
  
  # Local configuration file (sdk path, etc)
  
  local.properties
  
  
  # Proguard folder generated by Eclipse
  
  proguard/
  
  
  # Log Files
  
  *.log
  
  
  # Android Studio Navigation editor temp files
  
  .navigation/
  
  
  # Android Studio captures folder
  
  captures/
  
  
  # Intellij
  
  *.iml
  .idea/workspace.xml
  .idea/tasks.xml
  .idea/gradle.xml
  .idea/dictionaries
  .idea/libraries
  
  
  # Keystore files
  
  *.jks
  
  
  # External native build folder generated in Android Studio 2.2 and later
  
  .externalNativeBuild
  
  
  # Google Services (e.g. APIs or Firebase)
  
  google-services.json
  
  
  # Freeline
  
  freeline.py
  freeline/
  freeline_project_description.json

• 2、添加项目到版本控制

  a、菜单栏中：VCS->Enable Version Control Integration：

  

  b、选择Git，点击“OK”，然后会出现Update Project和Commit Changes两个按钮。

  

  

• 3、配置Git和Github账号

  a、配置Git，Setting->Git，配置git.ext的目录，然后点击“Test”按钮是否可用。
  

  b、配置Github账号， 首先在Setting->Github：第一次的话我们可以先创建API Token。

  

  输入Github的账号和密码，点击“Login”会自动生成Token。

  

  然后点击右边的Test按钮测试是否可以连接成功。
  

• 4、上传项目到Github

  a、菜单栏中：VCS->Import into Version Control->Share Project on Github，共享项目到Github上。

  

  b、创建仓库，填写仓库名称和描述。一般使用Github都为公开仓库，所以无需勾选右侧的“Private”选项。点击“Share”按钮确定创建仓库。

  

  c、编写commit message，点击“OK”。再次输入账号密码就可以成功上传了。

  

  上传成功后，我们可以直接在Github上看见创建好的仓库了：

  

  d、修改文件， 再次填写Commit Message，然后选择Commit and Push即可上传代码成功。

  

  

  

  好了，其实到这一步，就和我们平时开发项目的操作一样了。

如有错误或建议，欢迎批评指教哈 。