老孟導(dǎo)讀：pubspec.yaml 文件是 Flutter 中非常重要的配置文件，下面就讓我們看看里面各個配置的含義。

pubspec.yaml 是 Flutter 項目的配置文件，類似于 Android 中的 Gradle 配置文件，下面我們就看看 pubspec.yaml 中各個屬性的配置。

創(chuàng)建一個新的項目（Flutter Application），pubspec.yaml 位于根目錄，如圖：

項目中默認(rèn)配置，去掉注釋部分，剩下如下：

name: flutter_app
description: A new Flutter application.

publish_to: 'none' 

version: 1.0.0+1

environment:
  sdk: ">=2.7.0 <3.0.0"

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.0

dev_dependencies:
  flutter_test:
    sdk: flutter

flutter:
  uses-material-design: true

下面我們一個一個的詳細(xì)介紹下。

name

此屬性表示包名（package name），此屬性是非常重要的，引入其他文件時需要使用此包名：

import 'package:flutter_app/home_page.dart';

如果你修改包名為 ，那么相應(yīng)的引入也需要修改:

import 'package:flutter_app_demo/home_page.dart';

如果你創(chuàng)建了一個 Flutter 插件并發(fā)布到 pub.dev，那么此屬性將會作為標(biāo)題顯示，同時其他人引用也需要使用此屬性。

description

description 屬性是一個可選配置屬性，是對當(dāng)前項目的介紹。如果作為插件發(fā)布到 pub.dev 上，此值顯示在如下位置：

version

此屬性應(yīng)用程序的版本和內(nèi)部版本號，格式為 x.x.x+x，例如：1.0.0+1，這個版本號稱為 語義版本號（semantic versioning ），semantic versioning 相關(guān)知識請參考此處。

版本號 + 前面到部分，叫做 version number，由 2 個小點隔開，后面的部分叫做 build number。

在 Android 中 version number 對應(yīng) versionName，build number 對應(yīng) versionCode，在 android/build.gradle 下有相關(guān)配置，

早期的版本 build.gradle 中 versionName 和 versionCode 是直接寫死的數(shù)字，如下：

此時修改版本號只能通過修改 build.gradle 。而現(xiàn)在可以直接通過 pubspec.yaml 進(jìn)行修改。

如果是插件，那么用戶可以通過此版本號指定使用哪個版本，

path_provider: ^1.6.22

版本的指定有多種形式：

不指定或者 any

path_provider:

path_provider: any

此種格式默認(rèn)加載 最新的版本，但強烈不推薦使用此方式，因為版本的變化會導(dǎo)致接口發(fā)生變化，項目出現(xiàn)編譯異常。

x.y.z

明確指定版本

path_provider: 1.6.22

指定依賴的版本。

<=x.y.z 或者<x.y.z

小于或者小于等于此版本的包

path_provider: <=1.6.22

path_provider: <1.6.22

>=a.b.c <x.y.z

指定版本的區(qū)間

path_provider: '>=1.0.0 <1.6.22'

^x.y.z

此方式為最常見的方式，也是推薦的方式。

