订阅

UiPath Studio

UiPath Studio 指南

使用 GIT 管理项目

GIT integration in Studio requires the Microsoft Visual C++ 2015 Redistributable Update 3. Check the Software Requirements page.

对 GIT 进行身份验证

Authentication methods in Studio differ in accordance with the methods used for cloning a GIT repository, either HTTPS or SSH. Check this page to see which you should use if you're working with GitHub.

📘

注意:

  • 您在 Studio 中提供的 GIT 凭据存储在 Windows 凭据管理器中。
  • 如果您通过登录服务进行身份验证,则 GIT 与 Studio 的集成当前仅支持对 GitHub 的双重身份验证。对于其他工具,请使用利用个人令牌的 SSO 身份验证方法或基本访问身份验证方法。

当前指南详细介绍了对 GitHub 存储库进行身份验证的步骤,但 Studio 中的 Git 集成不仅限于此服务。

通过 HTTPS

首次克隆远程 GIT 存储库或使用 HTTPS 将当前项目复制到现有 GIT 存储库时,必须提供 GIT 凭据。这些凭据必须在“使用凭据”字段中输入:

您可以使用以下选项进行身份验证:

  • “使用 GitHub 登录”- 使用您的 GitHub 帐户登录。
  • “用户/密码”- 输入您的用户名和密码。
  • Token - Enter your user and personal access token.
    Follow the steps detailed in this page to generate a GIT token for your GitHub repository.

🚧

重要提示:

“使用 GitHub 登录”选项仅适用于托管在 github.com 上的存储库,并且要求您的组织或帐户安装 UiPath GitHub 应用程序

通过 SSH

第一次克隆存储库或使用 SSH 将当前项目复制到现有 GIT 存储库时,可以选择使用私钥:

Add the Private Key Path and the Password, and then click Open to clone your remote GIT repository. Check out the steps detailed here to generate a SSH key for your GitHub repository.

身份验证失败

通过 HTTPS

克隆 GIT 存储库时,如果提供的凭据不正确,则会显示“输入凭据”窗口,并显示消息“身份验证失败”

输入正确的凭据,然后重试。例如,您还可以使用 Git Bash 远程克隆自己的存储库,从而检查用户名和密码是否正确。

在下图中,我们试图通过 HTTPS 克隆存储库,但输入了不正确的密码。Git Bash 窗口显示凭据不正确。

通过 SSH

SSH 身份验证失败时,系统将显示以下“输入凭据”窗口:

请输入正确的私钥路径密码,然后重试。例如,您还可以使用 Git Bash 远程克隆自己的存储库,从而检查令牌和/或密码是否正确。

在下图中,我们尝试通过 SSH 克隆存储库,但我们的帐户上没有设置任何公共 SSH 密钥。

克隆远程 GIT 存储库

  1. 在“团队”选项卡中,选择“克隆存储库”。系统随即会显示“克隆远程 GIT 存储库”窗口。
  2. 选择“使用 HTTPS”或“使用 SSH”
  3. 键入“存储库 URL”,并选择一个空的“签出目录”
  4. 选择“使用凭据”/使用密钥”并配置身份验证(使用 GitHub 登录、输入用户名和密码、针对 HTTPS 输入用户名和令牌,或针对 SSH 输入私钥路径和密码)。
  5. 单击“打开”,Studio 随即会在“设计器”面板中打开项目。
  6. 在“打开”窗口中,选择要在 Studio 中打开的 project.json 文件。

GIT 存储库克隆到本地工作目录后,将创建 .git 子目录,其含有所需的 GIT 存储库。元数据包含对象、参考和模板文件的子目录。此外,也会创建 HEAD 文件,该文件指向当前的签出提交。

向 GIT 添加项目

“GIT Init”功能可将当前项目添加到本地 GIT 存储库。通过“团队”选项卡或状态栏访问此命令。

  1. 在 Studio 中创建或打开项目。单击“开始”选项卡 >“团队”。系统随即会显示“团队”选项卡。
  2. 单击“GIT Init”按钮,然后选择一个应当用于初始化存储库的路径。该位置可以与项目文件夹或父文件夹相同。“提交更改”窗口将打开。
  1. “修改的文件”部分中显示要添加到 Git 存储库中的项目文件。清除您不希望添加的文件旁边的复选框,或使用“全选”和“取消选择”功能。
  2. 选择“显示无版本文件”选框,以将无版本文件添加到列表中。编写“提交消息”。单击“提交”按钮,将更改提交到本地 Git 存储库。

