Mercurial Subrepos-如何创建它们以及它们如何工作?

情况

我有两个.NET解决方案( Foo 和 Bar )以及包含projectA、projectB和projectC的公共库。 福 和 酒吧 引用一个或多个库项目,但库项目不在 福 和 酒吧 解决方案文件夹。

目录结构:

-- My Documents*
   -- Development
      -- Libraries
         -- ProjectA
         -- ProjectB
         -- ProjectC
   -- Projects
      -- Foo
         -- Solution
            -- .hg
            -- .hgignore
            -- Foo { Project Folder }
            -- FooTests { Project Folder }
            -- Foo.sln { References ProjectA }
            -- Foo.suo
      -- Bar
         -- Solution
            -- .hg
            -- .hgignore
            -- Bar { Project Folder }
            -- BarTests { Project Folder }
            -- Bar.sln { References ProjectA and ProjectB }
            -- Bar.suo

*唉,我还在用Windows XP…

汞亚报告

目标 -我想设置子报表,以便将任何引用的库项目的源代码存储在 福 和 酒吧 储存库。

根据 this page (实际上,这是我在子报告上找到的唯一文档),设置子报告需要从DOS控制台窗口执行以下命令:

1| $ hg init main
2| $ cd main
3| $ hg init nested
4| $ echo test > nested/foo
5| $ hg -R nested add nested/foo
6| $ echo nested = nested > .hgsub
7| $ hg add .hgsub
8| $ ci -m "initial commit"

问题

1. 从0.9.2版开始,可以使用TortoiseHg执行任何或所有这些步骤吗?如果是,怎么办?我很确定1-3行可以,但我不知道4-7行。这些似乎都没有记录在TortoiseHg中。
2. 上面的代码是做什么的(一行一行的解释会非常感谢)。以下是我在试图破译时想到的一些具体问题:
   • 什么? > 怎么办?我试着在反复无常的文档中搜索 > 但什么也没找到。
   • 在第五行,我不明白 nested/foo 是。哪里做的 foo 来自哪里?是什么 福 ?仓库?文件夹?
   • 第六行-这一个完全让我困惑。
   • 我想在第7行 .hgsub 正在将添加到 main ?或者它被添加到 nested ?
3. 假设我的子报告已经设置好了, 酒吧 存储库现在是第10版。如果我试图将我的工作目录更新到第7版,这会导致我的库文件夹( My Documents/Development/Libraries/ProjectA 和 .../Libraries/ProjectB )更新版本7中存储的内容?

更新

我添加了第8行代码: ci -m "initial commit" . 这做了两件事:(1)向主repo添加一个.hgsubstate文件;(2)将所有更改,包括新的子repo提交到主存储库中(带有消息“initial commit”)。.hgsubstate文件的目的是跟踪所有子报告的状态,因此如果您返回到早期版本,它也将从所有子报告中获取正确的版本。

更新2-部分说明

经过进一步的试验,我 认为 现在我可以提供解决原始问题的步骤(主要使用Windows资源管理器和TortoiseHg):

创建子报表

1. Libraries/ProjectA , Libraries/ProjectB 以及主要的存储库( Projects/Foo/Solution 和 Projects/Bar/Solution )必须是单独的存储库。
2. 正常开放 项目/foo/解决方案 .
3. 克隆自 图书馆/项目A 到 项目/foo/解决方案 .
4. 添加 ProjectA 到 福 存储库。

5. 使用文本编辑器创建名为 HGSUB ,包含以下内容:

   ProjectA = ProjectA
   

6. 打开DOS控制台窗口并输入以下命令 (见下文注释) 以下内容:

   cd c:\...\Projects\Foo\Solution
   hg ci -m "Committing subrepo "ProjectA"
   

7. 用于 酒吧 ,步骤基本相同,但.hgsub文件应包含两个项目的条目,如下所示:

   ProjectA = ProjectA  
   ProjectB = ProjectB
   

注: 从TortoiseHg 0.10开始(定于3月),您将能够使用 HG Commit shell命令可以这样做,但现在,您必须使用命令行。

一旦这些都设置好了,就变得更容易了。

正在提交更改 -将更改提交到 福 或 酒吧 你做了 Synchronize/Pull 每个子报告的操作,以使子报告与库项目存储库中的最新版本同步。然后再次使用命令行提交更改(直到0.10版,此时您可以只使用TortoiseHg提交)。

正在将工作目录更新为早期版本 -这似乎在TortoiseHg中非常正常,并且似乎不需要使用任何DOS命令。要在Visual Studio中实际使用早期版本,需要执行 Synchronize/Push 将旧版本的库项目放回 Libraries/ProjectX 文件夹。

尽管我喜欢TortoiseHg用于简单的任务,但最好为常用的子报告操作(尤其是更新)编写批处理文件。

希望这对将来的人有所帮助。如果你看到任何错误,请告诉我(如果你有能力的话,也可以随意编辑自己)。