開發Flutter不可不知的yaml文件

初次接觸Flutter時,需要在pubspec.yaml文件中配置引用庫的依賴關係。剛開始很容易出錯,當你看完這篇文章基本上你會熟練的靈活的配置這個文件。

yaml是什麼?

YAML的英文縮寫是“Yet Another Markup Language”,翻譯過來是(仍是一種標記語言)。
讀音(/ˈjæməl/,尾音類似camel駱駝)是一個可讀性高,用來表達數據序列化的格式。
YAML參考了其他多種語言,包括:XML、C語言、Python、Perl以及電子郵件格式RFC2822。Clark Evans在2001年首次發表了這種語言,另外Ingy döt Net與Oren Ben-Kiki也是這語言的共同設計者。
最讓人上手的是巧妙避開各種封閉符號:如引號、各種括號等,這些符號在嵌套結構時會變得複雜而難以辨別。
跟json類似,但比json格式方便。

參考鏈接:
js-yaml
在線demo
在線pdf格式的說明(英文)
百度百科詳細說明
YAML 語言教程

主要作用

  • 用於清單,散列表,標量等數據形態,特別適合用來表達或編輯數據結構、各種配置文件、調試內容、文件大綱。
  • 比較適合做序列化,因爲他是宿主語言數據類型直轉的。
  • 腳本語言:由於實現簡單,解析成本很低。

基本語法

  • 大小寫敏感
  • 使用縮進表示層級關係
  • 縮進不允許使用tab,只允許空格
  • 縮進的空格數不重要,只要相同層級的元素左對齊即可
  • '#'表示註釋,只能單行註釋
  • 重複的內容可使從參考標記星號(*)複製到錨點標記(&)
  • 指定格式可以使用兩個驚歎號!!,後面接上名稱
  • 字符串不一定要使用雙引號標識
  • 允許在文件中加入選擇性的空行,以增加可讀性;

數據類型

YAML 支持以下幾種數據類型:

  • 對象:鍵值對的集合,又稱爲映射(mapping)/ 哈希(hashes) / 字典(dictionary)
  • 數組:一組按次序排列的值,又稱爲序列(sequence) / 列表(list)
  • 純量(scalars):單個的、不可再分的值,就是常用的字符串,布爾型,數字型等

對象

對象鍵值對使用冒號結構表示 key: value,冒號後面要加一個空格。
也可以使用 key:{key1: value1, key2: value2, …}。
還可以使用縮進表示層級關係;

key: 
    child-key: value
    child-key2: value2

數組

以 - 開頭的行表示構成一個數組:

- A
- B
- C

數據結構的子成員是一個數組,則可以在該項下面縮進一個空格。

 - A
 - AA
 - AB
 - AC
 - B
 - BA
 - BB 

純量

純量是最基本的,不可再分的值,包括:

  • 字符串
  • 布爾值
  • 整數
  • 浮點數
  • Null
  • 時間
  • 日期
boolean: 
    - TRUE  #true,True都可以
    - FALSE  #false,False都可以
float:
    - 3.14
    - 6.8523015e+5  #可以使用科學計數法
int:
    - 123
    - 0b1010_0111_0100_1010_1110    #二進制表示
null:
    nodeName: 'node'
    parent: ~  #使用~表示null
string:
    - 哈哈
    - 'Hello world'  #可以使用雙引號或者單引號包裹特殊字符
    - newline
      newline2    #字符串可以拆成多行,每一行會被轉化成一個空格
date:
    - 2018-02-17    #日期必須使用ISO 8601格式,即yyyy-MM-dd
datetime: 
    -  2018-02-17T15:02:31+08:00    #時間使用ISO 8601格式,時間和日期之間使用T連接,最後使用+代表時區

引用,避免重複

& 用來建立錨點(defaults),<< 表示合併到當前數據,* 用來引用錨點。

defaults: &defaults
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  <<: *defaults

test:
  database: myapp_test
  <<: *defaults

相當於

defaults:
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  adapter:  postgres
  host:     localhost

test:
  database: myapp_test
  adapter:  postgres
  host:     localhost

在Flutter中的實現

name: flutter_app
description: 這是一個描述
# 版本號
version: 1.0.0+1
# dart環境
environment:
  sdk: ">=2.1.0 <3.0.0"
# 依賴關係,下面是對象
dependencies:
  flutter:
    sdk: flutter

  flutter_localizations:
    sdk: flutter

  package_info: ^0.4.0+3
  
flutter:

  uses-material-design: true
  assets:
  # 數組
    - assets/library_img/
    - assets/app_img/
  fonts:
  # 數組中有對象,對象中有數組
    - family: MyIcons
      fonts:
        - asset: assets/fonts/iconfont.ttf

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章