TortoiseHg 学习笔记

向右看齐 2022-08-20 06:28 274阅读 0赞

**0.前言**

TortoiseHg是分布式的源码管理工具Mercurial的GUI客户端。 mercurial 作为3大主流的分布式源码管理工具，已经被广泛的使用。例如 googlecode.com和codeplex.com都支持mercurial作为源码管理工具。下面结合某个场景，叙述TortoiseHg的具体使用方法。

**1.假想场景**

【1】主管在版本库服务器中建立一个仓库，该服务器的IP地址为192.168.1.102，版本库服务器的端口为8000（默认）。

在版本库中只有一个main.c文件，main.c文件的内容如下

**\[cpp\]** [ view plain][view plain] [ copy][view plain]  [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#include <stdio.h>  
2.  int main(void) \{  
3.      printf("Hg Test\\n");  
4.  \}

【2】A男和B男分别clone版本库

【3】A男试图在main.c中min函数，B男试图在版本库中加入max函数。两人同时开始修改。

【4】B男似乎速度快一点，增加了max函数并提交。

【5】A男也完成了max函数，拉取版本库之后发现B男已经提交了一个版本，A男发现两个版本存在冲突。

【6】A男和B男相互沟通，决定同时保留min函数和max函数。

【7】A男使用合并工具完成合并并提交至服务器。

【8】B男拉取服务器内容，并进行更新。

最后A男和B男本地版本库中的内容完全相同，main.c中的内容变为

**\[cpp\]** [ view plain][view plain] [ copy][view plain]  [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#include <stdio.h>  
2.  int min(int a, int b) \{  
3.      return a < b ? a : b;  
4.  \}  
5.  int max(int a, int b) \{  
6.      return a > b ? a : b;  
7.  \}  
8.  int main(void) \{  
9.      printf("Hg Test\\n");  
10. \}

**【基本概念介绍】**

**【Init】** 初始化，创建一个空的仓库。

**【Clone】** 复制仓库，来源可以是一个http或ssh链接表示的仓库，也可以是本地仓库。

**【Commit】** 提交，即接受所有的改动将当前版本作为最新版本（也叫tip）。只**提交的本地仓库**，而且本地仓库会详细记录所有的变动（称为变更集或改动集）。多次提交并不会影响远程仓库。

**【Revert】**恢复，即撤销所有的改动，恢复到未更改的状态。

**【Pull】**拉取，将雅远程仓库有而当前仓库没有的变更集“下载”到本地仓库。不过这只是**添加了变更集**，**本地****文件并不会改动**。

**【Update】**更新，当获取了其他变更集，更改以保持和远程仓库一致**。**  
**【Push】**推送，将当前仓库的变更集“上传”到其他仓库去。

**【Merge】**合并。当一个文件同时被多次修改，并存放在多个仓库时，要获得一个统一的版本就需要合并。

**2.服务器搭建**

**【若干准备】**

创建一个名为main.c的函数，文件内容如下

\#include <stdio.h>

int main(void) \{

printf("Hg Test\\n");

**【建立仓库】**

在该文件所在目录，右击选择tortoiseHg -> create respository here（或在Hg workbench中操作）建立本地仓库。请注意首次创建的仓库为一个**空仓库**，可进行必要的提交工作。

![SouthEast][]

图2.1 建立本地仓库

![SouthEast 1][]

图2.2 建立本地仓库

**【首次提交】**

进行提交操作时，需要首先选中最新版本，接着选择需要跟踪文件，然后编写必要的修改说明，最后点击提交按钮。请注意提交操作仅仅提交到本地仓库，若要使远程仓库产生变化需要进行下一步推送操作。（由于此处为服务器并没有推送目标，所有没有推送操作，但是相对于下文提到的A男和B男情况就不一样了。）

![SouthEast 2][]

图2.3 首次提交

![SouthEast 3][]

图2.4 提交之后结果

**【修改服务器设置】**

选择server选项，修改全局参数和该仓库参数。其中取消SSL加密推送，并**允许他人推送**。为了简单说明问题，全局参数和该仓库设置相同。在该项设置中默认的端口号位8000，也可以使用其他端口号，请一定要避免知名端口号。

![SouthEast 4][]

图2.5 修改全局设置

![SouthEast 5][]

图2.6 修改本地仓库设置

**【启动服务器】**

在tortoiseHg中选择【仓库】->【web server】

![SouthEast 6][]

图2.7 启动webserver

**3.B男操作过程**

**【过程概述】——clone远程仓库至本地->修改源代码->本地提交Commit->拉取远程代码pull->合并merge或更新update->推送到远程仓库push**

**【clone过程】**

新建一个**空文件夹(必须为空文件夹)**，在空文件中右击，选择**TortoiseHg->Clone**。源地址中输入远程仓库URL，例如远程仓库服务器的IP地址为192.168.1.102，Hg仓库的端口号为8000。那么远程仓库的URL可写为：

http://192.168.1.102:8000/

![SouthEast 7][]

图3.1 clone操作

**【修改代码】**

修改源代码，增加一个max函数，修改之后的main文件如下所示。

**\[cpp\]** [ view plain][view plain] [ copy][view plain]  [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#include <stdio.h>  
2.  int max(int a, int b) \{  
3.      return a > b ? a : b;  
4.  \}  
5.  int main(void) \{  
6.      printf("Hg Test\\n");  
7.  \}

**【本地提交】**

在界面的右下角可看到代码的变化情况，+号代表增加。

![SouthEast 8][]

图3.2 本地提交

**【拉取操作】**

由于A男没有提交代码到远程仓库，所有此时B男拉取时提示没有任何更新内容。

**【推送操作】**

B男执行推送操作，那么远程仓库发生了变化。（此时A男也有可能在编写代码，但是他并没有完成代码本地提交和推送操作，那么A男拉取时之后，需要和他本地的代码进行合并，然后再进行推送操作。虽然此处B男的拉取和推送操作非常简单，但是没有任何代表性，请关注下文A男的操作）

![SouthEast 9][]

图3.3 拉取并推送到远程仓库

**【必要的检查】**

通过网页查看推送是否成功，请输入远程仓库URL 192.168.1.102:8000。

![SouthEast 10][]

图3.4 必要的检查

**4.A男操作过程**

**【本地克隆】**

和B均操作相同

**【修改代码】**

增加min函数。

**\[cpp\]** [ view plain][view plain] [ copy][view plain]  [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#include <stdio.h>  
2.  int min(int a, int b) \{  
3.      return a < b ? a : b;  
4.  \}  
5.  int main(void) \{  
6.      printf("Hg Test\\n");  
7.  \}

**【本地提交】**

![SouthEast 11][]

图4.1本地提交

**【拉取操作】**

A男发现B男已经提交了一个版本，需要进行代码合并。

![SouthEast 12][]

图4.2 拉取操作

**【合并操作】**

合并操作可借助合并工具，但是在合并之前还是和同事沟通一下。合并一般发生在两个人同时修改了同一个文件。

![SouthEast 13][]

图4.3 合并操作

同一个文件中在两个分支中出现修改，已经无法自动合并需要进行下一步手动合并。

![SouthEast 14][]

图4.4 合并操作

选择合并工具并开始合并，TortoiseHg会添加在系统中安装的合并工具，例如Bcompare或者winmerge。在界面中选择Tool Resolve使用工具解决合并，Take Local选择本地文件，Take Other选择远程文件（相当于放弃了本地修改）。建议选择使用工具合并同时和您的同时好好沟通一下，如何合并。

![SouthEast 15][]

图4.5 合并操作

使用合并工具时，左侧为远程内容，右侧为本地内容。虽然合并工具提示仅存在很小的差异，例如min和max，<和>。但是如果有效沟通一下的话便会发送实际上应该增加一个函数，需要把max函数复制到本地已完成合并。

![SouthEast 16][]

图4.6 使用工具完成合并

合并完成，编写必要的修改说明。

![SouthEast 17][]

图4.7 提交必要的合并说明

**【推送操作】**

![SouthEast 18][]

图4.8 推送操作

**【检查结果】**

![SouthEast 19][]

图4.9 必要的检查

**5.B男再次操作**

**【拉取操作】**

此时B男发现远程服务器存在变更，需要进行合并或更新。

![SouthEast 20][]

图5.1 拉取操作

**【更新操作】**

此时B男只需要进行更新操作即可，及时进行合并操作Hg也会提示没有任何可以合并的内容。此时B男只需要通过更新update和服务器保持一致即可。【小技巧，可优先进行合并操作，若提示没有任务合并内容便使用更新操作】

![SouthEast 21][]

图5.2 更新操作

最后A男和B男的本地仓库中，main.c的内容完全相同。

**6.ubuntu中使用**

【1】安装过程

依次输入以下指令：

sudo add-apt-repository ppa:tortoisehg-ppa/releases

sudo add-apt-repository ppa:mercurial-ppa/releases

sudo apt-get update

sudo apt-get install mercurial python-nautilus tortoisehg

【2】使用界面

使用界面和windows相同，仅缺少右键快捷菜单。

![SouthEast 22][]

图6.1 ubuntu中TortoiseHg界面

[view plain]: http://blog.csdn.net/xukai871105/article/details/25649331#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/401589
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/401589/fork
[SouthEast]: /images/20220731/21812144c796408784d66fda5175888b.png
[SouthEast 1]: /images/20220731/cec719864d0a47a9abfa51a4ddb7249a.png
[SouthEast 2]: /images/20220731/5a901165b1ee42a482427d0bdb400a1b.png
[SouthEast 3]: /images/20220731/099f484da5dd4942b2e39806785721e7.png
[SouthEast 4]: /images/20220731/1decb75e0d16440abcdc100dfc87530e.png
[SouthEast 5]: /images/20220731/3d8056d73f574e9b9f2a204f4dc43349.png
[SouthEast 6]: /images/20220731/a239527696a04420adc3c0e405ae6086.png
[SouthEast 7]: /images/20220731/ca7a633d4f844e0e8fb09e6efd12ef72.png
[SouthEast 8]: /images/20220731/fd5f94e699054e16b1b29f792c0d4e2a.png
[SouthEast 9]: /images/20220731/124a01c471f64477a607959d3658aadf.png
[SouthEast 10]: /images/20220731/bce598676b724b9883b48640bd5b91e9.png
[SouthEast 11]: /images/20220731/db3104593bb84bfdb60d20e5d60e5ca8.png
[SouthEast 12]: /images/20220731/175ef372501f4088a29496af5fe00aec.png
[SouthEast 13]: /images/20220731/7bd11456a25f4444b03c93bfad5cceff.png
[SouthEast 14]: /images/20220731/e51fe80b3202451b95b52d46d47ea341.png
[SouthEast 15]: /images/20220731/4ff325681eef4157b529834a5a2e017e.png
[SouthEast 16]: /images/20220731/d83bebdea375406c95ec86a867fec1ea.png
[SouthEast 17]: /images/20220731/c7fdc85a8d6a4087b689d1eee490983e.png
[SouthEast 18]: /images/20220731/8a9b5bc247e8418f98689a32df713ffc.png
[SouthEast 19]: /images/20220731/7f2af5923c9146a08494ca886df5ddd2.png
[SouthEast 20]: /images/20220731/4df2db15b152484082ae7c433ca0934d.png
[SouthEast 21]: /images/20220731/06f60626a02f4494b7898818499c44de.png
[SouthEast 22]: /images/20220731/93e250bd26bf408d9685c672a7c6e991.png