GitLab

GitLab 是 GitLab 开发的 DevOps 工具。您可以从 GitLab 服务器克隆项目，并使用 Git 来管理您本地的和远程的仓库。

要使用 GitLab，创建到 GitLab 服务器的连接，并克隆您要工作的项目。在项目设置中将之前克隆的项目链接到 GitLab，以便在 版本控制 视图中接收事件通知。

连接到 GitLab 服务器

要连接到 GitLab 服务器，指定服务器主机名和端口号，以及在 GitLab 中为 Qt Creator 创建的访问令牌。令牌的权限范围至少必须是 read_api 或 api。

要指定连接到 GitLab 服务器，请转到 首选项 > 版本控制 > GitLab

要添加 GitLab 服务器

1. 选择 添加 以打开 添加服务器 对话框。

   

2. 在 主机 中，输入 GitLab 服务器的主机名。
3. 在 描述 中，输入在链接项目的 GitLab 设置中显示的任意格式文本。
4. 在 访问令牌 中，输入在 GitLab 服务器中为 Qt Creator 创建的访问令牌，在 首选项 > 访问令牌。
5. 在 端口 中，输入端口号。
6. 清除 HTTPS 可使用 HTTP 连接而不是安全连接。
7. 选择 添加 以创建连接。

在 GitLab 选项卡中，curl 显示用于 HTTP 连接的 curl 工具的路径。指定另一个路径以使用 Qt Creator 找到之外的另一个工具实例。

要编辑选定的连接，请选择 编辑。

要删除选定的连接，请选择 删除。

克隆项目

您可以从连接的GitLab服务器克隆项目。Qt Creator会从访问令牌读取您的用户名和ID，并显示每个服务器中的可用项目。您可以搜索特定的项目或浏览列表中的项目。

要克隆GitLab中的项目

1. 转到工具 > GitLab，查看连接的GitLab服务器列表以及每个服务器中的可用项目。

   

2. 在远程中，选择一个GitLab服务器。
3. 在项目中，选择要克隆的项目。
4. 选择克隆以打开克隆仓库对话框。

   

5. 在仓库中，指定仓库的URL。
6. 在路径中，指定克隆仓库的位置。
7. 在目录中，指定克隆仓库的目录名称。
8. 选择递归以同时克隆仓库的子模块。
9. 选择克隆将项目克隆到指定的目录。

Qt Creator会自动打开项目。如果克隆的项目有几个项目文件（例如CMakeList.txt、.pro和.qbs），Qt Creator会提示您选择要打开的文件。如果没有Qt Creator可以打开的项目文件，请转到文件 > 新建项目 > 导入项目 > 导入现有项目，并将项目以通用项目方式导入。