大佬教程收集整理的这篇文章主要介绍了【Flutter 实战】pubspec.yaml 配置文件详解,大佬教程大佬觉得挺不错的,现在分享给大家,也给大家做个参考。
pubspec.yaml 是 Flutter 项目的配置文件,类似于 Android 中的 Gradle 配置文件,下面我们就看看 pubspec.yaml 中各个属性的配置。
创建一个新的项目(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
此属性表示包名(package name),此属性是非常重要的,引入其他文件时需要使用此包名:
import 'package:Flutter_app/home_page.dart';
import 'package:Flutter_app_demo/home_page.dart';
如果你创建了一个 Flutter 插件并发布到 pub.dev,那么此属性将会作为标题显示,同时其他人引用也需要使用此属性。
description 属性是一个可选配置属性,是对当前项目的介绍。如果作为插件发布到 pub.dev 上,此值显示在如下位置:
此属性应用程序的版本和内部版本号,格式为 x.x.x+x,例如:1.0.0+1,这个版本号称为 语义版本号(semantic versioning ),semantic versioning 相关知识请参考此处。
版本号 + 前面到部分,叫做 version number,由 2 个小点隔开,后面的部分叫做 build number。
在 Android 中 version number 对应 versionName,build number 对应 versionCode,在 android/build.gradle 下有相关配置,
早期的版本 build.gradle 中 versionName 和 versionCode 是直接写死的数字,如下:
此时修改版本号只能通过修改 build.gradle 。而现在可以直接通过 pubspec.yaml 进行修改。
path_provider: ^1.6.22
版本的指定有多种形式:
path_provider:
path_provider: any
此种格式默认加载 最新的版本,但强烈不推荐使用此方式,因为版本的变化会导致接口发生变化,项目出现编译异常。
明确指定版本
path_provider: 1.6.22
指定依赖的版本。
小于或者小于等于此版本的包
path_provider: <=1.6.22
path_provider: <1.6.22
指定版本的区间
path_provider: '>=1.0.0 <1.6.22'
此方式为最常见的方式,也是推荐的方式。
此方式表示大版本不变,小版本使用最新的版本,例如^1.6.22 相当于
'>=1.6.22 <2.0.0'`
path_provider: ^1.6.22
这四种属性在 Flutter Application 项目中默认是没有的,正常项目中也无需这几个属性,当我们开发插件并发布到 pub 时需要这几个属性。
issue_tracker 和 repository 我们可以手动创建。这四个属性说明:
Environment 属性下添加 Flutter 和 Dart 版本控制。
environment:
sdk: ">=2.7.0 <3.0.0"
上面的版本规定此应用或库只能在高于或等于2.7.0,低于3.0.0的Dart SDK版本上运行。
environment:
sdk: ">=2.7.0 <3.0.0"
Flutter: "1.22.0"
也可以通过此属性使用实验性质的版本:
environment:
sdk: ">=2.11.0-213.0.dev <2.12.0"
dependencies 和 dev_dependencies 下包含应用程序所依赖的包,dependencies 和 dev_dependencies 就像其名字一样,dependencies 下的所有依赖会编译到项目中,而 dev_dependencies 仅仅是运行期间的包,比如自动生成代码的库。
我们可以通过四种方式依赖其包:
依赖 pub.dev 上的第三方库是最常用的一种方式
dependencies:
path_provider: ^1.6.22
dependencies:
Flutter_package:
path: ../Flutter_package
@H_197_260@依赖 git repository
dependencies:
bloc:
git:
url: https://github.com/felangel/bloc.git
ref: bloc_fixes_issue_110
path: packages/bloc
一般大公司都会搭建自己的 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,那么我最终到底依赖哪个版本,此时执行 Flutter pub get 则会出现如下错误:
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,version solving Failed.)
Process finished with exit code 1
此时要解决这个冲突,可以添加 dependency_overrides:
dependency_overrides:
path_provider: ^1.6.22
添加此属性后,所有 path_provider 插件都会使用同一个最新版本,使用此字段执行 Flutter pub get 则会出现如下警告:
/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 @R_507_6756@
Flutter 下面的配置都是 Flutter 的相关配置。
Flutter:
uses-material-design: true
确保您的应用程序中包含Material Icons字体,以便您可以使用material Icons类中的图标。
assets 是对当前资源的配置,比如 @L_673_108@、字体等。
配置本地@L_673_108@,使用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 配置只存在与插件项目中,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 包含应用程序和依赖的软件包,规定Dart和Flutter SDK的版本约束,管理依赖关系并设置Flutter特定的配置。更详细的信息可以转到pubspec的官方文档查看。
老孟Flutter博客(330个控件用法+实战入门系列文章):http://laomengit.com
欢迎加入Flutter交流群(微信:laomENGIt)、关注公众号【老孟Flutter】:
以上是大佬教程为你收集整理的【Flutter 实战】pubspec.yaml 配置文件详解全部内容,希望文章能够帮你解决【Flutter 实战】pubspec.yaml 配置文件详解所遇到的程序开发问题。
如果觉得大佬教程网站内容还不错,欢迎将大佬教程推荐给程序员好友。
本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。