前置条件

• Unity 版本：请确认与项目一致的 Unity 版本
• Git 已安装并配置好 SSH 密钥
• 必须安装 Git LFS：本项目使用 Git LFS 管理大型文件（fbx、png、wav 等图片/音视频/3D模型文件）。未安装 LFS 会导致这些文件只下载到指针文件，Unity 打开会全部报错。

安装 Git LFS：

# 或通过命令行安装后初始化
git lfs install

拉取步骤

1. 克隆仓库

HTTPS 方式：

git clone https://git.bamboogames.top/Fishing-Travel/FT-Mini.git

SSH 方式：

git clone ssh://git@git.bamboogames.top:2222/Fishing-Travel/FT-Mini.git

进入项目目录：

cd FT-Mini

2. 确认 LFS 文件是否正常拉取

克隆完成后，检查 LFS 文件是否下载成功：

git lfs ls-files | head -20

如果输出显示文件大小为 0 或显示指针内容（如 version https://git-lfs...），说明 LFS 没有正常工作，执行：

git lfs pull

3. 打开 Unity 项目

1. 打开 Unity Hub，点击 Add（添加项目）
2. 选择克隆下来的 FT-Mini/Client 目录（注意是 Client 子目录）
3. 等待 Unity 首次导入资源（时间较长，请耐心等待）
4. 默认使用Android 打开 注意不要使用默认打开，资源转换成Android 会比较慢

4. 首次导入完成后的确认

Unity 导入完成后，检查 Console 窗口是否有 Missing Prefab 相关的红色报错。如果有，请联系项目维护者确认 meta 文件是否完整。

打包

在 Unity 菜单栏中，所有打包相关功能位于 Tools 菜单下：

Android 打包

• Tools → Build → APK — 打 APK 包
• Tools → Build → APK Agg — APK (AGG) 包，带有打点

注意事项

• 不要让 Unity 重新生成 .meta 文件：如果 .meta 文件丢失或被 Unity 重新生成，会导致所有资源引用断裂（Prefab 变成 Missing）。拉取时确保所有 .meta 文件都已正确下载。
• 切换分支前先提交或暂存：未提交的修改直接切换分支可能导致 Unity 资源状态异常。
• Library 目录：Client/Library 目录不会提交到 Git，首次打开 Unity 会自动生成，属于正常现象
• 内容比较多，clone 可能耗时比较长