# vibe-coding-107

**Repository Path**: EverywhereGodLantern/vibe-coding-107

## Basic Information

- **Project Name**: vibe-coding-107
- **Description**: 咻咻快传，技术栈：flutter
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 咻咻快传 — 局域网文件分享工具

类似：localsend / flix / 百灵快传 / 快牙

跨平台 P2P 文件分享与文本聊天，支持 WiFi 和蓝牙传输。

---

## 环境准备

```bash
# 安装 Flutter SDK (>=3.12.2)
flutter doctor

# 检查所有依赖是否就绪
flutter doctor -v
```

**必需工具：**
- Flutter SDK >= 3.12.2
- Dart SDK >= 3.12.2
- Android Studio / Xcode（对应平台）
- Chrome（Web 开发）

> Android SDK: https://developer.android.google.cn/studio?hl=zh-cn#command-line-tools-only

---

## 运行

```bash
cd swiftshare

# 获取依赖
flutter pub get

# 生成 Drift 数据库代码
dart run build_runner build --delete-conflicting-outputs

# 查看可用设备
flutter devices

# 运行到指定平台
flutter run -d chrome           # Web
flutter run -d windows          # Windows
flutter run -d macos            # macOS
flutter run -d linux            # Linux
flutter run -d <android-id>     # Android
flutter run -d <ios-id>         # iOS
```

**热重载：** 运行后按 `r` 热重载，`R` 完全重启。

---

## 构建

### Android

```bash
# APK（通用）
flutter build apk

# APK（按架构分包，减小体积）
flutter build apk --split-per-abi

# App Bundle（上架 Google Play）
flutter build appbundle
```

输出路径：`build/app/outputs/`

### iOS

```bash
flutter build ios --release
```

然后用 Xcode 打开 `ios/Runner.xcworkspace` 进行签名和打包。

### macOS

```bash
flutter build macos --release
```

输出路径：`build/macos/Build/Products/Release/`

### Windows

```bash
flutter build windows --release
```

输出路径：`build/windows/x64/runner/Release/`

### Linux

```bash
flutter build linux --release
```

输出路径：`build/linux/x64/release/bundle/`

### Web

```bash
flutter build web --release
```

输出路径：`build/web/`

可部署到任何静态文件服务器（Nginx、Cloudflare Pages、Vercel 等）。

---

## 发布

### Android

1. 生成签名密钥：
   ```bash
   keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key
   ```

2. 配置 `android/key.properties`

3. 构建 AAB：
   ```bash
   flutter build appbundle --release
   ```

4. 上传到 Google Play Console

### iOS

1. 在 Apple Developer 配置 Provisioning Profile
2. Xcode 中设置 Signing & Capabilities
3. Archive → Export → App Store Connect

### macOS

1. Apple Developer 签名 + 公证
2. Xcode Archive → Export

### Windows

1. 构建后用 Inno Setup 或 MSIX 打包
2. 发布到 Microsoft Store 或直接分发

### Linux

1. 构建后打包为 AppImage / deb / flatpak
2. 发布到 Flathub 或直接分发

### Web

```bash
flutter build web --release
# 将 build/web/ 部署到静态托管
```

---

## 平台特性

| 功能 | Android | iOS | macOS | Windows | Linux | Web |
|------|---------|-----|-------|---------|-------|-----|
| BLE 发现 | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| mDNS 发现 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| WiFi/WebRTC | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| TCP 直连 | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| 蓝牙传输 | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ❌ |
| 文本聊天 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

---

## 项目结构

```
swiftshare/
├── lib/
│   ├── core/           # 常量、协议、工具类
│   ├── features/       # 功能模块（发现、连接、传输、聊天、设置）
│   ├── infrastructure/ # 数据库、蓝牙、网络
│   ├── platform/       # 平台通道接口
│   └── ui/             # 页面、组件、主题
├── android/            # Android 原生代码
├── ios/                # iOS 原生代码
├── macos/              # macOS 原生代码
├── windows/            # Windows 原生代码
├── linux/              # Linux 原生代码
└── web/                # Web 适配
```

---

## 测试

```bash
# 单元测试
flutter test

# 集成测试
flutter test integration_test/
```