跨平台开发 / 系统课时
看懂 Flutter 项目目录
看懂 Flutter 项目目录
本篇帮助你快速理解 Flutter 工程中常见目录和文件的职责,知道代码应该放在哪里、配置应该修改哪里,并建立后续开发时定位问题的项目结构认知。
学习目标
- 了解 Flutter 项目主要目录和核心文件的作用
- 理解 lib、平台目录与 pubspec.yaml 之间的关系
- 能根据开发任务快速找到需要修改的位置
Flutter 项目的整体结构
Flutter 项目同时包含 Dart 业务代码和多个运行平台的工程文件。日常开发大部分时间集中在 Dart 层,但构建、权限和平台能力接入时需要理解其他目录的职责。
一个典型项目结构如下:
text
my_app/
├── lib/
├── android/
├── ios/
├── web/
├── test/
├── pubspec.yaml
└── README.md使用 lib 编写应用代码
lib 是 Flutter 应用的核心目录,默认入口文件 main.dart 通常位于这里。页面、组件、状态管理、业务逻辑等 Dart 文件都应该放在这个目录中。
例如,一个简单应用的入口:
dart
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return const MaterialApp(
home: Scaffold(
body: Center(child: Text('Hello Flutter')),
),
);
}
}main.dart 负责启动应用,其他页面和组件通常会拆分到不同 Dart 文件中,通过导入组合使用。
理解平台目录和资源配置
Flutter 使用一套 Dart 代码支持多个平台,但每个平台仍需要自己的原生工程。
| 目录 | 作用 |
|---|---|
| android | Android 原生工程、权限和构建配置 |
| ios | iOS 原生工程、签名和系统配置 |
| web | Web 入口和浏览器相关资源 |
| test | 自动化测试代码 |
通常修改界面和业务逻辑时不需要进入这些目录。只有接入原生 SDK、调整权限或修改构建参数时,才需要操作平台目录。
pubspec.yaml 管理项目依赖
pubspec.yaml 是 Flutter 项目的重要配置文件,用于声明应用信息、依赖包、资源文件和环境要求。
例如添加图片资源:
yaml
flutter:
assets:
- assets/images/修改后需要让 Flutter 重新读取配置,确保资源能够被打包进应用。
根据任务定位修改位置
实际开发中可以按问题类型判断入口:
- 修改页面样式:优先查看
lib - 添加第三方库:修改
pubspec.yaml - 配置 Android 权限:查看
android - 配置 iOS 能力:查看
ios - 编写自动化测试:查看
test
理解目录职责后,不需要记住所有文件位置,而是能够根据任务快速缩小修改范围。
按自己的节奏,确认真正理解。