gratitude.durian.xpcool.com/wechat-miniprogram/QUICK_START.md

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

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

---

⏱️ 时间线

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

---

📋 步骤详解

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

• 如果未安装：点击下载
• 使用微信扫码登录

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

---

📚 下一步

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

1. 阅读完整文档

   • README.md - 项目介绍
   • TESTING_GUIDE.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 的"常见问题排查"章节
• 访问 微信开放社区
• 查阅 官方文档

---

祝你开发顺利！🚀

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