版本控制
本页面镜像自 BedrockWiki
根据原始项目协议授权。本文经过AI翻译处理,如有内容遗漏,可以提交PR进行补充。
版本控制的核心概念是定期备份代码迭代版本,以便在需要时回滚到特定版本。最基本的版本控制可以通过每天将附加包打包成.zip
并上传到谷歌网盘实现。这并非不合理,但存在三个显著缺陷,而专业的版本控制系统(VCS)能够有效解决:
- 版本差异比对困难
- 实际回滚到旧版本操作繁琐
- 对团队协作毫无帮助
本教程将介绍git
工具的基本使用方法,以及免费的在线git托管服务GitHub
。任何人都可以跟随学习,但如果您身处团队协作环境或经常因忘记备份而丢失工作成果,将会获得最大收益。
本教程不会直接教授git
或GitHub
的基础操作,因为这些知识已有优质外部资源可供学习。重点将放在掌握基础后如何针对Minecraft项目进行工具配置。
Git
git
是安装在本地计算机上的版本管理工具,可对文件进行版本控制。您可以通过简短信息(例如"修复驯服后龙无法飞行的BUG")提交(commit
)文件变更,查看完整修改记录,并快速回滚到特定版本。
Git功能强大且是主流编程项目的标配工具。其应用于Minecraft开发的主要缺点是学习曲线陡峭。请保持耐心循序渐进。
完整的git
学习请参考git官方教程。
GitHub
GitHub是git项目(repository
仓库)的在线托管平台,允许多人同时协作开发。这对于地图制作尤为实用。通过GitHub托管,您还可以选择将代码公开,更方便地向世界分享您的附加包。
完整的GitHub学习请参考GitHub入门指南。
术语自测
如果您已学习至此,希望您已注册GitHub账号并对git
有初步了解。以下术语将在教程中使用,若不熟悉请自行查询:
- repository(仓库)
- branch(分支)
- commit(提交)
- github
- git
Git环境配置
本节假设您要将已有项目加入git管理。新建项目的操作流程类似。
目录结构
在附加包开发中使用git
的主要问题在于:git通常通过管理单个文件夹实现版本控制,而基岩版附加包资源分散在BP
和RP
两个文件夹。为解决此问题,我们将仓库完全置于com.mojang
文件夹之外,使用Windows符号链接(junctions
)实现文件夹映射。
将项目置于独立位置有以下优势:
- 可自由添加配置文件、工具、笔记、.bb文件等附加内容
- 可将RP和BP整合至同一仓库
- 所有项目可在统一位置查看,避免深埋于com.mojang目录中
创建Git仓库
为项目选择合适的位置。示例使用C:/sirlich/projects
。新建以项目命名的文件夹,示例项目名为wiki
。
右键点击文件夹选择"Open git Bash"
。若未显示此选项,可通过开始菜单打开git bash
并导航至项目目录。若未安装git bash
请立即安装。
输入命令:git init
。这将在项目中创建空白仓库。
链接现有RP和BP
接下来通过创建Windows符号链接让仓库识别您的RP和BP文件夹。符号链接相当于文件系统的虫洞,使文件看似同时存在于两个位置。删除/编辑/添加操作会实时同步。
输入命令:mklink /J wiki_RP "C:/path/to/RP/in/com/mojang"
mklink /J wiki_BP "C:/path/to/BP/in/com/mojang"
完成后,项目文件夹中将出现wiki_RP
和wiki_BP
目录,包含所有现有资源文件。
此时可按照前述教程将仓库推送至github
。
附加文件
由于我们通过符号链接创建仓库,可在项目文件夹中添加任意文件而不影响com.mojang目录。推荐追踪.bb
文件、封面设计文件(如.kra
格式)等。
您还可以添加笔记、视频文件等需要版本控制的任何内容。
VCS使用规范
使用版本控制系统需牢记以下要点:
- 开始工作前务必先
pull
拉取最新版本 - 频繁
commit
提交并push
推送 - 结束工作前必须
push
推送更改 - 若文件严重损坏,可随时重置到最近可用版本。经常提交/推送能最大限度减少损失
- 必须(强调)编写规范的提交信息,这在需要回滚时至关重要
mklink /J demo_RP "C:/Users/Steve/AppData/Local/Packages/Microsoft.MinecraftUWP_8wekyb3d8bbwe/LocalState/games/com.mojang/development_resource_packs/demoRP"