🛠️ Cài đặt môi trường

1. Yêu cầu hệ thống

macOS

• OS: macOS 10.14 (Mojave) trở lên
• Dung lượng: ~2.8 GB (không bao gồm IDE)
• Tools: git 2.x

Windows

• OS: Windows 10 64-bit trở lên
• Dung lượng: ~2.8 GB
• Tools: Git for Windows, PowerShell 5.0+

Linux

• OS: Ubuntu 20.04+, Fedora, hoặc tương đương
• Dung lượng: ~2.8 GB
• Thư viện: các thư viện chia sẻ cần thiết

---

2. Cài đặt Flutter SDK

Cách 1: Quick Start (Khuyến nghị)

Sử dụng VS Code extension để cài đặt tự động:

1. Mở VS Code
2. Cài extension Flutter từ marketplace
3. Mở Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
4. Gõ Flutter: New Project
5. Làm theo hướng dẫn tự động cài Flutter SDK

Cách 2: Cài đặt thủ công

macOS/Linux

# Clone Flutter SDK
git clone https://github.com/flutter/flutter.git -b stable

# Thêm vào PATH (thêm vào ~/.zshrc hoặc ~/.bashrc)
export PATH="$PATH:$HOME/flutter/bin"

# Reload terminal
source ~/.zshrc

Windows

1. Tải Flutter SDK từ flutter.dev
2. Giải nén vào thư mục (ví dụ: C:\src\flutter)
3. Thêm C:\src\flutter\bin vào PATH

---

3. Kiểm tra cài đặt

# Kiểm tra version
flutter --version

# Kiểm tra môi trường
flutter doctor

Kết quả mong đợi:

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.x.x)
[✓] Android toolchain
[✓] Xcode (macOS only)
[✓] Chrome
[✓] VS Code

---

4. Cài đặt IDE

VS Code (Khuyến nghị)

1. Tải VS Code
2. Cài extensions:
   • Flutter (bao gồm Dart)
   • Dart

Các extensions hữu ích khác:

• Awesome Flutter Snippets
• Flutter Widget Snippets
• Bracket Pair Colorizer

Android Studio

1. Tải Android Studio
2. Mở Preferences → Plugins
3. Cài plugin Flutter (auto-cài Dart)

---

5. Thiết lập Platform-specific

iOS (macOS only)

# Cài Xcode từ App Store
# Sau đó chạy:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

# Cài CocoaPods
sudo gem install cocoapods

Android

1. Cài Android Studio (nếu chưa có)
2. Mở SDK Manager → Cài Android SDK
3. Tạo Android Virtual Device (AVD)

# Chấp nhận licenses
flutter doctor --android-licenses

---

6. Kiểm tra lại với Flutter Doctor

flutter doctor -v

Xử lý các warning phổ biến:

Issue	Giải pháp
Android license not accepted	flutter doctor --android-licenses
Xcode không tìm thấy	Cài Xcode từ App Store
CocoaPods not installed	sudo gem install cocoapods
Chrome not found	Cài Chrome browser

---

7. Tạo ứng dụng test

# Tạo project mới
flutter create my_first_app

# Chạy app
cd my_first_app
flutter run

Nếu thấy app demo chạy thành công → Môi trường đã sẵn sàng! 🎉

---

📝 Tóm tắt

• Cài Flutter SDK qua git clone hoặc VS Code extension
• Chạy flutter doctor để kiểm tra môi trường
• Cài VS Code + Flutter extension (khuyến nghị)
• Setup Xcode (cho iOS) và Android Studio (cho Android)
• Test bằng flutter create và flutter run