# 《报恩榴莲》微信小程序 - 5分钟快速开始

> 🚀 从下载到运行，只需5分钟

---

## ⏱️ 时间线

```
00:00 - 打开微信开发者工具
00:02 - 导入项目
00:03 - 编译运行
00:05 - 开始游戏 ✅
```

---

## 📋 步骤详解

### 1️⃣ 打开微信开发者工具

- 如果未安装：[点击下载](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
- 使用微信扫码登录

### 2️⃣ 导入项目

1. 点击 **"+"** 或 **"导入项目"**
2. 项目目录选择：
   ```
   E:\xxcool\project\gratitude.durian.xpcool.com\wechat-miniprogram
   ```
3. AppID填写：
   - **测试阶段**：点击"注册测试号"（推荐）
   - **正式发布**：填写你的真实AppID
4. 点击 **"导入"**

### 3️⃣ 等待编译

- 首次导入需要编译（约10-30秒）
- 看到左侧模拟器显示游戏界面即成功

### 4️⃣ 测试游戏

在模拟器中：
1. 点击 **"开始游戏"** 按钮
2. 点击屏幕顶部区域掉落水果
3. 观察物理效果和合成逻辑
4. 尝试暂停、使用道具等功能

### 5️⃣ 真机测试（可选）

1. 点击工具栏 **"预览"** 按钮
2. 用微信扫描二维码
3. 在手机上体验完整游戏

---

## ✅ 验证清单

运行后检查以下功能是否正常：

- [ ] 主菜单页面正常显示
- [ ] 点击"开始游戏"进入游戏
- [ ] 水果能从顶部落下
- [ ] 水果受重力影响下落并堆积
- [ ] 两个相同等级水果接触时自动合成
- [ ] 分数随合成增加
- [ ] Boss进度条显示正确
- [ ] 暂停/继续按钮工作正常

**全部通过** → 核心玩法已跑通！🎉

---

## 🔧 常见问题

### Q: 导入时报错？

**A**: 检查以下几点：
- 目录路径是否正确（必须是 `wechat-miniprogram` 文件夹）
- AppID是否填写（可使用测试号）
- 微信开发者工具版本是否最新

### Q: 编译后白屏？

**A**: 
- 打开控制台（Ctrl+Shift+I）查看错误信息
- 确认 `app.json` 中的页面路径正确
- 重启微信开发者工具

### Q: 点击没反应？

**A**: 
- 确认Canvas上下文已初始化
- 检查控制台是否有JavaScript错误
- 尝试重新编译

### Q: 音频不播放？

**A**: 
- 当前音频文件需手动添加到 `audio/` 目录
- 模拟器音频支持有限，建议在真机上测试
- 查看详细配置指南：[TESTING_GUIDE.md](TESTING_GUIDE.md#音频资源配置)

---

## 📚 下一步

游戏运行成功后，你可以：

1. **阅读完整文档**
   - [README.md](README.md) - 项目介绍
   - [TESTING_GUIDE.md](TESTING_GUIDE.md) - 详细测试指南
   - [COMPARISON.md](COMPARISON.md) - 双版本对比

2. **自定义游戏**
   - 修改水果颜色和大小（`pages/game/index.js` 第5行）
   - 调整关卡难度（`pages/game/index.js` 第18行）
   - 替换美术资源（见TESTING_GUIDE.md）

3. **配置广告变现**
   - 开通流量主（需≥1000 UV）
   - 配置广告位ID（`app.js` 第58、78行）
   - 测试广告展示

4. **发布上线**
   - 点击"上传"按钮
   - 登录微信公众平台提交审核
   - 审核通过后发布

---

## 🎯 核心代码位置

如需修改游戏逻辑，主要文件：

| 功能 | 文件路径 | 关键行数 |
|-----|---------|---------|
| 游戏主逻辑 | `pages/game/index.js` | 全文件~800行 |
| 物理引擎 | `pages/game/index.js` | 257-296行 |
| 合成逻辑 | `pages/game/index.js` | 301-403行 |
| 音频管理 | `utils/AudioManager.js` | 全文件~170行 |
| 广告系统 | `app.js` | 40-100行 |
| 存档系统 | `app.js` | 15-35行 |

---

## 💡 小贴士

- **热重载**：修改代码后保存，模拟器自动刷新
- **真机调试**：比模拟器更准确，建议经常扫码测试
- **性能监控**：打开"性能面板"查看帧率和内存
- **控制台日志**：按F12打开开发者工具查看日志

---

## 🆘 需要帮助？

- 查看 [TESTING_GUIDE.md](TESTING_GUIDE.md) 的"常见问题排查"章节
- 访问 [微信开放社区](https://developers.weixin.qq.com/community/)
- 查阅 [官方文档](https://developers.weixin.qq.com/miniprogram/dev/framework/)

---

**祝你开发顺利！🚀**

如有任何问题，随时询问。