# flutter_minesweeper

**Repository Path**: mikenchen/flutter_minesweeper

## Basic Information

- **Project Name**: flutter_minesweeper
- **Description**: Flutter创建的扫雷小游戏
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎮 Flutter 扫雷游戏

一个使用 Flutter 框架开发的经典扫雷游戏，支持多平台运行。

## ✨ 功能特性

- **多种难度级别**：简单、中等、困难三种难度选择
- **完整游戏功能**：左键点击、右键标记、双击展开、Ctrl+左键快速排除
- **音效支持**：游戏胜利和失败音效
- **计时器**：实时记录游戏时间
- **响应式设计**：适配不同屏幕尺寸
- **多平台支持**：Android、iOS、Windows、macOS、Linux、Web

## 🎯 游戏玩法

### 基本操作
- **左键点击**：揭开格子
- **右键点击**：标记地雷（红旗）
- **再次右键**：切换为问号标记
- **双击数字**：自动揭开相邻格子
- **Ctrl+左键**：快速排除已标记区域

### 游戏规则
- 目标：揭开所有非地雷格子
- 数字表示周围8个格子中的地雷数量
- 避免踩到地雷，否则游戏结束

## 🚀 快速开始

### 环境要求
- Flutter SDK 3.9.2+
- Dart SDK

### 安装运行

1. **克隆项目**
```bash
git clone https://gitee.com/mikenchen/flutter_minesweeper.git
cd flutter_minesweeper
```

2. **安装依赖**
```bash
flutter pub get
```

3. **运行项目**
```bash
# 运行在 Android 设备
flutter run

# 运行在 Web 浏览器
flutter run -d chrome

# 运行在桌面平台
flutter run -d windows  # 或 linux, macos
```

## 🏗️ 项目结构

```
lib/
├── main.dart          # 应用入口
├── game_screen.dart   # 主游戏界面
├── models/            # 数据模型
│   └── game_model.dart # 游戏逻辑
├── services/          # 服务层
│   └── audio_service.dart # 音效服务
└── widgets/           # 自定义组件
    ├── game_board.dart    # 游戏棋盘
    └── difficulty_dialog.dart # 难度选择对话框
```

## 📱 平台支持

- ✅ Android
- ✅ iOS  
- ✅ Windows
- ✅ macOS
- ✅ Linux
- ✅ Web

## 🔧 开发说明

### 主要依赖
- `flutter`: Flutter SDK
- `audioplayers`: 音效播放
- `cupertino_icons`: iOS风格图标

### 构建发布
```bash
# 构建 Android APK
flutter build apk

# 构建 iOS App
flutter build ios

# 构建 Web 版本
flutter build web

# 构建桌面版本
flutter build windows  # 或 linux, macos
```

## 🎮 游戏截图

![主界面](images/flutter_minesweeper.exe_20251119_222402.png)
![难度选择](images/flutter_minesweeper.exe_20251119_222411.png)
![语言选择](images/flutter_minesweeper.exe_20251119_222419.png)
![开始游戏](images/flutter_minesweeper.exe_20251119_222448.png)
![游戏失败](images/flutter_minesweeper.exe_20251119_222512.png)
![游戏成功](images/flutter_minesweeper.exe_20251119_222557.png)
## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目！

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🔗 相关链接

- [Flutter 官方文档](https://flutter.dev)
- [Dart 语言文档](https://dart.dev)
- [Material Design](https://material.io/design)