When a project is added to GIT, the context menu in the Project panel includes GIT-specific options. For more information, see Context Menu Options for GIT.

提交并推送到 GIT

  1. 从同样的“提交更改”窗口中,单击“提交并推送”按钮,以提交更改并推送到远程存储库。系统将显示“管理远程”窗口。该窗口也可从状态栏打开。
  1. 在“名称”部分中,添加远程存储库的名称。
  2. 在“URL”部分,添加远程 URL。

若要对添加的存储库进行修改,只需单击一个条目、更改其名称和 URL,然后单击“更新”按钮。完成后,单击“添加”,然后再单击“保存”。以下消息框将打开。这表示本地存储库未与远程存储库同步。

  • 单击“覆盖远程内容”可将文件的本地版本推送到远程存储库并覆盖其中的文件。
  • 单击“拉取(重定基准)”按钮可拉取远程文件并为本地分支重定基准。
  • 单击“取消”按钮可放弃整个操作。

The number of unpushed changes, and newly added files are visible in the status bar. Click the changes_iconchanges_icon icon to open the Commit Changes window, or the push_commitpush_commit icon to push changes.

📘

备注:

如果您在外部编辑器中编辑添加到来源控件的项目中的文件,则仅在单击“项目”面板中的“刷新”refreshrefresh 后,更改才会在“项目”面板和状态栏中显示。

更改上次提交

Studio 与 Git 的集成也附带一个“修改提交”选项,可以在执行推送前更改最近一次执行的提交。

  1. 在“项目”面板中右键单击修改后的文件,然后选择“提交”。系统将显示“提交更改”窗口。
  1. 选择“修改提交”框。显示上次的提交消息以及已提交的文件。要查看当前文件和上次提交之间的更改,请使用“显示更改”选项。
  2. 更改提交消息,再选择您要包含的文件。单击“提交并推送”或“提交”按钮。

撤消待定更改

Studio 附带一个选项,可以在您提交文件并推送到远程存储库之前,撤消对已加入版本控制的文件作出的更改。

修改了本地存储库中的文件后,单击 GIT 上下文菜单中的“撤消”,以打开“撤消待定更改”窗口。

选中文件旁边的复选框,再单击“撤消”。文件现已还原到更改之前的状态。

📘

备注:

“撤消”不包括版本文件。如果创建新文件后选择“撤消”,则不会从项目中删除文件。添加到项目树后,新文件将一直保留,除非手动删除。

复制项目到 GIT

“Studio 后台视图”和状态栏中的“复制到 GIT”按钮用于将当前项目复制到现有 GIT 存储库。

要这么做,首先在 Studio 中创建或打开一个项目。在“团队”选项卡中,选择“复制到 GIT”,再选取计算机上一个现有的 GIT 存储库文件夹。该项目将添加到本地 GIT 存储库中,“复制到 GIT”消息框也会打开。

  • 选择“是”,以从新的位置打开该项目。“提交更改”窗口将打开。编写“提交消息”,再单击“提交并推送”或“提交”。
  • 选择“否”,以返回到 Studio 用户界面。

创建和管理分支

Add and manage branches from the Manage Branches window. To access it, either right-click the project node or a file in the Project panel and select Manage Branches, or use the merge_buttonmerge_button branch menu in the status bar.

  • 要添加分支:
    1. Select a branch in the table, and then click Plus add_buttonadd_button at the top of the window.
    2. Enter a name for the branch, click Create branch from branch_name, and then click Save.
      The branch is added to the list.
  • To refresh the list of branches, click Refresh refresh_buttonrefresh_button at the top of the window.
  • To delete a local branch, select it, and then click Delete delete_buttondelete_button at the top of the window.
  • 要管理分支,请右键单击任何分支,然后从菜单中选择一个选项:
    • “签出分支”选项可切换到选定的分支。
    • “重定基准”选项可将当前分支重定基准为选定分支。
    • The Merge option merges the selected branch into the current branch.
      To merge a branch into the master of a GIT remote repository, you need to have the master branch checked out in Studio and then merge the modified branch into master.
  • To switch between branches, open the merge_buttonmerge_button branch menu in the status bar, and then select the branch to switch to from the list of recently checked out branches.

查看提交历史

