git 添加外部项目地址

github 提交第三方模块流程

// git config --global user.name ‘your name‘ 可以设置全局用户名，在commit记录里显示的是这个配置设置的名称。

// git config --global user.email ‘your email‘ 可以设置全局用户邮箱。

// git config user.name 可以查看当前设置的用户名

一、模块的创建及更新

1.创建模块

--新建一个github仓库repository，比如：git_submodule

--新建文件夹，比如：learngit

--进入到文件夹中，打开git bash

2.开发模块内容

--git clone git_submodule 的url地址，将创建的项目克隆到本地

--编辑项目内容，比如：新建一个txt文件，并填入一些内容。

3.提交修改本地

--cd 到子模块文件夹中

--git status 查看修改

--git add . ，将所有改动添加到缓存区中

--git status，查看添加的状态

--git commit -m ‘creat new .txt file‘, 提交并对更改进行说明

4.首次更新到远程

--ssh-keygen -t rsa -C "[email protected]"，在本地创建公钥。

（email地址改成自己的github邮箱地址）

--把C:\Users\Administrator\.ssh中，id_rsa.pub公钥中的内容添加到github。（titile随便写）

--git remote add origin [email protected]:asd571362/git_submodule.git，

（替换成自己的用户名和项目名），关联远程仓库。

如果已经存在，执行git remote rm origin，再执行上一步。

-- git push --set-upstream origin master，首次推送并设置关联远程master分支

5.模块后续更新。

--执行2、3步骤，略过第4步。

--git pull,查看是否有冲突,如有冲突，进行修改。然后重新执行2、3步骤。

--git push 推送更新到远程。

二、作为子模块集成及更新到第三方平台

1.fork 平台项目

--到对应的平台项目页面，点击fork

2.子模块集成到平台

--git clone fork后的url地址

--git submodule add 子模块地址平台子模块文件夹/git_submodule , 平台子模块文件夹为平台中第三方模块添加的位置，不同平台可能不一样，以平台说明为准。

--git status 查看仓库状态

--git commit -m ‘add git_submodule‘

--git remote add origin [email protected]:asd571362/JS.git,首次关联远程仓库

--git push --set-upstream origin master,首次提交到远程仓库

--提交成功后，在平台子模块文件夹中出现了git_submodule模块，

@后面的是当前子模块指向的commit版本号

--点击pull request 提交更新请求，平台维护方同意后就可以出现在平台源地址。

3.子模块更新到平台

--子模块更新必须对接平台的最新版本，可以删除重新fork。(也有其它设置的方法，但是重新fork比较简单)

--git clone fork后的url地址

--cd 到子模块的父文件夹

--git submodule init 子模块名称，初始化子模块（只添加子模块版本的指针，文件夹是空的）

--git submodule update 子模块名称，更新平台中的子模块文件到本地

-- cd git_submodule/，进到子模块分支显示的是之前指向的版本号。

--git checkout master ，切换到主分支

--git pull ,查看是否有冲突

--git merge origin/master 合并远程分支

--cd .. ，git status,回到上层目录，查看仓库状态

--git pull , git add . ,git commit -m ‘update git_submodule‘

--git push, 成功后fork的项目中子模块的版本会更新到最新版本

最后，pull request。

待解决：每次重新克隆后，push失败，需要重新关联remote项目？

git submodule使用以及注意事项

一、背景

在平时的软件开发过程中常常会有这样的场景，自己负责的某个模块会依赖其他模块或者第三方的library。这时你自己的模块是一个独立的代码仓库，你想要实现这样一种功能，当你从你的模块的代码仓库里把代码拉到本地来的时候，能自动的将你依赖的模块或第三方库都拉到指定的目录当中去。

当然要实现这个功能的方法有很多，比如使用repo之类的工具，又比如如果你使用的是svn作为版本管理工具，那么你可以使用svn的external机制来引用第三方的project。

这里要说的是使用git作为版本管理工具的情况。

二、git submodule

其它的细枝末节就不再赘述了，咱直奔主题。

先来看具体用例：

目前有一个模块A，其代码仓库的地址为：projectA.git，它需要引用另一个模块B, 其代码仓库的地址为：projectB.git。

假设模块A的本地目录为：projectA

希望引用模块B为模块A的子模块，其在模块A目录下的路径为： projectA/projectB

这里我们通过git 的submodule机制来实现。

比如在命令行里可以直接使用如下命令：

cd projectA
git submodule add projectB.git projectB

注：这个submodule的子目录指定时不能以 “/”结尾，比如上面的命令，就不能写成 projectB/ 这个样子。

就这么简单的一句git命令就可以搞定了，当然这还没完，运行完这个命令之后，在projectA目录执行git status命令，可以看到如下的结果：

这时需要使用git commit命令和git push命令，将添加模块B为模块A的子模块的结果push到模块A的代码仓库里面去。

三、git clone包含子模块的代码仓库

此时，就可以使用git clone命令来抓取模块A的代码仓库，但要同时抓取到子模块的仓库的话，还需要一些方法：

正常的使用git clone命令，然后再使用 git submodule init 和git submodule update来获取子模块

git clone projectA.git
cd projectA
git submodule init
git submodule update

其运行结果如下：

