studio

2020.10

false

不在支持范围内

Studio 用户指南

Last updated 2023年12月20日

使用 GIT 管理项目

Studio 中的 GIT 集成需要 Microsoft Visual C ++ 2015 Redistributable 更新 3 x86 版本。请查看软件要求页面。

对 GIT 进行身份验证

Studio 中的身份验证方法根据克隆 GIT 存储库（HTTPS 或 SSH）的使用方法而有所不同。检查此页面，查看应在使用 GitHub 时使用哪种身份验证方法。

备注：

您在 Studio 中提供的 GIT 凭据存储在 Windows 凭据管理器中。
GIT 与 Studio 的集成目前不支持双重身份验证。作为一种变通办法，可使用利用个人令牌的 SSO 身份验证或者基本访问身份验证方法。

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

通过 HTTPS

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

您可以使用以下方式进行身份验证：

在特定字段中输入用户名和密码；
“用户”字段中的用户名和“令牌”字段中的 GIT 令牌；

请按照此页面的详述步骤为您的 GitHub 存储库生成 GIT 令牌。

通过 SSH

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

添加“私钥路径”和“密码”，然后单击“打开”以克隆远程 GIT 存储库。请查看此处详细介绍的步骤，为您的 GitHub 存储库生成 SSH 密钥。

身份验证失败

通过 HTTPS

如果在使用 HTTPS 方法克隆 GIT 存储库时输入的密码或用户名有误，系统会显示“输入凭据”窗口，并显示“身份验证失败”的消息：

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

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

通过 SSH

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

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

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

克隆远程 GIT 存储库

在“团队”选项卡中，选择“克隆存储库”。系统随即会显示“克隆远程 GIT 存储库”窗口。
选择“通过 HTTPS 进行克隆”或“使用 SSH”。
键入“存储库 URL”，并选择一个空的“签出目录”。
单击“使用凭证”或“使用密钥”复选框，以添加您的 Git 用户名或“私钥路径”及密码。
单击“打开”，Studio 随即会在“设计器”面板中打开项目。
在“打开”窗口中，选择要在 Studio 中打开的 project.json 文件。

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

向 GIT 添加项目

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

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

编写一条提交消息。单击“提交”按钮以将更改提交到本地 Git 存储库。

将项目添加到 SVN 时，“项目”面板中的上下文菜单包括 SVN 特定选项。请参阅 GIT 的上下文菜单选项。

提交并推送到 GIT

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

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

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

状态栏中会显示未推送的更改数量以及新添加的文件。单击图标，打开“提交更改”窗口，或单击图标推送更改。

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

更改上次提交

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

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

撤消待定更改

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

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

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

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

复制项目到 GIT

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

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

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

创建和管理分支

在“项目”面板中，右键单击项目节点或内含的文件，或状态栏中的图标，然后选择“管理分支”。系统将显示“管理分支”窗口。
单击按钮添加分支。在“名称”部分中，写入分支的名称。单击“添加”，然后单击“保存”，便可将分支添加到此列表中。

右键单击任意分支，以显示 Git 分支的选项：

“签出分支”选项可切换到选定的分支。
“重定基准”选项可将当前分支重定基准为选定分支。
“合并”选项可将选定分支合并到当前分支中。

若要将一个分支合并到 GIT 远程存储库的主分支，您需要在 Studio 中签出该主分支，再将修改的分支合并到主分支中。

若要切换不同分支，请单击状态栏中的图标，以打开包含最近签出的所有分支的列表。单击一个项目以切换分支。

解决冲突

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

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

该窗口类似于“文件区别”，显示文件的“远程”版本与“本地”版本之间的区别。

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

选项	描述
选择左	选择代表要推送的远程存储库中的文件的左侧文件。
选择右	选择代表要推送的本地存储库中的文件的右侧文件。
保存	在选择左侧或右侧文件后，单击“保存”。
取消	取消操作并退出“解决冲突”窗口。
前一个	导航到所比较文件的前一个更改。
下一个	导航到所比较文件的下一个更改。
全部折叠	折叠 `.xaml` 文件中的所有节点。
全部展开	展开 `.xaml` 文件中的所有节点。