一个使用 Flutter 开发的跨平台五子棋游戏应用
- 下载 APK：
wuziqi.apk（18.17 MB） - 安装到 Android 手机
- 开始游戏
详细安装步骤请查看 快速使用指南.md
# 1. 进入项目目录
cd wuziqi_game
# 2. 获取依赖
flutter pub get
# 3. 运行应用（需连接设备）
flutter run或直接运行：
- Windows: 双击
运行应用.bat - 重新打包: 双击
重新打包APK.bat
- ✅ 标准五子棋规则：15×15 棋盘，五子连珠获胜
- ✅ 智能判定：自动检测横、竖、斜四个方向的胜负
- ✅ 悔棋功能：支持撤销上一步操作
- ✅ 重新开始：快速开始新局
- ✅ 精美界面：木质风格，Material Design 3
- ✅ 视觉效果：棋子高光、最后落子标记
- ✅ 实时信息：显示当前回合和步数统计
- ✅ 胜利动画：获胜时的精美弹窗动画
- ✅ Android（已打包）
- ✅ iOS（支持）
- ✅ Web（支持）
- ✅ Windows/Linux/macOS（支持）
┌─────────────────────────────┐
│ 🎮 五子棋 │
├─────────────────────────────┤
│ ╔═══════════════════════╗ │
│ ║ 当前回合：● 黑棋 ║ │
│ ║ 步数：12 ║ │
│ ╚═══════════════════════╝ │
├─────────────────────────────┤
│ ╔═══════════════════════╗ │
│ ║ ┌─┬─┬─┬─┬─┬─┬─┐ ║ │
│ ║ ├─●─●─○─┼─┼─┼─┤ ║ │
│ ║ ├─┼─●─○─○─┼─┼─┤ ║ │
│ ║ ├─┼─┼─●─┼─┼─┼─┤ ║ │
│ ║ ├─┼─○─┼─●─┼─┼─┤ ║ │
│ ║ └─┴─┴─┴─┴─┴─┴─┘ ║ │
│ ╚═══════════════════════╝ │
├─────────────────────────────┤
│ [↶ 悔棋] [⟳ 重新开始] │
└─────────────────────────────┘
Five in a Row/
├── wuziqi.apk # 📦 可安装的 APK 文件
├── 运行应用.bat # 🚀 快速运行脚本
├── 重新打包APK.bat # 📦 重新打包脚本
├── 项目完成说明.md # 📋 项目详细说明
├── 快速使用指南.md # 📖 使用指南
└── wuziqi_game/ # 💻 Flutter 项目源码
├── lib/ # 源代码目录
│ ├── models/ # 数据模型
│ │ ├── piece.dart # 棋子模型
│ │ └── game_model.dart # 游戏状态管理
│ ├── widgets/ # UI 组件
│ │ └── board_widget.dart # 棋盘组件
│ └── main.dart # 主程序入口
├── android/ # Android 配置
├── ios/ # iOS 配置
├── web/ # Web 配置
├── windows/ # Windows 配置
├── linux/ # Linux 配置
├── macos/ # macOS 配置
└── pubspec.yaml # 依赖配置
- 棋盘：15×15 标准棋盘
- 对弈：黑棋先手，白棋后手，轮流落子
- 获胜：率先在横、竖、斜任意方向连成五子者获胜
- 落子：点击棋盘交叉点
- 悔棋：点击"悔棋"按钮撤销上一步
- 重新开始：点击"重新开始"按钮开始新局
| 技术 | 说明 |
|---|---|
| Flutter | 跨平台 UI 框架 |
| Dart | 编程语言 |
| Material Design 3 | UI 设计规范 |
| ChangeNotifier | 状态管理 |
| CustomPainter | 自定义绘制 |
- 模型-视图分离：清晰的代码结构
- 状态管理：使用 ChangeNotifier 模式
- 自定义绘制：高性能的 Canvas 绘制
- 响应式布局：适配各种屏幕尺寸
- ✅ 无 Linter 错误
- ✅ 代码注释完善
- ✅ 命名规范统一
- ✅ 结构清晰易维护
| 文档 | 说明 |
|---|---|
| 快速使用指南.md | 安装、使用、常见问题 |
| 项目完成说明.md | 技术实现、开发过程 |
| README_CN.md | 项目详细说明 |
- 最低版本：Android 5.0（API 21）
- 推荐版本：Android 8.0+
- 存储空间：50MB
- 网络：无需联网
- Flutter：3.0+
- Dart：3.0+
- Android SDK：21+
- 精确的五子连珠判定算法
- 四个方向的胜负检测
- 完善的边界处理
- 木质风格配色
- 渐变背景效果
- 棋子高光和阴影
- 流畅的动画过渡
- 操作简单直观
- 即时反馈
- 防误操作保护
- 清晰的游戏状态显示
- 模块化设计
- 易于维护和扩展
- 完善的注释
- 规范的命名
- AI 对战模式
- 在线对战功能
- 棋谱保存与回放
- 计时功能
- 音效和背景音乐
- 主题切换
- 排行榜系统
- 多语言支持
- 下载
wuziqi.apk - 传输到 Android 手机
- 安装并开始游戏
cd wuziqi_game
flutter run双击 运行应用.bat（Windows）
欢迎提交 Issue 和 Pull Request！
如果你觉得这个项目不错，请给个 ⭐️ Star！
本项目仅供学习交流使用。
感谢 Flutter 团队提供的优秀框架！
🎮 开始游戏，享受五子棋的乐趣！
Made with ❤️ using Flutter