要查看项目或项目中特定文件或文件夹的提交历史,请右键单击“项目”面板中的项目节点、文件或文件夹,然后选择“显示历史记录”。这将打开“历史记录”窗口,其中显示所选文件、文件夹或项目的现有修订列表。每次提交时,提交哈希、消息、作者和日期都会显示在窗口上部的表格中。您可以在窗口下部的“详细信息”和“更改”选项卡中查看有关所选提交版本的更多信息。

比较文件的两个版本

要比较同一文件的两个版本,请执行以下操作:

  • 如果您打开了文件的历史记录,请右键单击“历史记录”窗口中的提交版本,然后选择“与前一版比较”、“与本地版比较”或“与最新版比较”
  • 如果打开了文件夹或项目的历史记录,请在“历史记录”窗口中选择一个提交版本,然后在“更改”选项卡中双击一个文件以将其与先前版本进行比较。

根据上一个提交版本创建分支

要根据特定提交版本创建分支,请执行以下操作:

  1. 右键单击“历史记录”窗口中的提交版本,然后选择“创建分支”
  2. 在“创建分支”窗口中:
    • 输入新分支的名称。
    • 要同时签出新分支,请确保已选中“创建后签出”选项。
  3. 单击“确定”

解决冲突

GIT 与 Studio 的集成附带一项功能,用于解决在执行“变基”或“推送”命令时可能发生的冲突,此选项位于“提交更改”窗口中。

每当 Studio 检测到本地文件与远程存储库中的文件存在冲突时,系统即会显示“解决冲突”窗口。

The window is similar to File Diff, showing the differences between the Remote version of the file and the Local version.

下表说明了“解决冲突”窗口中的可用选项。

选项

描述

Choose Left

选择代表要推送的远程存储库中的文件的左侧文件。

Choose Right

选择代表要推送的本地存储库中的文件的右侧文件。

Save

在选择左侧或右侧文件后,单击“保存”。

Cancel

取消操作并退出“解决冲突”窗口。

Previous

导航到所比较文件的前一个更改。

Next

导航到所比较文件的下一个更改。

Collapse All

折叠 .xaml 文件中的所有节点。

Expand All

展开 .xaml 文件中的所有节点。

断开与 GIT 的连接

在以下两个情形中,可将 Studio 后台视图的“团队”选项卡中的“断开连接”选项用于版本控制的文件:

  1. 流程初始化为本地 GIT 存储库。创建一个新流程,使用“GIT Init”将它添加到本地 GIT 存储库,再使用“断开连接”删除其子版本标签。
  2. 若要删除子版本标签,可单击含有父级和子级项目的 Git 存储库的“断开连接”。
  3. 如果断开子项目的连接,则含有已打开项目的整个 GIT 存储库将断开与来源控件的连接。Studio 中将显示一个消息框,需要您在执行断开连接操作前进行确认。

更改签名

可以通过“团队”选项卡 >“更改签名”来更改 GIT 确认签名。填写您的姓名和电子邮件地址,然后单击“确定”

更改凭据

要更新用于连接到远程存储库的凭据,请执行以下操作:

  1. 从状态栏的 merge_buttonmerge_button 分支菜单中,选择“管理远程”
  2. 在“管理远程”对话框中,右键单击一个远程存储库,然后选择“更改凭据”
  3. 根据克隆存储库的方式(通过 HTTPS 或 SSH),您可以登录 GitHub 帐户(仅适用于托管在 github.com 上的存储库),输入用户名/密码或用户名/令牌,或指向新的私钥,然后单击“确定”
    凭据将在 Windows 凭据管理器中更新。

搭配使用 GIT 与代理服务器

如果通过代理服务器访问互联网,则 Studio 中的 GIT 集成可支持访问远程存储库。您可以通过两种方式完成此操作:在“代理设置”窗口中的计算机级别进行配置,或者更改 git 命令。

将考虑在“代理设置”窗口中配置的代理详细信息,但无需在 .gitconfig 文件中输入这些信息。

To configure proxy details with git commands, add them to GIT configuration files in the following form:
[http "https://domain.com"] proxy = http://proxyUsername:[email protected]:port

GIT 配置文件可在以下位置找到:

  • config 文件:%ProgramData%\Git
  • .gitconfig 文件:%UserProfile%
  • 项目级别的本地 config 文件,例如 %UserProfile%\Desktop\testproject\.git

4 个月前更新

使用 GIT 管理项目


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。