此方式表示大版本不變，小版本使用最新的版本，例如^1.6.22 相當(dāng)于'>=1.6.22 <2.0.0'`

path_provider: ^1.6.22

author homepage issue_tracker repository

這四種屬性在 Flutter Application 項目中默認(rèn)是沒有的，正常項目中也無需這幾個屬性，當(dāng)我們開發(fā)插件并發(fā)布到 pub 時需要這幾個屬性。

當(dāng)我們創(chuàng)建一個插件時，默認(rèn)配置：

issue_tracker 和 repository 我們可以手動創(chuàng)建。這四個屬性說明：

• author：作者，填寫自己的署名
• homepage：主頁。
• issue_tracker：issue，一般寫當(dāng)前插件源代碼的Github issue 地址。
• repository：一般寫當(dāng)前插件源代碼的Github地址。

這些屬性會顯示在 pub.dev 主頁上：

Environment

Environment 屬性下添加 Flutter 和 Dart 版本控制。

environment:
  sdk: ">=2.7.0 <3.0.0"

上面的版本規(guī)定此應(yīng)用或庫只能在高于或等于2.7.0，低于3.0.0的Dart SDK版本上運行。

我們也可以手動添加 Flutter 版本：

environment:
  sdk: ">=2.7.0 <3.0.0"
  flutter: "1.22.0"

也可以通過此屬性使用實驗性質(zhì)的版本：

environment:
  sdk: ">=2.11.0-213.0.dev <2.12.0"

dependencies 和 dev_dependencies

dependencies 和 dev_dependencies 下包含應(yīng)用程序所依賴的包，dependencies 和 dev_dependencies 就像其名字一樣，dependencies 下的所有依賴會編譯到項目中，而 dev_dependencies 僅僅是運行期間的包，比如自動生成代碼的庫。

我們可以通過四種方式依賴其包：

• 依賴 pub.dev 上的第三方庫
• 依賴本地庫
• 依賴 git repository
• 依賴我們自己的 pub倉庫

依賴 pub.dev 上的第三方庫

依賴 pub.dev 上的第三方庫是最常用的一種方式

dependencies:
  path_provider: ^1.6.22

依賴本地庫

如果你在本地創(chuàng)建了一個模塊，依賴本地的庫：

dependencies:
  flutter_package:
    path: ../flutter_package

依賴 git repository

依賴 Github 上的一個插件：

dependencies:
  bloc:
    git:
      url: https://github.com/felangel/bloc.git
      ref: bloc_fixes_issue_110
      path: packages/bloc

• url：github 地址
• ref：表示git引用，可以是 commit hash, tag 或者 branch
• path：如果 git 倉庫中有多個軟件包，則可以使用此屬性指定軟件包

依賴我們自己的 pub 倉庫。

一般大公司都會搭建自己的 pub 倉庫，引用自己倉庫的方式：

dependencies:
  bloc: 
    hosted:
      name: bloc
      url: http://your-package-server.com
    version: ^6.0.0

依賴覆蓋

想象如下場景：項目依賴一個庫（比如 path_provider）的版本為 1.6.22，而另一個依賴庫也依賴這個 path_provider， 但版本為 0.5.0，那么我最終到底依賴哪個版本，此時執(zhí)行 flutter pub get 則會出現(xiàn)如下錯誤：

Running "flutter pub get" in flutter_app...                     

Because every version of flutter_plugin from path depends on path_provider ^0.5.0 and flutter_app depends on path_provider ^1.6.22, flutter_plugin from path is forbidden.
So, because flutter_app depends on flutter_plugin from path, version solving failed.
pub get failed (1; So, because flutter_app depends on flutter_plugin from path, version solving failed.)
Process finished with exit code 1

此時要解決這個沖突，可以添加 dependency_overrides：

dependency_overrides:
  path_provider: ^1.6.22

添加此屬性后，所有 path_provider 插件都會使用同一個最新版本，使用此字段執(zhí)行 flutter pub get 則會出現(xiàn)如下警告：

/Users/mengqingdong/project/flutter/bin/flutter --no-color pub get
Running "flutter pub get" in flutter_app...                     

Warning: You are using these overridden dependencies:
! path_provider 1.6.22
Running "flutter pub get" in flutter_app...                         0.5s
Process finished with exit code 0

Flutter

Flutter 下面的配置都是 Flutter 的相關(guān)配置。

uses-material-design

flutter:
  uses-material-design: true

確保您的應(yīng)用程序中包含Material Icons字體，以便您可以使用material Icons類中的圖標(biāo)。

assets

assets 是對當(dāng)前資源的配置，比如 圖片、字體等。

配置本地圖片，使用Image.asset() 加載。

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: italic
  - family: Trajan Pro
    fonts:
      - asset: fonts/TrajanPro.ttf
      - asset: fonts/TrajanPro_Bold.ttf
        weight: 700

plugin

plugin 配置只存在與插件項目中，package 和 pluginClass 一般是不需要修改的，

flutter:
  plugin:
    platforms:
      android:
        package: com.flutter.app_market
        pluginClass: AppMarketPlugin
      ios:
        pluginClass: AppMarketPlugin

此配置正常情況下不需要修改，當(dāng)需要添加新平臺適配時，直接添加：

flutter:
  plugin:
    platforms:
      android:
        package: com.flutter.app_market
        pluginClass: AppMarketPlugin
      ios:
        pluginClass: AppMarketPlugin
      macos:
        default_package: app_market_macos
      web:
        default_package: app_market_web
        

pubspec.yaml 包含應(yīng)用程序和依賴的軟件包，規(guī)定Dart和Flutter SDK的版本約束，管理依賴關(guān)系并設(shè)置Flutter特定的配置。更詳細(xì)的信息可以轉(zhuǎn)到pubspec的官方文檔查看。

交流

老孟Flutter博客（330個控件用法+實戰(zhàn)入門系列文章）：http://laomengit.com