Dan Tech Academy
Sau bài này bạn sẽ
  • Cài Flutter SDK và thêm vào PATH đúng cách cho hệ điều hành của bạn
  • Chuẩn bị ít nhất một nơi chạy app: emulator Android, simulator iOS hoặc máy thật
Thời lượng8 phút
Độ khóBeginner

Cài Flutter SDK và flutter doctor

Cài Flutter SDK trên macOS, Windows, Linux, đọc từng dòng flutter doctor và xử lý các cảnh báo thường gặp.

Trong 10 ngày tới, bạn sẽ đi từ số 0 đến một app Flutter có kiến trúc, chạy trên máy thật - cùng một codebase cho cả Android lẫn iOS. Ngày đầu chỉ có một mục tiêu, và nó có thể đo được bằng một lệnh: flutter doctor báo xanh.

Setup là ngày nhiều người bỏ cuộc nhất. Bài này đi chậm và xử lý sẵn các bẫy phổ biến - làm đúng một lần, không quay lại nữa.

Yêu Cầu Máy

Thành phầnTối thiểuGhi chú
RAM8GB16GB thoải mái hơn nhiều
Ổ trống25GBSDK + Android toolchain khá nặng
OSWindows 10+, macOS 12+, Ubuntu 20.04+

Build app iOS cần macOS. Dùng Windows/Linux bạn vẫn học được 100% khóa này với Android; code bạn viết chạy được trên iOS khi có máy Mac (hoặc dịch vụ build đám mây) sau này.

Phần 1: Cài Flutter SDK

Cách chuẩn và ít lỗi nhất hiện nay: cài qua VS Code extension hoặc tải trực tiếp từ docs.flutter.dev/get-started. Chọn hệ điều hành của bạn và làm theo hướng dẫn official. Vài điểm hay vấp:

  • Đường dẫn cài: chọn thư mục không có dấu cách và không cần quyền admin, ví dụ ~/development/flutter (macOS/Linux) hoặc C:\dev\flutter (Windows). Đừng cài vào Program Files.
  • PATH: sau khi giải nén, phải thêm flutter/bin vào PATH. Quên bước này là nguồn của lỗi flutter: command not found.
  • Sau khi thêm PATH, mở terminal mới rồi kiểm tra:
bash
flutter --version

Thấy số version in ra là SDK đã vào đúng chỗ.

Phần 2: flutter doctor - Bác Sĩ Toàn Khoa

bash
flutter doctor

Lệnh này khám tổng quát máy bạn và in ra từng hạng mục. Output điển hình lần đầu:

js
[✓] Flutter (Channel stable, 3.x.x)
[!] Android toolchain - develop for Android devices
    ✗ cmdline-tools component is missing
[✓] Chrome - develop for the web
[!] Xcode - develop for iOS and macOS (chỉ hiện trên macOS)
[✓] VS Code
[✗] Connected device

Cách đọc: ✓ là ổn, ! là thiếu một phần, ✗ là chưa có. Không cần xanh hết mọi dòng - bạn chỉ cần xanh các dòng phục vụ mục tiêu của khóa:

Hạng mụcCần cho khóa?Cách sửa phổ biến
FlutterBắt buộcĐã xong ở phần 1
Android toolchainBắt buộcCài Android Studio (bên dưới) rồi chạy lệnh doctor gợi ý
XcodeChỉ khi build iOS trên macOSCài Xcode từ App Store, chạy 2 lệnh doctor in ra
ChromeKhôngBỏ qua
Connected deviceBắt buộcPhần 3

Với Android toolchain: cài Android Studio từ developer.android.com/studio (Flutter dùng SDK và emulator của nó, kể cả khi bạn code bằng VS Code). Sau đó chạy đúng các lệnh mà flutter doctor gợi ý - thường là cài cmdline-tools trong SDK Manager và:

bash
flutter doctor --android-licenses

Gõ y chấp nhận hết. Chạy lại flutter doctor sau mỗi lần sửa để xem tiến triển.

Phần 3: Nơi Chạy App

Chọn ít nhất một, máy thật luôn là lựa chọn tốt nhất nếu có:

Máy Android thật

  1. Settings → About phone, nhấn 7 lần vào Build number để mở Developer options.
  2. Bật USB debugging trong Settings → System → Developer options.
  3. Cắm cáp, chọn Allow khi điện thoại hỏi.

Emulator Android

Mở Android Studio → Device Manager → Create Virtual Device → chọn Pixel 8 + system image mới nhất có chữ Recommended → Finish → nhấn Play.

iPhone / Simulator (chỉ macOS)

  • Simulator: open -a Simulator sau khi cài Xcode.
  • iPhone thật: cần cáp và bật Developer Mode trong Settings của máy - phần này Xcode sẽ hướng dẫn khi bạn chạy lần đầu ở bài sau.

Phần 4: Kiểm Tra Cuối

bash
flutter devices

Cần thấy ít nhất một device trong danh sách. Nếu trống: emulator chưa khởi động xong, hoặc máy thật chưa Allow USB debugging, hoặc cáp chỉ sạc không truyền data - thử cáp khác.

Phần khó nhất của cả tuần đã xong. Bài sau: tạo project đầu tiên và gặp tính năng khiến Flutter nổi tiếng - hot reload.

Đăng nhập