【flutter】yaml插件引入规则

项目名称,必填字端

name: new_project

版本号,非必填

若需要将项目托管在pub.dev则该字段必填。

version: 1.1.0

项目描述,非必填

若需要将项目托管在pub.dev则该字段必填。

description: >-
xxxxx

项目主页,非必填

该项目的介绍主页,填写域名

homepage: https://example.com/xxx

开发文档位置,非必填

homepage不同,若该项目还包含其他文档,可以将文档的地址添加到该节点下。如果项目托管在pub.dev,该节点显示项目的API信息。

documentation: https://example.com/xxx/docs

项目的远程库,非必填

若该项目是lib或开源库,这个配置文件用于关联库的来源地址,最好填写有效的地址,否则会无法关联获取项目。

repository: https://github.com/<user>/<repository>

问题追踪页面,非必填

若该项目是一个开源且随时更新的项目,可以通过填写该属性,标明该项目的问题追踪文档站点,如果使用pub.dev来进行项目托管,则pub.dev将尝试通过该字段显示该项目的问题跟踪链接。若该项目托管在github,则可以将该字段填写为github的issues

issue_tracker: https://github.com/<user>/<repository>/issues

项目的第三方插件依赖,在这个标签中列出了该项目正常工作所需的每一个软件包与版本。以下通过实例详解该标签的详情

dependencies:

实例1 直接写明约束版本,若该插件是发布在https://pub.dev/ 之上,IDE会直接在项目目录下执行flutter packages get来下载其插件的最新版本

xxx:

实例2 该插件是在实例1的基础上进行延伸,其中^1.4.0的含义是约束了版本号,也就是在该项目中,需要使用1.4.0版本

xxx: ^1.4.0

实例3 若该插件未部署在pub.dev之上,则可以通过URL来指定出插件下载的源

xxx:
hosted:
name: xxx
url: http://some-package-server.com

实例4 基于实例3,其中version表明了使用该插件的版本信息

xxx:
hosted:
name: xxx
url: http://some-package-server.com
version: ^1.4.0

实例5 若该插件是发布在git上,可以用以下方式来进行插件获取,默认获取master下代码

xxx:
git:
url: git://github.com/kean_qi/xxx.git

实例6 基于实例5,其中ref标明获取的分支信息

xxx:
git:
url: git://github.com/kean_qi/xxx.git
ref: some-branch

实例7 基于实例5,若插件只是在项目中的某一个目录中,可以通过path来指定插件位置

xxx:
git:
url: git://github.com/kean_qi/xxx.git
path: path/to/kittens

实例8 若插件在本地某一目录,可以通过指定path来找到该插件

xxx:
path: /Users/username/xxx

指定版本,若该项目使用的插件需要约束版本,则方法如下

实例1 在该项目中,此插件指定版本为1.4.0

xxx: ^1.4.0

实例2 在该项目中,此插件最低版本为1.2.3

xxx: ">=1.2.3"

实例3 在该项目中,此插件最低支持2.0.0版本,但不支持3.0.0以上版本

xxx: ">=2.0.0 <3.0.0"

实例4 在该项目中,此插件最高支持到1.2.3以下版本

xxx: "<1.2.3"

指定Flutter SDK

实例1 项目必填项,指定SDK,并获取SDK最新版

flutter:
sdk: flutter

实例2 基于实例1,指定SDK版本号

flutter:
sdk: flutter
version: ">=2.0.0-dev.68.0 <3.0.0"

实例3 另外一种写法

flutter_driver:
sdk: flutter
version: ^0.0.1

区别于dependencies标签,dependencies是生产环境依赖库版本,dev_dependencies是开发环境依赖库版本,该环境仅在开发调试时使用。标签规则同dependencies。

dev_dependencies:
xxx: ^1.4.0

重写依赖包,会强制下载对应依赖包,并可以对该依赖包进行重写。

dependency_overrides:
xxx: ^1.4.0

Dart2开始需要添加该标签,声明该项目是基于dart的SDK哪个版本进行编译,随着dart平台的发展,可能在某个版本后不再向下兼容,所以这个标签约束了使用dart的版本

例,以下约束说明此项目仅适用于2.0到3.0的dart2 SDK编译。

environment:
sdk: '>=2.0.0 <3.0.0'

可以将Dart2的可执行脚本引入到flutter之中,作为插件使用,但前提是这些脚本均可以在命令行正常调用。

executables:
<name-of-executable>: <Dart-script-from-bin>

指定生成发布包的位置

非必填

若不填写,则默认使用pub.dev站点进行发布,但若希望阻止发布,则需要声明为none。

同时此设置可以将flutter项目发布到自定义的服务器之中。

publish_to: none

项目中配置声明方式

用于在项目中添加资源、设置字体、配置插件参数等。

flutter:
  # 实例1 添加资源
  assets:
      - images/park.jpg
  #设置字体,样式,可以通过声明family来设置字体分组
  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

其他声明方式

实例1 定义常量

age: 22
boolitem: true
name: 'hello'

实例2 定义数组

server:
    - aaaaaa
    - bbbbbb
    - dddddd
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,884评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,347评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,435评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,509评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,611评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,837评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,987评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,730评论 0 267
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,194评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,525评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,664评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,334评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,944评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,764评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,997评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,389评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,554评论 2 349

推荐阅读更多精彩内容