Techmino-Series 开发环境搭建教程

Windows

1. 安装Git，这是用于联网同步工程文件夹的工具
2. 安装love2d，这是运行项目的游戏引擎
   1. 点击 Love2d 打开官网，根据自己电脑下载64位或者32位的安装包，用zipped压缩包就可以
   2. 确定love2d安装在哪了，把路径复制一下，之后要用
3. 安装VS Code (VSC)，这是编辑代码的工具 【记事本也行，但相信我，别这么干】
   1. 点击 VS Code 打开官网并安装
   2. 在VSC中配置Git
      1. VSC其实会自动识别到安装了Git然后打配合
      2. 由于后续的一些操作会涉及到身份验证，比如一些仓库并不对所有人公开，你需要向VSC证明你是某个GitHub账号的持有者，所以你需要在VSC中登录你的GitHub账号
         1. VSC左下角有个账号图标，点它然后按照指示登录，之后在VSC内进行的一些GitHub操作就可以顺利执行
         2. 【超超纲】为了向Github证明你是你，除了进行“在VSC登录Github账号”这个操作外，你还可以进行SSH Key的配置
            1. 在Git需要向Github服务器证明你是Github的某用户时，如果你进行的操作的仓库在本地保存的链接不是HTTPS链接，而是SSH链接
               那么Git就会自动寻找本地的SSH Key信息（用户文件夹里的.ssh文件夹里的id_rsa.pub）并和操作一起提交给Github服务器来证明你是你
            2. 打开命令行（当前位置无所谓），执行 ssh-keygen -t rsa -b 4096 -C 邮箱
               1. 除了ssh-keygen命令外的参数都可以不写但执行的时候还会再一个个问你，所以你还是写上吧，在此也解释一下功能
               2. -t rsa 是使用RSA算法，这个使用最广泛
               3. -b 4096 是指定密钥长度为4096位，一般至少用2048就足够安全
               4. -C 邮箱 是注释，没有实际功能，只是为了方便你确认哪个是哪个，用邮箱是因为之后准备给Github用
               5. 执行过程中还会询问你要不要给密钥文件再设一个密码，设了的话每次使用的时都要再手动输入密码，如果你手头使用的电脑不是你自己的就最好这样，是你的密钥文件的最后一道保护
               6. 然后你就可以去用户文件夹里看到一个.ssh文件夹，里面包含一个绝密的id_rsa和公开的id_rsa.pub文件（都是文本文件）
               7. 打开id_rsa.pub文件，把里面的所有内容复制，再打开Github网页，去个人设置找到“SSH & GPG Key”一栏选择“New SSH Key”并把刚刚复制的公开密钥粘贴进去，保存
               8. 之后你用SSH链接保存的远程Github仓库就会使用这套ssh方案来验证身份了
            3. 之后会让你输入保存路径，直接回车就会保存在默认路径（用户文件夹里的.ssh文件夹里）
      3. 【超纲】如果你需要修改代码并提交，那么你还需要配置一下Git的用户名和邮箱，给你所修改来签名
         1. 打开命令行（当前位置无所谓），执行 git config --global user.name MrZ 命令，记得把MrZ换成你的名字（那个普通的用户名即可，不必是那个唯一的用户ID）
         2. 【补充】其实这两个命令就是在修改用户文件夹（C:\Users\用户名）里的 .gitconfig 文件，可以去找出来看看里面写了什么，也可以拖进VSC窗口里手动编辑这个文件来进行配置，你可以试试用这个办法来跳过下一步
         3. 再执行 git config --global user.email 命令，记得换成你自己的邮箱（重要，应当是你在GitHub登记的邮箱）
   3. 下载游戏项目
      1. 去项目仓库首页点开那个很显眼的“Code”绿色按钮，点开有个小弹窗里面有一行地址，复制它
      2. 打开VSC的命令面板找到命令 Git: Clone 执行，然后选择一个文件夹作为项目文件夹的下载位置，就下载好了（下完了后应该会让你立刻打开）
      3. 【超纲】对于包含子模块的仓库，你需要知道怎么初始化/更新子模块
         1. 打开命令行，cd到项目文件夹，然后执行 git submodule update --init 命令来下载子模块的代码
         2. 未来如需更新还要执行同样的命令git submodule update，另一个更有参与感的等价的方法是在控制台里cd进子模块文件夹然后执行 git pull （最后别忘了再 cd .. 出来）
   4. 安装Love2D执行插件用于启动项目 【不然你就得手动在命令行里执行 /path/to/love/love.exe /path/to/project 了】
      1. VSC插件市场找到 Love2D executor 插件并安装 （此插件不唯一，有好几个差不多的，甚至快捷键都一样: love-launcher LÖVE Launcher Löve2d Launcher）
      2. 打开VSC的设置，搜索love2d，应该可以搜到这个插件的设置，有一个路径path配置，填入安装love2d后你记录的路径
      3. 之后你就可以在命令面板里找到一个叫 love2d-executor.run 的命令（不同插件不一样，不过搜love估计都能搜到），选它就会把当前VSC打开的“工作文件夹”路径丢给你安装的love2d.exe执行，也就是运行当前项目
      4. 你还可以给上面这条VSC命令配置一个快捷键比如 Alt+L，一键启动更方便
   5. 安装Lua语言服务插件，用于代码高亮和自动补全 【不然你就得纯手工敲代码了】
      1. VSC插件市场找到 Lua (sumneko) 插件并安装
      2. 去命令面板中搜索到 Lua: Open Addon Manager 命令并执行，在打开的页面中搜索LÖVE并安装（就一个）

Linux

我相信你不需要我教，以下是关键词： git, submodule love2d

macOS

不熟，你加油

Android

你是超人，我也不会，你加油