Android Studio上传Android项目到GitHub（最新）

---

前言

我们开发过程中提到最多的就是版本控制，以前公司用的是svn，它比较适合开发人数不多的项目，属于集中式开发，而git是分布式版本控制系统，强调的是个体，可以有效高速处理从小到大的项目版本管理。GitHub是代码托管平台，类似这样的还有很多，例如码云等，本文主要讲解如何将Android Studio项目通过Git上传至GitHub以及在此过程中遇到的一些问题解决。在操作过程中需要GitHub账号、Android Studio项目和Git，下面是所用到软件的版本：Android Studio 4.+ 、Git 2.31.+ 。

---

一、Git 安装配置

1：Git安装 下载。

这是个git镜像下载地址，里面包含了很多版本，我们可以选择最近日期的版本。下载得到的是.exe文件，双击.exe，然后选项默认就好，一直next， 记录下安装路径，默认安装在C:\Program Files\Git，你也可以指定安装路径，装完成后可以右键点击桌面，点击Git bash，输入git --version查看版本，如下图：

我们安装完Git后需要创建全局用户，可使用 git config --list 验证当前本地属性，而git config --local --list查看的是当前仓库或Project下的git信息。下面是几个比较常用的命令：
（1）修改当前的project的用户名的命令为：git config user.name target_username
（2）修改当前的project提交邮箱的命令为：git config user.email target_useremail
（3）如果需要修改全局下的用户名和用户邮箱，需要在上面的两条命令中添加一个参数，–global，代表的是全局。对应命令为：
git config --global user.name target_username
git config --global user.name target_useremail

2：Git与Android Studio关联

不得不说Android Studio对Git的支持还是很友好的，Git命令行基本操作都可以通过Studio来执行。

打开Android Studio
进入File–Setting–展开Version Control–Git
在Path to Git executable栏位输入安装Git的路径
如下图：
然后点击【Test】按钮，若出现Git的版本号，则说明配置成功，如下图：

这时我们已将Studio与Git相关联。

二、配置GitHub登录信息

还是在我们的Studio中，步骤：

进入File–Setting–展开Version Control–GitHub
点击面板的add account

出现如下图弹框：

这里输入你在GitHub上的账户密码，点击Log In，如果多次尝试依然链接不上github.com，可尝试右上角的Use Token方式登录

点击Use Token，如下图：

这里我们需要注意的是Token栏和红箭头部分，这两个是我们能否进行登录成功的关键，我们登录自己的GitHub，然后打开Settings–Developer settings --Personal access tokens ，如下图：

我们点击generate new token，出现如下界面：

Note描述Token用处，关键在于我们需要勾选的部分，刚刚Studio使用Token登录界面下方有一串中括号[]框起来的字符，如：gist, read:org, repo，这里我们需要勾选这几项给这个Token,自己可以在上图的勾选框找这几个选项，然后点击Create Token生成Token，这时我们看到页面生成了一个Token，如下图：
点击即可看到我们需要的Token值，这是一串字符，复制粘贴到我们的Studio里Token栏即可登录成功，面板上出现如下图GitHub账户信息：

三、上传项目到GitHub

进入VCS->Import into Version Control->Share Project on GitHub，如下图：

第一次创建项目会出现如下弹框：

我们可以编辑仓库名、是否是私有库、描述该项目等信息，至于Remote，默认就好。然后点击Share，会出现如下图：

这个就是我们需要上传的项目，但是我们一般需要设置忽略文件，说明哪些文件可不必上传，因为一些文件只是idea编译或其它无关的文件，对项目运行没影响，下面是.gitignore文件的书写：

.gradle
/local.properties
.DS_Store # only needed under mac os
/build
/captures
*.iml
.idea
*.apk #optional

当然你也可自己定义哪些文件忽略，具体可以上GitHub找几个大型开源项目，看看他们的.gitignore文件是怎样写的，有兴趣可以看看这个大神总结的：Android.gitignore，上传成功后可登录自己的GitHub查看刚刚上传的项目，如下图：

这里还有一点需要注意的是，Studio默认分支是master，而GitHub默认创建仓库主干是main，我们在上传项目时可以主动到GitHub上修改默认主干为master，如下图：

至此，项目就可比较完美地上传到GitHub仓库上，以后会出一篇项目开发中Android Studio 关于Git命令的使用！