Flutter pubspec.yaml 使用方式
pubspec.yaml 是 Flutter 项目中最重要的配置文件之一，用于管理应用的基本信息、依赖项、资源以及构建配置等内容。
1. 基本结构和字段
基本信息
name: my_flutter_app # 应用的名称
description: A new Flutter project # 项目的描述
version: 1.0.0+1 # 应用的版本号和内部版本号
homepage: https://example.com # 项目的主页 (可选)
repository: https://github.com/my_flutter_app # 用于提供项目的源代码仓库地址 (可选)
publish_to: "none" # 是否发布到 Pub (用于私有项目)
环境要求
environment:sdk: ">=2.19.0 <3.0.0" # Dart SDK 的版本范围flutter: ">=3.7.0" # Flutter SDK 的版本范围 (可选)
2. 添加依赖项
普通依赖
用于添加 Dart 和 Flutter 包依赖：
dependencies:flutter:sdk: flutter # Flutter SDK 必须的核心包http: ^0.15.0 # 添加第三方依赖包及其版本provider: ^6.0.0 # 依赖其他库 (Pub.dev 上的库)
开发依赖
仅在开发环境中使用的依赖：
dev_dependencies:flutter_test:sdk: flutter # 测试框架lint: ^2.0.0 # 代码分析工具
依赖本地包
引用本地的 Dart 包：
dependencies:my_local_package:path: ../my_local_package
依赖 Git 仓库
引用托管在 Git 仓库中的包：
dependencies:my_git_package:git:url: https://github.com/username/repository.gitref: main # 指定分支path: packages/package_name # 指定子目录 (可选)
依赖特定的 SDK
引用基于 Dart 或 Flutter SDK 的包：
dependencies:flutter:sdk: flutter
3. 配置资源
静态资源
添加应用使用的图像、字体等资源：
flutter:assets:- assets/images/logo.png # 单个资源文件- assets/images/ # 整个文件夹
自定义字体
为项目添加自定义字体：
flutter:fonts:- family: Robotofonts:- asset: assets/fonts/Roboto-Regular.ttf- asset: assets/fonts/Roboto-Bold.ttfweight: 700
4. 配置插件
添加平台特定的依赖（iOS、Android 等）：
flutter:plugin:platforms:android:package: com.example.mypluginpluginClass: MyPluginios:pluginClass: MyPlugin
5. 设置执行脚本（Flutter 3.7+ 支持）
支持 scripts 字段定义自定义脚本：
scripts:build_runner: flutter packages pub run build_runner build
运行命令：
flutter pub run scripts build_runner
6. 配置平台支持
启用或禁用某些平台支持：
flutter:module:androidPackage: com.example.my_flutter_appiosBundleIdentifier: com.example.myFlutterAppgenerate:platforms:- android- ios- web
7. 配置最低 SDK 要求
environment:flutter: ">=3.3.0"
8. 提升构建效率：缓存与可选字段
启用 Dart 分析器规则
analyzer:exclude:- test/mock_data.dart # 排除文件
配置缓存依赖
避免重新下载 Pub 包，覆盖项目中某个依赖的版本。当某些包依赖的库版本冲突时，可以通过 dependency_overrides 来强制使用指定版本。
dependency_overrides:http: ^0.15.0
9. 自定义构建版本号
版本号格式为 x.y.z+build_number，例如：
version: 1.2.3+10
- x.y.z：语义化版本号（主版本号、次版本号和补丁版本号）。
- build_number：内部构建版本号。
10. 自动生成的注释区域
Flutter 自动生成一些注释内容，建议保留以便参考。例如：
# To add assets to your application, add an assets section, like this:
# assets:
# - assets/images/a_dot_burr.jpeg
# - assets/images/a_dot_ham.jpeg
11. 插件（国际化）
在某些项目中，flutter_intl 插件用于国际化配置：
flutter_intl:enabled: trueuse_recommended_settings: true