Pub 简介 #

┌─────────────────────────────────────────────────────────────┐
│                           Pub                                │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  包管理      │  │  依赖解析    │  │  版本控制    │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  包发布      │  │  本地缓存    │  │  脚本运行    │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────────────────────────────────────────┘

2011年 ─── Dart 语言发布
    │
    │      Google 发布 Dart 语言
    │      Pub 作为配套工具开始开发
    │
2012年 ─── Pub 首次发布
    │
    │      基本的包管理功能
    │      pub.dartlang.org 上线
    │
2013年 ─── Flutter 项目启动
    │
    │      Pub 成为 Flutter 的包管理器
    │      支持 Flutter 特定依赖
    │
2018年 ─── Dart 2.0 发布
    │
    │      Pub 2.0 重大更新
    │      改进的依赖解析算法
    │
2020年 ─── pub.dev 上线
    │
    │      新的包仓库域名
    │      改进的搜索和评分系统
    │
2021年 ─── Dart 2.14+
    │
    │      dart pub 命令集成到 Dart SDK
    │      更好的工具链整合
    │
至今   ─── 生态系统核心
    │
    │      超过 4 万个包
    │      累计下载超过 100 亿次

# 手动下载和管理库
git clone https://github.com/some/library.git
cp -r library/lib ~/my_project/lib/

# 版本冲突
# 项目A需要 library 1.0
# 项目B需要 library 2.0
# 无法同时管理

# 依赖地狱
# library A 依赖 B、C
# B 依赖 D、E
# 手动管理极其困难

# 一条命令安装依赖
dart pub get

# 自动处理依赖
dart pub add http
# 自动安装 http 及其所有依赖

# 项目级依赖隔离
# 每个项目独立的 pubspec.lock

# 版本管理
dependencies:
  http: ^1.0.0
# 灵活的版本约束

# 无需单独安装
dart --version
# Dart SDK version: 3.2.0

dart pub --version
# Pub 3.2.0

dart pub get          # 获取依赖
dart pub add http     # 添加依赖
dart pub remove http  # 移除依赖
dart pub upgrade      # 升级依赖
dart pub outdated     # 检查过时依赖
dart pub publish      # 发布包

dependencies:
  http: ^1.0.0        # 兼容更新
  path: ">=1.0.0 <2.0.0"  # 范围约束
  crypto: any         # 任意版本（不推荐）

# 内置安全检查
dart pub publish --dry-run

# 依赖验证
dart pub deps

# 安全审计
dart pub outdated

my_package/
├── pubspec.yaml       # 包配置
├── lib/               # 库代码
│   └── my_package.dart
├── bin/               # 可执行文件
│   └── my_package.dart
├── test/              # 测试
├── example/           # 示例
├── web/               # Web 应用
├── tool/              # 工具脚本
└── README.md          # 说明文档

name: my_package
version: 1.0.0
description: 了解 Pub 的历史发展、核心特点、基本概念，以及它在 Dart/Flutter 生态中的重要地位。
homepage: https://example.com

environment:
  sdk: '>=3.0.0 <4.0.0'

dependencies:
  http: ^1.0.0
  path: ^1.8.0

dev_dependencies:
  test: ^1.24.0
  lints: ^2.0.0

packages:
  http:
    dependency: "direct main"
    description:
      name: http
      url: "https://pub.dev"
    version: "1.1.0"
  path:
    dependency: transitive
    description: ...
    version: "1.8.3"

name: my_library
version: 1.0.0

environment:
  sdk: '>=3.0.0 <4.0.0'

my_library/
├── pubspec.yaml
├── lib/
│   ├── my_library.dart
│   └── src/
│       └── implementation.dart
└── README.md

name: my_app
version: 1.0.0
executables:
  my_app: main

environment:
  sdk: '>=3.0.0 <4.0.0'

my_app/
├── pubspec.yaml
├── bin/
│   └── main.dart
└── lib/
    └── my_app.dart

name: my_flutter_package
version: 1.0.0

environment:
  sdk: '>=3.0.0 <4.0.0'
  flutter: '>=3.0.0'

dependencies:
  flutter:
    sdk: flutter

name: my_plugin
version: 1.0.0

environment:
  sdk: '>=3.0.0 <4.0.0'
  flutter: '>=3.0.0'

dependencies:
  flutter:
    sdk: flutter

flutter:
  plugin:
    platforms:
      android:
        package: com.example.my_plugin
        pluginClass: MyPlugin
      ios:
        pluginClass: MyPlugin

# 最简单的 pubspec.yaml
name: my_package
version: 1.0.0

environment:
  sdk: '>=3.0.0 <4.0.0'
# 其他字段有默认值

# 创建项目后立即可以运行
dart create my_project
cd my_project
dart run
# 输出：Hello, world!

# 清理缓存
dart pub cache clean

# 使用依赖覆盖
# pubspec.yaml
dependency_overrides:
  my_package: 2.0.0

# 配置私有仓库
# pubspec.yaml
dependencies:
  my_private_package:
    hosted: https://my-private-repo.com
    version: ^1.0.0