当使用 LibGit2Sharp 时,标准的提交方式确实是以下工作流程:
using (var repo = new Repository("path/to/a/repository"))
{
// do stuff
repo.Index.Stage("path/to/file1");
repo.Index.Stage("path/to/file2");
repo.Commit("This is my commit", ....);
// more stuff
}
但是,这需要一个非裸存储库:具有工作目录和索引的存储库。
Stage() 调用将文件从您的工作目录注册到 index。 Commit() 调用会在 object database 中创建 index 内容的不可变时间戳快照。
从 v0.9 版本开始,LibGit2Sharp 允许直接在对象数据库中创建提交,而不需要 Stage() 任何东西。事实上,这甚至适用于裸存储库。
除了提交之外,使用新的ObjectDatabase API,可以创建Blobs 或Trees。可以在 ObjectDatabaseFixture 单元测试中找到一些可能使用的示例。
什么是提交到 obect 数据库?
事实上,提交总是最终被存储到对象数据库中。新的 API 公开了一些较低级别的操作,这些操作在一些高级脚本操作中可能会派上用场。
为什么比普通的 git add 和 git commit 更有优势?
哇...这是一个广泛的子问题。而且没有一个有限的答案列表;-) 下面是一些可能的答案:
- 这使您可以独立于任何提交直接创建 Blob 和/或树
- 使用标准的
working directory -> index -> odb 工作流程,一次只能准备一个提交。使用此 API,您可以在非顺序流中创建 Blob 和树,然后在最迟决定将哪个树与提交关联。
- 此 API 还允许明确选择要创建的 Commit 应承担的父项
- Git 是一个内容可寻址的文件系统,一个不可变的、仅追加的对象数据库。此 API 促进了标准源代码管理之外的其他类型的使用。
目前,我的逻辑只是遍历另一个源代码控制系统中的文件,获取某个版本及其提交信息,然后执行 repo.Index.Stage 和 repo.Commit。我假设这是正确的,我应该使用对象数据库吗?
考虑到您的用例,标准工作流程似乎就足够了。