初次接觸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