掌握版本控制:开发者 Git 与 GitHub 实用指南
程序员的生活已够艰难。为什么不把项目的版本控制外包给专门服务让生活更轻松?大多数 IT 程序员熟悉 Git,但对本社区一些 OT 程序员,这是全新概念。与不同同事协作同一项目时共享代码更麻烦,GitHub 等服务让协作共享变得简单。本博客引导您迈出使用 Git 和 GitHub 管理代码和项目的第一步。
本博客使用 GitHub 和 GitHub Windows 客户端,但请注意还有其他选择如 GitLab。我只是喜欢 GitHub Client 的易用性!
在 GitHub 上建立仓库
步骤 1 - 下载安装 GitHub Windows 客户端
实际上第一步是创建 GitHub 账号,但这超出本博客范围。
- 客户端可从这里下载。
- 按安装向导操作
- 登录 GitHub 账号
步骤 2 - 为项目创建文件夹或仓库
仓库是项目的存放地。每个项目建一个文件夹!每当该文件夹有变化,GitHub 客户端会检测并让您保存或推送变更到 GitHub 在线仓库。
- 点击 “Create a New Repository on your hard drive …”
- 给新仓库起名和描述。
- 可更改仓库路径或保持默认(偷懒方式)
- 勾选 “Initialize this repository with a README”(偷懒不代表不遵循最佳实践文档化代码!)
- 创建仓库
步骤 3 - 创建 PLCnext 项目
Git 适合文本文件。庆幸 PLCnext Engineer 有选项将项目保存为大量文本文件,完美适配 Git 和 GitHub 客户端!
- 打开 PLCnext Engineer 创建项目。
- 准备保存时,选择 “Save Project As” (F12)
- 浏览到 GitHub 仓库(默认:This PC/documents/GitHub)
- 保存为 “Uncompressed Project”
步骤 4 - 提交变更
要“保存”变更到仓库,需提交到分支。分支是什么稍后解释,现在只需记住:必须提交变更到分支才能保存。
给提交起个简短描述,以便记住具体改了什么!
步骤 5 - 发布或推送仓库
创建在线仓库的最后一步是推送本地仓库到 GitHub。轻松如按按钮或按 (ctrl + p)。选择代码是否私有、归个人或组织。
步骤 6 - 文档化!
按 (Ctrl + shift + G) 在浏览器查看 GitHub 上的在线仓库。Voila! 您的 PLCnext 项目已在 GitHub 上。还记得 “Initialize README”?那就是您现在看到的文本。在 README.md 中应解释项目结构、目的及未来参考的联系信息。
现在对 README.md 做些修改,点击铅笔图标。文件用 MarkDown 编写,更多 MarkDown 信息见这里。
改完后,再次提交到 master 分支!
步骤 7 - 拉取变更到本地仓库
Windows 客户端会检测到 GitHub 仓库有变更。别忘了拉取变更以基于最新版本工作!
提示与技巧
Issue Tracker
GitHub 有优秀的 Issue Tracker,用于跟踪软件已知问题并与利益相关者讨论解决方案
Projects
使用内置 Project Board 通过看板跟踪任务。若愿可用内置触发器自动化看板让生活更轻松。
Branches
啊,到了这里。我说过要解释分支!…… 让 GitHub 解释什么是分支……
要大量改动或实现新功能?创建分支隔离变更,通过拉取请求将 “feature branch” 合并到 master 分支。
Release
准备部署项目?创建 Release 加入 AS Build!
工业技术