pubspec.yaml 文件是 Dart 和 Flutter 项目的核心配置文件，用于管理项目的依赖、版本、元数据等。
下面是 pubspec.yaml 文件中常见项的示例和说明：
name: my_private_package
#version: 0.0.1 # 开发一个Dart包或Flutter库，用于其他项目引用，只需要关注版本
version: 1.0.1+10 # 开发一个Flutter应用，并计划将其发布到应用商店，建议使用 1.0.1+10 格式来增加构建号。
description: A new Flutter package for private use.
homepage: https://example.com
#repository: https://github.com/yourusername/my_private_package
#issue_tracker: https://github.com/yourusername/my_private_package/issues
#documentation: https://yourusername.github.io/my_private_package/
environment:
sdk: '>=2.12.0 <3.0.0'
flutter: '>=1.20.0'
dependencies:
flutter:
sdk: flutter
#http 表示项目依赖于 http 包，版本至少为 0.13.3 但低于下一个主版本。
http: ^0.13.3
dev_dependencies:
#flutter_test，这是用于 Flutter 测试的依赖，通常只在开发过程中使用。
flutter_test:
sdk: flutter
flutter:
uses-material-design: true
assets:
- images/a_dot_burr.jpeg
- images/a_dot_ham.jpeg
fonts:
- family: Schyler
fonts:
- asset: fonts/Schyler-Regular.ttf
- asset: fonts/Schyler-Italic.ttf
style: italic1.基本配置
- name: 包的名称，这是你的包在 Dart ecosystem 中的唯一标识符。
- version: 包的版本号，遵循语义化版本规则。
对于 Flutter 应用，通常在发布到应用商店时，会包括构建号（
build number），这有助于追踪和管理不同的构建，尤其是当你需要频繁更新应用且保持相同的版本号时。这种情况下，version: 1.0.1+12是很常见的配置方式。对于开发的 Dart 包或 Flutter 库，通常只需要关注到
MAJOR.MINOR.PATCH，因为包的发布更侧重于 API 的改动和功能更新，而不是构建的具体次数。因此，包通常只配置为version: 1.0.1。在包管理平台（如 pub.dev）上，构建号的概念并不适用，因为每次发布都是围绕功能和修复的变化。 - description: 包的简短描述，帮助用户了解包的用途。
- homepage: 包的主页 URL，通常是项目的仓库或者文档的链接。
- repository: 项目的仓库地址，常用于指定 GitHub/GitLab/Bitbucket 等的直接链接。
- issue_tracker: 问题跟踪系统的链接，通常指向 GitHub Issues 页面。
- documentation: 包的文档页面 URL。
2.环境设置
- environment: 指定包需要的 Dart 和 Flutter SDK 的版本。
- sdk: Dart SDK 的版本范围。
- flutter: Flutter SDK 的版本范围。
(1).查询 Dart SDK 版本
官方：
语言演变：Language evolution | Dart
Dart 官网：Dart programming language | Dart
Dart 的源代码 GitHub：GitHub - dart-lang/sdk: The Dart SDK, including the VM, dart2js, core libraries, and more.
Dart 包管理器的官方网站: The official repository for Dart and Flutter packages.
本地：
要查看你当前安装的 Dart SDK 版本，可以在命令行中运行以下命令：
$ dart --version(2).查询 Flutter SDK 版本
官方：
Flutter 官网： Flutter - Build apps for any screen
Flutter 源码仓库： GitHub - flutter/flutter: Flutter makes it easy and fast to build beautiful apps for mobile and beyond
Flutter 版本：
Releases · flutter/flutter · GitHub
Archive | Flutter
本地：
要查看你当前安装的 Flutter SDK 版本，可以在命令行中运行以下命令：
$ flutter --version或者使用更简洁的信息输出：
$ flutter doctorflutter doctor 命令不仅显示 Flutter SDK 的版本，还会检查你的环境配置是否适合 Flutter 应用开发，包括 Android 和 iOS 的工具链等信息。
3.依赖管理
- dependencies: 包依赖的其他包和版本。
- 可以指定版本号，版本范围，或者使用特定的版本控制系统的链接（如 Git）。
- dev_dependencies: 仅在开发过程中需要的依赖，这些依赖不会在最终的产品中被包含。
- dependency_overrides: 用于临时重写依赖版本，常用于解决依赖冲突。
依赖版本查询：The official repository for Dart and Flutter packages.
(1).精确版本
指定一个包的精确版本号，确保总是使用这个特定的版本。
dependencies:
http: 1.2.1 这种方式告诉 pub 包管理器，你想使用 http 包的 1.2.1 版本，不高于也不低于这个版本。
(2).范围约束
使用版本范围来指定可以接受的最低版本和最高版本。
dependencies:
http: '>=0.12.0 <0.14.0' 这表示 http 包可以是任何 0.12.0 到 0.14.0（不包括 0.14.0）之间的版本。这种方式允许某个范围内的版本更新，有助于获取包的最新修复，同时避免引入重大变更。
(3).Caret 符号 (^)
Caret 约束允许更新到当前主版本号内的最新版本。
dependencies:
http: ^0.13.3这意味着可以使用 0.13.3 及以上版本，但是必须低于 0.14.0。此约束允许非破坏性的更新（通常是小修小改和补丁），这是最常用的版本约束方式，因为它能提供一定级别的灵活性和安全性。
(4).任意版本
如果不指定版本号，或者使用星号 (*)，表示接受任何版本的包。
dependencies:
http: any或者
dependencies:
http: '*'这将匹配任何可用的版本。这种方式在实际开发中并不推荐，因为它可能导致未知的兼容性问题。
(5).Git 依赖
可以直接从 Git 仓库中引入依赖，这在使用尚未发布的包或者需要特定提交的版本时非常有用。
dependencies:
http:
git:
url: https://github.com/flutter/http.git
ref: main 你可以通过 ref 指定分支名、标签或者提交的 SHA。如果省略 ref，默认将使用主分支。
(6).本地路径依赖
如果你正在本地开发一个包，或者需要对某个包进行调试，你可以通过指定路径来依赖本地的包。
dependencies:
local_package:
path: ../path/to/local_package这种方法允许你直接依赖本地文件系统中的包，非常适合本地开发和测试。
4.Flutter 特定配置
- flutter:
- uses-material-design: 如果为
true，则包括 Material Design 相关的资源，例如图标等。 - assets: 列出应包含在应用中的资源文件。
- fonts: 定义应用要使用的字体，包括字体文件和权重。
- uses-material-design: 如果为
在Flutter中，uses-material-design: true 配置项在 pubspec.yaml 文件中的作用是允许项目使用Material Design库中的图标资源。这是因为Material Design图标不是自动包含在Flutter应用中的，而是需要通过此配置项来显式启用。
如果不配置 uses-material-design: true
- Material Design图标：你将无法直接使用Material Design图标。如果你尝试使用
Icons类来引用图标，将会得到一个占位符图标或者没有任何图标显示。 - Material Design组件：你仍然可以使用Material Design的组件，如
Scaffold,AppBar,FlatButton,TextButton等。这些组件不依赖于uses-material-design: true配置项，因为它们是Flutter框架的一部分，而不是资源文件。
这里assets/fonts详细用法可参考另一文：Flutter使用flutter_gen管理资源文件-CSDN博客
