【Flutter 實戰(zhàn)】pubspec.yaml 配置文件詳解

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

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

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

項目中默認配置桶现，去掉注釋部分躲雅，剩下如下：

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

下面我們一個一個的詳細介紹下。

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，那么此屬性將會作為標題顯示钮科，同時其他人引用也需要使用此屬性唤衫。

description

description 屬性是一個可選配置屬性，是對當前項目的介紹绵脯。如果作為插件發(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 進行修改呕缭。

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

path_provider: ^1.6.22

版本的指定有多種形式：

不指定或者 any

path_provider:

path_provider: any

此種格式默認加載 最新的版本恢总，但強烈不推薦使用此方式，因為版本的變化會導(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 相當于'>=1.6.22 <2.0.0'`

path_provider: ^1.6.22

author homepage issue_tracker repository

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

當我們創(chuàng)建一個插件時筐摘，默認配置：

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

author：作者，填寫自己的署名
homepage：主頁咖熟。
issue_tracker：issue圃酵，一般寫當前插件源代碼的Github issue 地址。
repository：一般寫當前插件源代碼的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類中的圖標酷麦。

assets

assets 是對當前資源的配置矿卑，比如圖片、字體等沃饶。

配置本地圖片母廷，使用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

此配置正常情況下不需要修改，當需要添加新平臺適配時馆揉，直接添加：

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特定的配置。更詳細的信息可以轉(zhuǎn)到pubspec的官方文檔查看勤讽。

交流

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