项目环境搭建与工程拉取指南

type

status

date

slug

summary

PokerGame 项目环境搭建与工程拉取指南

1. 概述

欢迎加入 PokerGame 项目！

本篇文档旨在指导新成员完成项目开发环境的初始配置，包括安装必要的软件（Unity Hub, Unity Editor, Fork）以及从 Git 仓库拉取最新的项目代码。请严格按照以下步骤操作，以确保所有开发环境统一，避免后续出现不必要的问题。

2. 软件安装

在拉取工程之前，请先下载并安装以下开发必备软件。

2.1 安装 Unity Hub

Unity Hub 是管理 Unity 编辑器版本和项目的官方工具，是进行 Unity 开发的必备软件。

功能：管理多个 Unity 版本、创建和打开项目。

下载地址：UnityHubSetup.exe

安装步骤：下载后，双击 .exe 文件并按照默认提示完成安装即可。

2.2 安装 Unity Editor (版本 2022.3.62f3)

项目当前使用的 Unity 版本为 2022.3.62f3。请务必安装此特定版本以避免兼容性问题。

功能：项目开发的核心引擎。

下载地址：UnitySetup64-2022.3.62f3.exe

安装步骤：

下载完成后，运行安装程序。

在安装过程中，安装程序会关联 Unity Hub。

在选择安装模块的步骤时，请根据项目需求勾选必要的模块，例如 Android Build Support、iOS Build Support 等。（具体需要哪些模块可以咨询项目负责人）。

完成安装后，打开 Unity Hub，在 “安装” (Installs) 列表中应该能看到 2022.3.62f3 版本。

2.3 安装 Fork (Git 客户端)

Fork 是一款简单易用的 Git 图形化客户端，推荐使用它来管理代码版本，进行拉取、提交、推送等操作。

功能：图形化管理 Git 仓库。

下载地址：Fork-2.15.4.exe

安装步骤：下载后，双击 .exe 文件并按照默认提示完成安装。

3. Git 仓库配置与工程拉取

完成软件安装后，接下来需要配置 Git 仓库访问权限并拉取项目代码。

3.1 注册 Git 账号

我们的项目代码托管在自建的 Git 服务器上。

访问注册页面：请在浏览器中打开以下地址进行账号注册。

https://git.home.vfxskill.com:18080/

完成注册：在页面上点击注册 (Register) 或类似按钮，填写您的用户名、邮箱和密码，完成账号创建。

3.2 申请协作者权限

注册完成后，您的账号默认没有访问 pokergame 项目的权限。

关键步骤： 请将您刚刚注册的【用户名】告知项目管理员 管理员收到您的用户名后，会将您的账号添加为项目的协作者，届时您才能访问和拉取代码。

3.3 使用 Fork 拉取工程

在获得协作者权限后，请按照以下步骤拉取工程代码。

打开 Fork 软件。

点击菜单栏的 File -> Clone...。

在弹出的克隆窗口中，填写以下信息：

Repository URL / URL： https://git.home.vfxskill.com:18080/harry/pokergame

Name / 名称：会自动填充为 pokergame。

Parent Folder / 保存路径：选择一个本地文件夹用于存放项目。强烈建议选择一个不含中文和空格的英文路径（例如：D:\\UnityProjects\\）。

点击 Clone 按钮。

此时 Fork 可能会弹出窗口要求您输入凭据（用户名和密码），请输入您在 3.1 步骤中注册的 Git 账号和密码。

Fork 会开始从服务器下载项目文件，请耐心等待其完成。

4. 在 Unity Hub 中打开项目

代码拉取完成后，最后一步是在 Unity Hub 中添加并打开项目。

打开 Unity Hub。

切换到 “项目” (Projects) 标签页。

点击右上角的 “打开” (Open) 按钮。

在弹出的文件浏览器中，导航到您刚刚通过 Fork 拉取工程的本地路径（例如 D:\\UnityProjects\\pokergame），然后选择该文件夹。

项目将会被添加到 Unity Hub 的项目列表中。请确保列表右侧显示的 Unity 版本是 2022.3.62f3。

点击项目名称，Unity 编辑器将启动并开始加载项目。

注意：首次打开项目时，Unity 需要导入所有资源并生成本地缓存，这个过程可能会持续较长时间，请耐心等待直至完成。

至此，您已成功完成 PokerGame 项目的开发环境搭建和工程拉取。祝您开发愉快！