Liubing\LB
3d8d4d18f3
先修复一下，错误的场景 删除不必要的钓场资产 修复into场景 update:更新meta文件，修复报错 update:修复资源 修复第一章节建造 修复建造第三章 update:删除多余内容 update:更新README.md update:还原图标 update:更新README update:更新配置
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
## 前置条件
|
||
|
||
- Unity 版本：请确认与项目一致的 Unity 版本
|
||
- Git 已安装并配置好 SSH 密钥
|
||
- **必须安装 Git LFS**：本项目使用 Git LFS 管理大型文件（fbx、png、wav 等图片/音视频/3D模型文件）。未安装 LFS 会导致这些文件只下载到指针文件，Unity 打开会全部报错。
|
||
|
||
安装 Git LFS：
|
||
```bash
|
||
# 或通过命令行安装后初始化
|
||
git lfs install
|
||
```
|
||
|
||
## 拉取步骤
|
||
|
||
### 1. 克隆仓库
|
||
|
||
HTTPS 方式：
|
||
```bash
|
||
git clone https://git.bamboogames.top/Fishing-Travel/FT-Mini.git
|
||
```
|
||
|
||
SSH 方式：
|
||
```bash
|
||
git clone ssh://git@git.bamboogames.top:2222/Fishing-Travel/FT-Mini.git
|
||
```
|
||
|
||
进入项目目录：
|
||
```bash
|
||
cd FT-Mini
|
||
```
|
||
|
||
### 2. 确认 LFS 文件是否正常拉取
|
||
|
||
克隆完成后，检查 LFS 文件是否下载成功：
|
||
```bash
|
||
git lfs ls-files | head -20
|
||
```
|
||
|
||
如果输出显示文件大小为 0 或显示指针内容（如 `version https://git-lfs...`），说明 LFS 没有正常工作，执行：
|
||
```bash
|
||
git lfs pull
|
||
```
|
||
|
||
### 3. 打开 Unity 项目
|
||
|
||
1. 打开 Unity Hub，点击 **Add**（添加项目）
|
||
2. 选择克隆下来的 `FT-Mini/Client` 目录（注意是 Client 子目录）
|
||
3. 等待 Unity 首次导入资源（时间较长，请耐心等待）
|
||
|
||
### 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 可能耗时比较长
|