练习 - 使用 Git 进行源代码管理

  • 10 分钟

本练习在编写过程中使用了美国版 Business Central 中的示例公司 Cronus。 如果您使用自己所在国家或地区的示例公司，可能需要对步骤进行调整。

场景

您是就职于 CRONUS International Ltd. 的一名开发人员，想要创建一个新 AL 扩展，使用 Git 将其添加到版本控制，并保护 Azure Repos 中的代码。

任务

  • 创建新 AL 扩展

  • 将源代码添加到本地 Git 存储库

  • 将 Azure Repos 添加为远程 Git 存储库

  • 将本地 Git 存储库推送到远程存储库

步骤

  1. 启动 Visual Studio Code。

  2. 选择视图>扩展 (Ctrl+Shift+X)。

  3. 在在市场中搜索扩展搜索框中键入 AL Language。

  4. 单击绿色的安装按钮。

  5. 创建新 AL 扩展项目。 选择视图>命令面板... (Ctrl+Shift+P)。

  6. 在搜索框中输入 AL: Go!，然后从列表中选择命令。

  7. 接受建议的路径（或输入其他路径）。

  8. 选择最新的目标平台。

  9. 选择 Microsoft 云沙盒作为开发终结点。

  10. 选择视图>命令面板... (Ctrl+Shift+P)，下载应用程序符号。

  11. 在搜索框中键入 AL: Download symbols，然后从列表中选择命令。

  12. 如果需要，请提供您的组织凭据（Microsoft 365 帐户/Microsoft Entra ID 帐户）。

  13. 打开 App.json 文件并将 name 设置更改为 Hello Business Central，将 publisher 设置更改为 Cronus International Ltd。

  14. 使用 下载 Git 页面安装 Git（如果尚未安装）。

  15. 在 Visual Studio Code 中选择视图>SCM (Ctrl+Shift+G)，打开源代码管理视图。

  16. 单击初始化存储库按钮，初始化当前 AL 扩展的本地存储库。

  17. 现在，您文件末尾的状态会显示为 U，表示已取消跟踪。 右键单击第一个 .app 文件，选择添加到 .gitignore。 您只能在源代码管理视图中执行本操作，不能在 Explorer 视图中执行

  18. 对每个 .app 文件以及 launch.json 文件重复本过程。

  19. 选择所有文件，右键单击，然后选择暂存更改或单击更改旁边的 + 图标。 本操作会将文件添加到暂存区域。

  20. 在提交消息框中添加消息初始提交，然后单击提交按钮（复选标记按钮）或按 Ctrl+Enter

  21. 打开首选 Web 浏览器，然后打开 Azure DevOps 组织。

  22. 如果您是从视频演示中创建的项目 Hello Business Central，请选择该项目，如果项目不可用，请创建一个新项目。

  23. 单击左侧菜单中的 Repos。 您会发现，存储库为空，且您可以将代码添加到存储库。

  24. 复制克隆到您的计算机部分中的 https 链接。

  25. 打开 Visual Studio Code，按 F1 并在搜索框中键入 Git: Add Remote...。

  26. 输入远程名称：来源

  27. 将从 Azure Repos 复制的 URL 粘贴到远程 URL 框中。

  28. 根据您的配置，Visual Studio Code 会提示您使用 Microsoft 帐户/组织帐户登录到 Azure DevOps。 如果本操作不起作用，并且 Visual Studio Code 仍然要求您使用用户名和密码登录，则可以返回 Azure DevOps，然后在从中复制 repo URL 的输入框下找到生成 Git 凭据按钮并单击该按钮。 通过这种方式，您可以复制可用于 Git（而不是标准帐户）的用户名和密码。

  29. 如果远程存储库已成功链接到 Visual Studio Code，则可以单击 Visual Studio Code 窗口左下方的发布图标。 本按钮是一个带有向上箭头的云状图标。 位于主分支按钮旁边。

以下步骤可让您在 Azure Repos 中发布本地代码。

  1. 打开 Azure DevOps 并刷新页面即可查看您的代码。

  2. 打开 Visual Studio Code，打开 HelloWorld.al 文件，然后在“消息”功能中更改 Hello Business Central 的 Hello World。 保存您的修改 (Ctrl+S)。

  3. 打开源代码管理视图。 HelloWorld.al 文件应显示更改后的结果。 选择文件并将文件添加到暂存区域。

  4. 添加提交消息并单击提交按钮。

  5. 现在，请将更改推送到远程存储库。 您可以单击三个点 ...，打开菜单，然后选择推送。 或者，您也可以单击窗口底部的“同步”图标（与单击的“发布”图标位于同一位置）。 本操作将执行同步。 因此，您会看到一个窗口，提示您本操作将用于执行拉取和推送。 单击是即表示同意。

  6. 打开 Azure DevOps 并刷新页面，然后选择 HelloWorld.al 文件。 此时，您应当可以看到所做的修改。