Một dự án Flutter được cấu trúc như thế nào?

Question

Accepted Answer

Một dự án Flutter có **cấu trúc** chuẩn — với các thư mục cho code Dart, code đặc thù nền tảng, asset, và cấu hình. Hiểu cấu trúc và các file then chốt (đặc biệt là `pubspec.yaml` và `lib/`) là cần thiết để điều hướng và xây dựng ứng dụng Flutter.

## Các thư mục và file then chốt

```text
my_app/
  lib/                  → CODE DART của bạn nằm ở đây (trái tim của ứng dụng)
    main.dart           → ĐIỂM VÀO (hàm main(); ứng dụng bắt đầu ở đây)
  pubspec.yaml          → cấu hình dự án: DEPENDENCY, asset, metadata (rất quan trọng)
  android/              → dự án/cấu hình native đặc thù Android
  ios/                  → dự án/cấu hình native đặc thù iOS
  web/ windows/ v.v.    → các thư mục nền tảng khác
  test/                 → các bài test
  assets/               → image, font, v.v. (được khai báo trong pubspec.yaml)
```

## pubspec.yaml — file cấu hình then chốt

```yaml
name: my_app
dependencies:
  flutter:
    sdk: flutter
  http: ^1.0.0           # thêm package ở đây (từ pub.dev)
  provider: ^6.0.0
flutter:
  assets:
    - assets/images/     # khai báo asset để đóng gói
```

`pubspec.yaml` khai báo **dependency** (các package từ pub.dev), asset, và metadata — bạn chạy `flutter pub get` để cài đặt dependency.

## main.dart — điểm vào

```dart
import 'package:flutter/material.dart';

void main() => runApp(MyApp());      // runApp khởi động ứng dụng Flutter với một widget gốc

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(home: HomeScreen());   // widget gốc của ứng dụng
  }
}
```

## Tổ chức lib/ khi ứng dụng phát triển

```text
→ Ngoài main.dart, tổ chức lib/ thành các thư mục (theo tính năng hoặc theo lớp):
  lib/screens/, lib/widgets/, lib/models/, lib/services/, lib/providers/ (phổ biến)
→ Giữ code có tổ chức khi ứng dụng phát triển (phân tách mối quan tâm).
```

## Tại sao điều này quan trọng

Hiểu cách một dự án Flutter được cấu trúc là kiến thức thực hành cần thiết để điều hướng, xây dựng và tổ chức ứng dụng Flutter, nên đây là kiến thức nền tảng hữu ích.

Biết các **thư mục và file then chốt** — rằng **`lib/` chứa code Dart của bạn** (trái tim ứng dụng, nơi bạn dành phần lớn thời gian), **`main.dart` là điểm vào** (nơi ứng dụng bắt đầu qua `main()` và `runApp`), các **thư mục nền tảng** (`android/`, `ios/`, v.v. cho code native đặc thù nền tảng), các thư mục `test/` và `assets/` — là cần thiết để tìm đường trong một dự án Flutter.

Hiểu **`pubspec.yaml`** đặc biệt quan trọng: đó là file cấu hình then chốt khai báo **dependency** (các package từ pub.dev, hệ sinh thái package của Flutter), asset, và metadata — bạn sẽ chỉnh sửa nó liên tục để thêm package (chạy `flutter pub get` để cài đặt chúng), khiến nó trở thành trung tâm của phát triển Flutter.

Hiểu **main.dart và điểm vào** (cách `main()` và `runApp` khởi động ứng dụng với một widget gốc) làm rõ cách một ứng dụng Flutter bắt đầu.

Hiểu cách **tổ chức `lib/` khi ứng dụng phát triển** (thành các thư mục theo tính năng hoặc theo lớp — screens, widgets, models, services — để phân tách mối quan tâm) phản ánh thực hành tốt cho các dự án dễ bảo trì.

Vì làm việc với Flutter đòi hỏi điều hướng cấu trúc dự án, quản lý dependency qua pubspec.yaml, hiểu điểm vào, và tổ chức code, và vì kiến thức này là nền tảng thực hành cần thiết cho bất kỳ phát triển Flutter nào, hiểu cách một dự án Flutter được cấu trúc — các thư mục then chốt, pubspec.yaml, điểm vào, và tổ chức code — là kiến thức thực hành nền tảng có giá trị để làm việc với các dự án Flutter, cần thiết để xây dựng và bảo trì ứng dụng và là một năng lực cơ bản cho phát triển Flutter.