Sysmac Studio使用Tortoise和Git实现版本控制

实验时间：2022/11/16

实验软件：Sysmac Studio(1.52，需要软件授权支持版本控制)、Git(2.38.1)、Tortoise(2.13.0)、gitee(代码仓库)

实验目的：Sysmac Studio实现版本控制、多人同时开发（需要有Git和tortoris使用基础）

实验内容

​ 本次实验模拟的是两个开发人员同时开发一个项目的两个功能，最终合并到一起进行调试，调试完成后发布。Sysmac Studio除了程序部分，对于两个开发人员来说都是公共部分，比如配置和设置下面的所有项、功能、功能块、数据等。这些公共部分如果两个开发人员都在自己的项目中单独修改，这个在之后项目合并时会出现很多的冲突。为了解决这个问题给两个开发人员建一个公共的分支用于修改公共参数，然后将这些公共参数合并到自己的项目中。

分支策略

策略介绍：

第一步：首先由项目负责人创建本地仓库建立master分支、developer分支，在developer下建立common分支，再在Git创建远程仓库，并将本地仓库的每个分支推送到远程仓库；

第二步：由开发者1将远程仓库的developer分支克隆到本地仓库，然后建立dev1和common1分支，本地仓库的common1分支在修改之前需要先从远程仓库的common分支先拉取，再修改，修改之后合并到dev1分支，再推送远程仓库的common分支。这样可以放置不同开发者在使用共参数出现不同步的问题；开发者2同样的操作；

第三步：在开发者功能全部开发完毕后将项目合并到developer分支上；

第四步：developer建立release分支用于测试项目，在bug处理完之后将项目合并到master分支和developer分支；

第五步：如果项目在最终使用是出现bug，可以再master分支上创建临时分支hotfix用于修改bug，修改完之后将项目再合并到master分支和developer分支，然后删除hotfix分支即可；

分支功能：

master：主分支，用于最终版本的发布；

developer：开发分支，用于合并开发者的项目，通常由项目负责人管理；

dev1：开发者1分支，用于开发者开发自己负责的功能；

dev2：开发者2分支，用于开发者开发自己负责的功能；

common1：开发者1公共参数分支；

common2：开发者2公共参数分支；

common：公共参数分支，用于每个开发者修改公共参数（修改之前要先拉取），最后将这部分参数合并到自己的项目中；

hotfix：用于修正master中发现的bug，修正完推送至master和developer分支；

release：用于测试developer中的项目，修改测试中的bug，最终推送至master和developer分支

分支策略图：

Git和Tortorisean安装和设置

1. 安装Git和Tortorise

git下载网址：https://git-scm.com/

Tortoise下载网址：https://tortoisegit.org/

在安装git时需要注意如下选项：

2. Tortorise设置：

External Programm格式：(Sysmac Studio安装路径)\SysmacDiff.exe -gitdiff %base %mine %bpath%brev %yrev

案例演示

分支策略中的五步具体操作如下：

准备工作

​ 1. 先在SysmacStudio中创建项目命名为test_project，然后在该项目中增加两个开发者所需要的程序，然后将程序调添加到任务：

​ 2. 在VC目录下创建文件夹my_test文件夹，再在该文件夹下创建一个notice.txt文件（随便建个什么文件都行）用于master分支的首次提交：

​ 3. 在Gitee新建远程仓库MyTest如下：

第一步

1. 初始化本地仓库、提交、推送至远程仓库的master分支：

2. 创建并切换到developer分支：

   

3. 将之前创建my_project项目导入到developer分支，提交并推送至远程仓库的developer分支（推送方法同上）：

   

4. 在developer分支下创建common分支用于修改公共参数部分，将common分支推送远程仓库（新建分支和推送分支方法同上，往后的该步骤不再截图）

第二步

1. 开发人员1 在自己电脑的VC目录下创建一个dev1文件夹，克隆远程仓库的developer分支到本地dev1文件夹下：

2. 在developere分支下创建dev1和common1两个分支，切换到common1分支，先从远程仓库的common分支拉取>，确保各个开发人员公共参数是一致的，防止在合并时出现冲突：

   

3. ，打开工程在EtherCat下增加一个伺服、新建一个轴、创建结构体、新建全局变量：

   

3. common1提交修改，推送到远程仓库的common分支；

4. 切换到dev1分支将common1分支合并至dev1分支：

5. 查看合并后的dev1开发分支：

6. 开发人员1在dev1分支下写自己的程序：

   
   
   
   

7. 开发人员1的功能完成后提交修改开发者2的操作同上。

第三步

1. 开发者1切换到本地仓库的developer分支，先拉取远程仓库的developer分支，将本地仓库的developer分支和dev1分支合并，然后将本地仓库的developer分支推送到远程仓库的developer分支。到此开发人员1的所有工作就完成了。

2. 开发者2切换到本地仓库的developer分支，先拉取远程仓库的developer分支，将本地仓库的developer分支和dev2分支合并，然后再将本地仓库的developer分支推送到远程仓库的developer分支。

第四步

​ 测试人员拉取远程仓库的developer分支，创建release分支后切换到该分支开始测试，如果发现错误修改后与本地仓库的developer分支合并，再分别推送到远程仓库的developer分支和master分支。

第五步

​ 项目交付后如果出现bug，先在master分支上建一个临时修复分支hotfix，修复完后合并到master分支，然后删除hotfix分支。

扩展

创建标签

# Tag和Branch的原理是差不多的
git tag -a 版本标签 -m '说明信息'
git push origin 版本标签

拉取远程仓库的master分支，打开git bash：

将tag推送到远程仓库：

远程仓库查看推送的tag：

合并冲突处理

​ 如果两个分支在合并时同样的文件在同样位置内容是不一样的，这时会产生冲突，需要手动处理冲突（详细参考手册）。在合并时尽量避免这种情况的发生。

sysmac studio版本控制用户手册：点击打开