# flutter-wechat

**Repository Path**: getbetter/flutter-wechat

## Basic Information

- **Project Name**: flutter-wechat
- **Description**: 开发一个类似微信的flutter App
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter WeChat Clone

开发一个类似微信的跨平台 Flutter App（支持 Android、iOS、Web），并配套基于 NestJS 构建的后端服务。

---

## 📂 项目结构

项目采用前后端分离的架构：
- **`wechat_app/`**：基于 **Flutter** 的移动端前端应用。
- **`wechat-server/`**：基于 **NestJS + TypeORM (SQLite)** 的后端服务应用。

---

## 🚀 后端服务 (NestJS Server) 启动指南

### 1. 安装依赖
进入 `wechat-server` 目录并使用 `pnpm` 安装依赖：
```bash
cd wechat-server
pnpm install
```

### 2. 运行后端服务
- **开发环境启动（支持热重载，推荐）**：
  ```bash
  pnpm start:dev
  ```
- **生产环境启动**：
  ```bash
  pnpm start
  ```

---

## 📱 移动前端 (Flutter App) 开发与调试

### 1. 运行调试（本地开发）
确保您的测试设备（真机/模拟器/浏览器）已连接，进入 `wechat_app` 目录执行：
- **标准设备调试**：
  ```bash
  cd wechat_app
  flutter run
  ```
- **在 Chrome 浏览器中运行**：
  ```bash
  flutter run -d chrome
  ```

---

## 🔌 联调与配置安卓模拟器（以 MuMu 模拟器为例）

### 1. 模拟器开发者配置
1. 打开 **MuMu 模拟器**，进入系统的 **设置** -> **关于手机**。
2. 连续点击 **版本号** 5~7 次，开启“开发者选项”。
3. 返回上一级设置，进入 **系统** -> **开发者选项**，确保 **USB 调试** 已经开启。

### 2. ADB 连接命令行
不同版本的 MuMu 模拟器 ADB 调试端口不同，请在电脑终端中执行连接：
- **MuMu 模拟器 12**：
  ```bash
  adb connect 127.0.0.1:16384
  ```
- **MuMu 模拟器 6 / 传统版**：
  ```bash
  adb connect 127.0.0.1:7555
  ```
连接成功后，运行 `flutter devices` 应该能在设备列表中看到该 Android 设备。

---

## 📦 应用打包指南

### 1. 打包 Android (APK)
在 `wechat_app` 目录下执行以下打包命令：
- **打包正式版 APK（Release 包）**：
  ```bash
  flutter build apk --release
  ```
  *输出路径：`build/app/outputs/flutter-apk/app-release.apk`*
- **分架构打包（大幅减小安装包体积）**：
  ```bash
  flutter build apk --split-per-abi
  ```
  *这会为不同手机的 CPU 架构（如 arm64-v8a）分别生成体积小巧的专属 APK 包。*
- **打包用于发布 Google Play 商店的 App Bundle**：
  ```bash
  flutter build appbundle
  ```

### 2. 打包 iOS (需要在 macOS 苹果电脑环境)
- **打包生成 App 归档包 (IPA)**：
  ```bash
  flutter build ipa
  ```
  *根据提示前往 Xcode 归档并导出用于分发的 `.ipa` 文件。*
- **仅生成构建编译产物**：
  ```bash
  flutter build ios
  ```

---

## 🛠️ 国内构建加速及常见排错

如果您在国内进行 Android 构建时遇到 `Gradle 下载极其缓慢`、`Google 镜像下载超时`、`52% 卡住安装 CMake` 等网络问题，请参考我们为您编写的完整开发环境排错文档。