GitLab

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

要使用 GitLab,首先要创建与 GitLab 服务器的连接,然后克隆要处理的项目。在项目设置中将之前克隆的项目链接到 GitLab,以便在版本控制视图中接收事件通知。

注意: 启用 GitLab 插件才能使用。

连接到 GitLab 服务器

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

要指定与 GitLab 服务器的连接,请访问首选项>Version Control >GitLab

版本控制偏好设置中的 GitLab 选项卡

添加 GitLab 服务器:

  1. 选择Add ,打开Add Server 对话框。

    添加服务器对话框

  2. Host 中,输入 GitLab 服务器的主机名。
  3. Description 中,输入在链接项目的 GitLab 设置中显示的自由格式文本。
  4. Access token 中,输入在 GitLab 服务器上为Qt Creator 创建的访问令牌,在Preferences >Access Tokens 中。
  5. Port 中,输入端口号。
  6. 清除HTTPS ,以使用 HTTP 连接而非安全连接。
  7. 选择Add 创建连接。

GitLab 选项卡中,curl 显示用于 HTTP 连接的curl 工具的路径。指定另一个路径可使用该工具的另一个实例,而不是Qt Creator 找到的那个。

要编辑所选连接,请选择Edit

要删除所选连接,请选择Remove

克隆项目

Qt Creator 会从访问令牌读取用户名和 ID,并显示每个服务器上的可用项目。你可以搜索特定项目或浏览列表中的项目。

从 GitLab 克隆项目:

  1. 访问Tools >GitLab ,查看已连接的 GitLab 服务器和每个服务器中可用项目的列表。

    GitLab 对话框

  2. Remote 中,选择一个 GitLab 服务器。
  3. Projects 中,选择要克隆的项目。
  4. 选择Clone ,打开Clone Repository 对话框。{

    }{复制存储库对话框}{复制存储库对话框}{复制存储库对话框}{复制存储库对话框

  5. Repository 中,指定版本库的 URL。
  6. Path 中,指定克隆版本库的路径。
  7. Directory 中,指定克隆版本库的目录名称。
  8. 选择Recursive 也克隆版本库的子模块。
  9. 选择Clone 可将项目克隆到指定目录。

Qt Creator 自动打开项目。如果克隆的项目有多个项目文件(如 CMakeList.txt、.pro 和 .qbs), 会提示您选择要打开的文件。如果没有 可以打开的项目文件,请转到 > > > 并将该项目作为通用项目导入。Qt Creator Qt Creator File New Project Import Project Import Existing Project

另请参阅 启用和禁用插件用 GitLab 链接项目设置版本控制系统使用常用 VCS 功能使用项目向导版本控制系统Git

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.