在使用git clone命令时，加上–recurse-submodules或–recursive 这样的递归参数

git clone --recursive projectA.git

其运行结果如下：

四、tortoisegit操作submodule

如果是使用tortoisegit的话，也可以使用图形化界面进行submodule的相关操作，如添加submodule就选择如下图所示的菜单：

添加子模块的界面大概就是下面这个样子：

这里和上面一样“path”一栏不能以”/”结尾。填写之后，点击OK，就会在主模块的目录下添加对应的子模块。

在clone时也是一样的，它既可以只是clone，然后用上面菜单中，Submodule Update 选项来抓取子模块的内容，也可以在clone时选择递归参数，如下所示：

五、忽略submodule中的修改或新增文件

我们引用第三方的project，大多数情况都是想以“只读”的方式引用，不关心第三方project抓取下来之后是不是被修改，或者是在其目录中添加了untracked的file，因为我们只是拉取第三方的project，而不会(往往时不能或不允许)对第三方project进行提交。

以上面的模块A和模块B的例子来说，如果模块A和模块B中都有进行修改，其结果可能就是如下这个样子：

这并不是我们想要的结果。一开始的时候我的想法是使用 .gitignore 来忽略submodule的修改，但是无法做到，后来经过一番搜索，终于找到了解决良药。在添加了submodule之后，project的目录下回生成一个.gitmodules文件，这个文件记录了子模块的路径和仓库地址等信息，如下图所示：

我们要做的就是在[submodule “projectB”]中添加一个ignore子项，这个ignore子项可以有上个可选的值，untracked, dirty和all, 它们的意思分别是：

untracked ：忽略在子模块B(也就是projectB目录)新添加的，未受版本控制内容
dirty ：忽略对projectB目录下受版本控制的内容进行了修改
all ：同时忽略untracked和dirty

这里我们先选择dirty(至少先保证不提交对子模块B的任何修改)，其他的可以根据具体需求来进行选择。

添加ignore子项之后的.gitmodules文件的内容如下所示：

然后我们再使用git status查看，可以得到图下结果：

可以看出，之前 “modified: projectB(modified content)” 已经不见了，此时对修改后的.gitmodules文件进行commit和push，之后在查看status或做commit时就可以忽略掉对子模块B修改的部分了。

如何将Android studio中的项目导入到第三方的git托管库中

准备工具

git

我们需要在git官网下载最新的git工具，并且将其配置到环境变量中
第三方代码托管的网站
如GitHub，coding，码云等

本篇文章我将以coding作为例子

新建项目

假设此时你已经下载并安装好了git，也在coding上注册了账号。

那我们点击coding上的创建项目

输入好项目名称，然后添加项目描述，在选择私有项目和公开项目的时候注意下，如果不是银牌会员以上，在coding上只能创建5个私有项目，当然，你也可以不花钱，升级成银牌会员，然后就可以有10个私有仓库了。不过公开项目倒是可以无限创建。

所有都输入完毕后，我们点击新建项目，之后会来到以下界面

初始化本地仓库

现在我们电脑上已经有一个Android studio项目了，我们要怎样将电脑本地的项目上传到已经准备好到代码托管库中呢

首先我们通过cmd中的cd命令进入到我们的项目中，使用如下命令将我们本地的项目变成有git仓库的项目

git init

使用完该命令后，本地项目会多出一些文件

其实使用了git init命令后，本地已经是一个git仓库的状态了，已经可以正常使用git了，所以我们使用以下命令，将当前所有的代码都添加到本地仓库中

git add *

然后做一次提交操作，将代码都提交到仓库中

git commit -m "首次提交"

现在，我们将本地仓库和coding上到仓库做一个绑定处理

其实怎么绑定，在coding上创建项目的时候，coding都告诉我们了

我们只需要顺序使用这两行命令就搞定了

git remote add origin https://git.coding.net/用户名/项目名.git
git push -u origin master

这样，我们本地已经存在的Android项目就已经和coding上我们创建的项目仓库绑定了。

我们去检查一下coding上有没有我们的代码

看来已经绑定成功了！

使用

让我们来使用一下，首先我们使用Android studio打开我们的项目，然后我们会发现工具栏上会多出这些图标，我用的Android studio3.1.2，不同的版本可能图标形状会不一样，这个形状是我最近升级后的新图标。不过位置都在这里。

打开Android studio后，可能会提醒出现一个提醒框，大概意思是，是否新增的文件都自动add，这里推荐自动add。

原来的工具栏

现在的工具栏

新建文件

在studio上新建一个文件，如果在最开始都提示框选择的是默认添加，那么新建的这个文件就会是绿色，否则就是红色。

如果是红色怎么办呢，那么我们就要自己手动添加一下，方法如下：
提交文件
有了Android studio的协助，提交文件变得十分简单

方式1：

方式2：

然后（刚刚提交A的时候忘保存截图了，所有新建了个B文件）

这样文件就保存了
上传文件
其实到这里，本地的仓库就OK了，那么我们现在需要将本地仓库提交到远程的coding上的仓库中，如果觉得下图找起来太麻烦，studio有提供快捷键，还是很方便的。

然后来到这里

点击push，就可以将代码上传到远程仓库中啦！