168 lines
4.1 KiB
Markdown
168 lines
4.1 KiB
Markdown
# 《报恩榴莲》微信小程序 - 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/)
|
||
|
||
---
|
||
|
||
**祝你开发顺利！🚀**
|
||
|
||
如有任何问题，随时询问。
|