【flutter】yaml插件引入規(guī)則

項目名稱淑际,必填字端

name: new_project

版本號,非必填

若需要將項目托管在pub.dev則該字段必填稚晚。

version: 1.1.0

項目描述做祝,非必填

若需要將項目托管在pub.dev則該字段必填。

description: >-
xxxxx

項目主頁蠕啄,非必填

該項目的介紹主頁场勤,填寫域名

homepage: https://example.com/xxx

開發(fā)文檔位置,非必填

homepage不同介汹,若該項目還包含其他文檔,可以將文檔的地址添加到該節(jié)點下舶沛。如果項目托管在pub.dev嘹承,該節(jié)點顯示項目的API信息。

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

項目的遠(yuǎn)程庫如庭,非必填

若該項目是lib或開源庫叹卷,這個配置文件用于關(guān)聯(lián)庫的來源地址,最好填寫有效的地址坪它,否則會無法關(guān)聯(lián)獲取項目骤竹。

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

問題追蹤頁面,非必填

若該項目是一個開源且隨時更新的項目往毡,可以通過填寫該屬性蒙揣,標(biāo)明該項目的問題追蹤文檔站點,如果使用pub.dev來進(jìn)行項目托管开瞭,則pub.dev將嘗試通過該字段顯示該項目的問題跟蹤鏈接懒震。若該項目托管在github,則可以將該字段填寫為github的issues

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

項目的第三方插件依賴嗤详,在這個標(biāo)簽中列出了該項目正常工作所需的每一個軟件包與版本个扰。以下通過實例詳解該標(biāo)簽的詳情

dependencies:

實例1 直接寫明約束版本,若該插件是發(fā)布在https://pub.dev/ 之上葱色,IDE會直接在項目目錄下執(zhí)行flutter packages get來下載其插件的最新版本

xxx:

實例2 該插件是在實例1的基礎(chǔ)上進(jìn)行延伸递宅,其中^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 若該插件是發(fā)布在git上,可以用以下方式來進(jìn)行插件獲取土榴,默認(rèn)獲取master下代碼

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

實例6 基于實例5诀姚,其中ref標(biāo)明獲取的分支信息

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

區(qū)別于dependencies標(biāo)簽抄邀,dependencies是生產(chǎn)環(huán)境依賴庫版本耘眨,dev_dependencies是開發(fā)環(huán)境依賴庫版本,該環(huán)境僅在開發(fā)調(diào)試時使用境肾。標(biāo)簽規(guī)則同dependencies剔难。

dev_dependencies:
xxx: ^1.4.0

重寫依賴包,會強(qiáng)制下載對應(yīng)依賴包奥喻,并可以對該依賴包進(jìn)行重寫偶宫。

dependency_overrides:
xxx: ^1.4.0

Dart2開始需要添加該標(biāo)簽,聲明該項目是基于dart的SDK哪個版本進(jìn)行編譯环鲤,隨著dart平臺的發(fā)展纯趋,可能在某個版本后不再向下兼容,所以這個標(biāo)簽約束了使用dart的版本

例冷离,以下約束說明此項目僅適用于2.0到3.0的dart2 SDK編譯结闸。

environment:
sdk: '>=2.0.0 <3.0.0'

可以將Dart2的可執(zhí)行腳本引入到flutter之中,作為插件使用酒朵,但前提是這些腳本均可以在命令行正常調(diào)用桦锄。

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

指定生成發(fā)布包的位置

非必填

若不填寫,則默認(rèn)使用pub.dev站點進(jìn)行發(fā)布蔫耽,但若希望阻止發(fā)布结耀,則需要聲明為none留夜。

同時此設(shè)置可以將flutter項目發(fā)布到自定義的服務(wù)器之中。

publish_to: none

項目中配置聲明方式

用于在項目中添加資源图甜、設(shè)置字體碍粥、配置插件參數(shù)等。

flutter:
  # 實例1 添加資源
  assets:
      - images/park.jpg
  #設(shè)置字體黑毅,樣式嚼摩,可以通過聲明family來設(shè)置字體分組
  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 定義數(shù)組

server:
    - aaaaaa
    - bbbbbb
    - dddddd
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市矿瘦,隨后出現(xiàn)的幾起案子枕面,更是在濱河造成了極大的恐慌,老刑警劉巖缚去,帶你破解...
    沈念sama閱讀 206,214評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件潮秘,死亡現(xiàn)場離奇詭異,居然都是意外死亡易结,警方通過查閱死者的電腦和手機(jī)枕荞,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,307評論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來搞动,“玉大人躏精,你說我怎么就攤上這事○兄祝” “怎么了矗烛?”我有些...
    開封第一講書人閱讀 152,543評論 0 341
  • 文/不壞的土叔 我叫張陵,是天一觀的道長狮惜。 經(jīng)常有香客問我高诺,道長碌识,這世上最難降的妖魔是什么碾篡? 我笑而不...
    開封第一講書人閱讀 55,221評論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮筏餐,結(jié)果婚禮上开泽,老公的妹妹穿的比我還像新娘。我一直安慰自己魁瞪,他們只是感情好穆律,可當(dāng)我...
    茶點故事閱讀 64,224評論 5 371
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著导俘,像睡著了一般峦耘。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上旅薄,一...
    開封第一講書人閱讀 49,007評論 1 284
  • 那天辅髓,我揣著相機(jī)與錄音,去河邊找鬼。 笑死洛口,一個胖子當(dāng)著我的面吹牛矫付,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播第焰,決...
    沈念sama閱讀 38,313評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼买优,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了挺举?” 一聲冷哼從身側(cè)響起杀赢,我...
    開封第一講書人閱讀 36,956評論 0 259
  • 序言:老撾萬榮一對情侶失蹤蕾久,失蹤者是張志新(化名)和其女友劉穎身冬,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蘸泻,經(jīng)...
    沈念sama閱讀 43,441評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡瞻佛,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,925評論 2 323
  • 正文 我和宋清朗相戀三年脱篙,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片伤柄。...
    茶點故事閱讀 38,018評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡绊困,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出适刀,到底是詐尸還是另有隱情秤朗,我是刑警寧澤,帶...
    沈念sama閱讀 33,685評論 4 322
  • 正文 年R本政府宣布笔喉,位于F島的核電站取视,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏常挚。R本人自食惡果不足惜作谭,卻給世界環(huán)境...
    茶點故事閱讀 39,234評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望奄毡。 院中可真熱鬧折欠,春花似錦、人聲如沸吼过。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,240評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽盗忱。三九已至酱床,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間趟佃,已是汗流浹背扇谣。 一陣腳步聲響...
    開封第一講書人閱讀 31,464評論 1 261
  • 我被黑心中介騙來泰國打工慷垮, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人揍堕。 一個月前我還...
    沈念sama閱讀 45,467評論 2 352
  • 正文 我出身青樓料身,卻偏偏與公主長得像,于是被迫代替她去往敵國和親衩茸。 傳聞我的和親對象是個殘疾皇子芹血,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,762評論 2 345

推薦閱讀更多精彩內(nèi)容