git2dart binaries #

Dart绑定到libgit2

git2dart包提供了在Dart/Flutter中使用libgit2的能力。

Ffigen #

要使用ffigen生成绑定，请使用（根据您的路径进行调整）：

dart run ffigen --compiler-opts "-I/path/to/git2dart/libgit2/headers/ -I/lib64/clang/12.0.1/include"

许可证 #

MIT。更多信息请参见LICENSE文件。

使用示例 #

以下是一个完整的示例，展示了如何使用git2dart插件执行基本的Git操作。

初始化项目 #

首先，创建一个新的Flutter项目并添加git2dart依赖。

dependencies:
  flutter:
    sdk: flutter
  git2dart: ^0.1.0 # 请确保使用最新版本

配置git2dart #

配置git2dart以正确加载libgit2库。

import 'package:git2dart/git2dart.dart';
void main() {
// 初始化git2dart库
Git2Dart.init();
}

克隆仓库 #

使用git2dart克隆一个远程仓库。

import 'package:git2dart/git2dart.dart';
Future<void> cloneRepository() async {
try {
// 克隆远程仓库到本地
Repository.clone(
“https://github.com/example/repo.git”, // 远程仓库URL
“/path/to/local/repo”, // 本地目录路径
);
print(“Repository cloned successfully!”);
} catch (e) {
print(“Failed to clone repository: $e”);
}
}
void main() {
cloneRepository();
}

打开现有仓库 #

打开一个已存在的本地Git仓库。

import 'package:git2dart/git2dart.dart';
Future<void> openRepository() async {
try {
// 打开本地仓库
Repository.open("/path/to/existing/repo");
print(“Repository opened successfully!”);
} catch (e) {
print(“Failed to open repository: $e”);
}
}
void main() {
openRepository();
}

获取分支列表 #

列出本地仓库的所有分支。

import 'package:git2dart/git2dart.dart';
Future<void> listBranches() async {
try {
// 打开本地仓库
final repo = await Repository.open("/path/to/existing/repo");
// 获取所有分支
final branches = repo.branches();

// 打印分支名称
for (final branch in branches) {
  print(branch.name);
}
} catch (e) {
print(“Failed to list branches: $e”);
}
}
void main() {
listBranches();
}

提交更改 #

将更改提交到本地仓库。

import 'package:git2dart/git2dart.dart';
Future<void> commitChanges() async {
try {
// 打开本地仓库
final repo = await Repository.open("/path/to/existing/repo");
// 开始事务
final index = await repo.index();
await index.addAll();
await index.write();

// 创建提交
final signature = Signature.now("Author Name", "author@example.com");
final treeId = await index.writeTree();
final tree = await repo.lookup&lt;Tree&gt;(treeId);

final commitId = await repo.createCommit(
  "HEAD",
  signature,
  signature,
  "Commit message",
  tree,
  [],
);

print("Commit created successfully: $commitId");
} catch (e) {
print(“Failed to commit changes: $e”);
}
}
void main() {
commitChanges();
}

推送更改 #

将更改推送到远程仓库。

import 'package:git2dart/git2dart.dart';
Future<void> pushChanges() async {
try {
// 打开本地仓库
final repo = await Repository.open("/path/to/existing/repo");
// 推送更改到远程仓库
final remote = await repo.findRemote("origin");
await remote.push(["refs/heads/main:refs/heads/main"]);

print("Changes pushed successfully!");
} catch (e) {
print(“Failed to push changes: $e”);
}
}
void main() {
pushChanges();
}