Gitling：Android Git 客户端

项目简介

Gitling 是一个 Android 平台的 Git 客户端，使用 Jetpack Compose 与 Material 3 Expressive 构建，界面完全重写。它源自 MGit（而 MGit 又延续自 SGit），在现有实现基础上换成新的 Android 工具链与新的视觉风格。应用免费开源（GPLv3），无广告、无跟踪，最低支持 Android 6.0（API 23）。

主要功能

• 克隆、创建、删除本地仓库，也可从设备存储导入已有仓库
• 一键 Connect with GitHub（OAuth Device Flow），GitHub 远程仓库无需手动处理 token 或密码
• 支持自建的 Forgejo、Gitea：以 Custom 账户填入实例地址即可
• 支持 HTTP/HTTPS/SSH，SSH 私钥可带 passphrase；任意 Git 主机都可用用户名/密码或个人访问令牌认证
• 完整的分支/合并提交图，lazygit 风格的分道可视化，并内联显示分支、标签、HEAD 标签
• 浏览文件与提交历史，查看提交之间的 git diff
• Blame 视图，查看每一行最后由哪个提交改动
• Git 命令控制台，可直接运行 status、log、diff、branch、stash
• 检出、创建、合并本地/远程分支与标签
• git status、暂存操作、git rebase、git cherry-pick、git checkout <file>
• Stage All / Unstage All：在状态页一键全部暂存或取消暂存
• Submodule 初始化与更新
• 跨仓库、提交历史与文件树的搜索
• 仓库置顶、自定义标签与按标签筛选
• 主屏幕小组件展示仓库状态与是否有未提交改动
• 私钥生成与管理
• 跟随系统的浅色/深色模式，可在固定品牌色与基于壁纸的 Material You 动态取色之间切换

安装与使用

应用可从 GitHub Releases、F-Droid 与 Google Play 获取，安装包信息见项目的发布页与商店页面。

克隆远程仓库：

1. 点击 + 按钮添加仓库
2. 填入远程 URL
3. 输入本地仓库名称。注意这不是完整路径，Gitling 会把所有仓库放在统一的根目录下（可在设置中修改）
4. 点击 Clone
5. 如需要会提示输入凭据；在设置中连接一次 GitHub 账号后，GitHub 远程仓库可跳过此步

创建本地仓库：点击 +，选择 Init Local，按提示输入名称。

自建 Forgejo / Gitea：进入 Settings → Accounts，点击 Add account，类型选择 Custom，填入用户名、个人访问令牌与实例 URL（例如 https://forgejo.example.com），之后对该主机的 clone、fetch、pull 会自动使用这组凭据。

URL 格式：

• SSH（默认 22 端口）：ssh://username@server_name/path/to/repo
• SSH（非标准端口）：ssh://username@server_name:port/path/to/repo，必须带用户名
• HTTP(S)：https://server_name/path/to/repo

注意事项

• Gitling 没有内置文本编辑器。要编辑文件，需要设备上已安装支持通过 Android File Provider 打开文件的编辑器应用（多数代码/文本编辑器都支持）。
• 使用中遇到 bug 或崩溃，可在 GitHub Issues 提交，说明发生了什么以及如何复现。
• 项目采用 GPLv3 许可；默认字体 Plus Jakarta Sans，设置中还可切换 Inter 与 JetBrains Mono，三者均为 SIL OFL 1.1 许可。

---

本作品整理自 GitHub 开源项目 maneeshacooray/Gitling，原作者 @maneeshacooray，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。