THG使用图文教程.doc

（0） HG VS SVN如果你从来没有用过TSVN来管理自己的游戏项目，可以跳过本文档。THG和TSVN都属于“乌龟”家族，风格相差不大，相比起另外一个程序猿最爱的版本控制工具GIT（命令行，纯的），拥有图形化界面，更容易上手。为什么要从SVN换到HG呢，简单的理由有以下几条：1. 上传下载修改都会自动压缩，速度更快，不容易断线。2. SVN会在你的每个文件夹下都建立一个隐藏目录，用来记录修改信息，非常烦人。而HG只会在根目录下建立一个。这意味着HG的文件夹非常干净，“导出”之类的无聊操作再也不需要了。3. 你的每次“提交”都可以被记录，但是不必“推送”到服务器上。对于习惯做很多次微调修改再上传的人，只有“提交”概念的SVN多数时候是废的。但是HG可以让你在本地疯狂修改，提交无数次，享受SVN备份、回滚等等的优势，等觉得满意之后再“推送”到服务器上。4. 按行记录具体修改内容，自动合并功能强大，出现冲突的可能性比SVN降低很多。（1）准备工作TurtoiseHG下载地址：/download/index.html1. 根据自己的系统是32位还是64位选择一个安装2. 注册一个支持HG（又叫做Mercurial，总之都是水银的意思）的代码托管服务，这里推荐使用bitbucket /3. 自己建一个实验工程，或者把ID告诉建工程的人，给你的ID增加修改权限Bitbucket支持私人工程和开源工程两种，都是不限制空间和工程数目的。但对免费注册的ID创建的私人工程，修改权限最多只能给5个人，再往上就要收费了。（虽然通常同人游戏组应该也用不到5个）新建工程的办法：这里选择Repositories-Create Repository。勾选Private就是私人工程，否则就是开源的。Language随便选个啥吧。反正没有KR和RM。Project Management部分提供了Issue tracking和Wiki，就是BUG回报和文档之类的服务，一般来说小的私人工程大概是用不到的。填完之后点下面的Create Repository。点进新建的工程会看到bitbucket很贴心的帮你把获取代码的命令行都写好了。虽然我们用的是图形界面，所以命令行什么的无视，复制这个URL地址就好。（2）从服务器上获取代码SVN叫“检出（checkout）”，而HG叫“克隆（clone）”。在安装THG之后，首先找个地方新建一个空白文件夹。在上面按右键，选择TortoiseHG-Clone接下来在“源”一栏，填写服务器上版本库的地址，通常是这样的格式：/XXXX/XXXX或者这样的格式：https:/你的用户名/XXXX/XXXX于是先填写实验工程的地址：/VariableD/the-ds-open-source接下来点“克隆”，就开始从服务器上下载代码了。下载完成以后，可以看到“新建文件夹”上，出现了一个熟悉的绿色的打钩符号。现在还可以顺手把“新建文件夹”改个名什么的，我这里就改叫DS-Open了。（3）本地的修改和提交进入目录，看到的大概是这么个东西：其中.hg就是根目录下的隐藏文件夹，.hgignore则是记录忽略文件的列表。比如说thumb.db，或者savedata之类的文件夹，虽然每个人都在频繁改动但是完全没有用处，经过在workbench里的文件列表中，右键点ignore设定，提交后就会被自动忽略。（虽然不用忽略，只是无视它不添加到版本控制里也就可以了）现在就和平时一样添加、修改、提交文件吧。假设我们先新建一个叫readme.txt的文件。右键点readme.txt，选择TortoiseHG-Add Files把它纳入版本控制。出现这样一个界面：左边是修改内容，右边是文件预览。点右下角的“添加”。就成功增加了这个文件。接下来继续在readme.txt上面按右键，选择HG Commit 界面变成了这样，左边是要提交的文件列表，右上是更新笔记，可以简单地写上这次做了些什么修改。右下依然是文件预览（有乱码也无所谓，无视之，不影响）。点下“提交”。稍等一两秒，等页面刷新之后，提交就算完成了。之后关闭窗口。现在readme.txt就被加到版本控制中了。你可以在本地随意修改，一直到觉得测试够了，再把稳定的版本发到服务器上，和其他人共享。（4）把本地的修改“推送”到服务器接下来回到根目录，也就是“DS-Open”，在上面按右键，选择Hg Workbench。应该可以看到下面这样的界面。工具栏和各版本历史记录。public代表已经更新到服务器上的版本。draft代表已经在本地提交，但是还没更新到服务器的版本。工作目录是文件夹现在的状态，可能有些还没提交的文件。总之选择一个自己觉得已经足够稳定的版本，例如这里就是版本1。然后选择工具栏的这个图标。出现这样的询问，当然是点确认啦。接下来可能会要求你输入密码（有时候还需要用户名user），总之照做就可以了。如果你有修改这个工程的权限，那么这个“推送”就成功了。比起SVN的add-commit，只是增加了一步变成add-commit-push。并没有什么特殊区别。（5）更新服务器的版本到你的电脑上当然，就像SVN一样，提交修改到服务器之前先看看别人改动过什么是个好习惯。因为HG的自动合并功能很强大，基本不用担心冲突什么的，所以只要简单的更新下代码，然后再把自己的修改传上去就行了。这里使用的当然是了。戳一下，等待更新。然后继续该干啥干啥就是了。（6）其他在TurtoiseHG-Global Setting-提交-用户名这里，可以填写自己的ID，这样历史记录里就会记录这是谁的修改了