GitHub 是全球最大的代码托管网站,主要是借助 Git 来进行版本控制的。任何开源软 件都可以免费地将代码提交到 GitHub 上,以零成本的代价进行代码托管。GitHub 的官网 地址如下: https://github.com/ 官网的首页如图 14.1所示。
首先你需要有一个 GitHub账号才能使用 GitHub的代码托管功能,点击 Sign up for GitHub按钮进行注册,然后填入用户名、邮箱和密码,如图 14.2所示。
点击 Create an account按钮来创建账户,接下来会让你选择个人计划,收费计划有 创建私人版本库的权限,而我们的酷欧天气是开源软件,所以这里选择免费计划就可以了, 如图 14.3所示。
接着点击 Finish sign up 按钮完成注册,就会跳转到 GitHub 的个人主界面了,如图 14.4 所示。
然后我们可以点击右下角的 New repository按钮来创建一个版本库,这里将版本库命 名为 coolweather,然后选择添加一个 Android 项目类型的.gitignore 文件,并使用 Apache v2 License来作为酷欧天气的开源协议,如图 14.5所示。
接着点击Create repository按钮,coolweather这个版本库就创建完成了,如图14.6 所示。版本库主页地址是 https://github.com/tony-green/coolweather。
可以看到,GitHub已经自动帮我们创建了.gitignore、LICENSE 和 README.md这 三个文件,其中编辑 README.md文件中的内容可以修改酷欧天气版本库主页的描述。 创建好了版本库之后,我们就需要创建酷欧天气这个项目了。在 Eclipse 中新建一个 Android 项目,项目名叫做 CoolWeather,包名叫做 com.coolweather.app,仍然使用 的是 4.0 的 API,如图 14.7所示。
之后的步骤不用多说,一直点击 Next就可以完成项目的创建,所有选项都使用默认的 就好。 接下来的一步非常重要,我们需要将远程版本库克隆到本地。首先必须知道远程版本库 的 Git地址,可以在酷欧天气版本库主页的右下角找到,如图 14.8所示。
点击右边的复制按钮可以将版本库的 Git地址复制到剪贴板,酷欧天气版本库的 Git地 址是 https://github.com/tony-green/coolweather.git。然后打开 Git Bash 并切换到 CoolWeather的工程目录下,如图 14.9所示。
接着输入 git clone https://github.com/tony-green/coolweather.git 来把远程版 本库克隆到本地,如图 14.10 所示。
看到图中所给的文字提示就表示克隆成功了,并且.gitignore、LICENSE 和 README.md这三个文件也已经被复制到了本地,可以进入到 coolweather目录,并使用ls –al命令查看一下,如图 14.11所示。
现在我们需要将这个目录中的所有文件全部复制到上一层目录中,这样就能将整个 CoolWeather 工程目录添加到版本控制中去了。注意.git 是一个隐藏目录,在复制的时候 千万不要漏掉。复制完之后可以把 coolweather 目录删除掉,最终 CoolWeather 工程的 目录结构如图 14.12所示。
接下来我们应该把 CoolWeather项目中现有的文件提交到 GitHub上面,这就很简单 了,这里我直接用图文提交即可,先add再commit 最后提交,也可以用命令操作:
git add . 将所有文件添加到版本控制中
git commit -m "First commit." 然后在本地执行提交操作
git push origin master 最后将提交的内容同步到远程版本库,也就是 GitHub上面
注意,最后一步的时候 GitHub要求输入用户名和密码来进行身份校验,这里输入我们 注册时填入的用户名和密码就可以了,如图 14.13所示。
这样就已经同步完成了,现在刷新一下酷欧天气版本库的主页,你会看到刚才提交的那 些文件已经存在了,如图 14.14 所示。