This commit is contained in:
袁天才
2025-11-23 21:00:47 +08:00
parent 133941ed6a
commit 8c61688a26
25 changed files with 2068 additions and 4546 deletions

88
MACOS_BUILD_GUIDE.md Normal file
View File

@@ -0,0 +1,88 @@
# macOS 编译测试指南
## 快速开始
```bash
cd /Users/yuantiancai/work/FocusBuddy
flutter pub get
flutter run -d macos
```
## 环境要求
### Flutter
Flutter 已安装在 `/Users/yuantiancai/sdk/flutter`
```bash
# 添加到 PATH
export PATH="$PATH:$HOME/sdk/flutter/bin"
source ~/.zshrc
```
### Xcode
从 Mac App Store 安装 Xcode然后
```bash
sudo xcodebuild -license accept
```
### CocoaPods
使用 rbenv 安装 Ruby 3.x 和 CocoaPods
```bash
# 安装 rbenv
brew install rbenv ruby-build
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
# 安装 Ruby 3.3.8
rbenv install 3.3.8
rbenv global 3.3.8
# 安装 CocoaPods
gem install cocoapods
```
## 编译运行
```bash
# macOS 桌面
flutter run -d macos
# iOS 模拟器
open -a Simulator
flutter run -d ios
# Release 版本
flutter build macos --release
# 输出build/macos/Build/Products/Release/focus_buddy.app
```
## 常见问题
### CocoaPods 错误
```bash
cd ios && pod install && cd ..
flutter clean && flutter pub get
```
### 构建缓存问题
```bash
flutter clean
flutter pub get
```
### Xcode 签名
打开 `ios/Runner.xcworkspace`,在 "Signing & Capabilities" 配置开发团队
## 开发提示
运行时快捷键:
- `r` - 热重载
- `R` - 热重启
- `q` - 退出
代码检查:
```bash
flutter analyze
flutter test
```