Angular從創(chuàng)建庫到引用庫

前序:

你可以創(chuàng)建和發(fā)布新庫來擴展 Angular 的功能。如果你發(fā)現(xiàn)需要在多個應用中解決同樣的問題(或者想與其他開發(fā)者共享你的解決方案)撤嫩,你就有了一個潛在的庫偎捎。

創(chuàng)建庫

  1. 使用 Angular CLI,用以下命令生成一個新庫的骨架
   ng generate library my-lib

2.此時在你的工作區(qū)中創(chuàng)建 projects/my-lib 文件夾序攘,里面包含 NgModule 中的一個組件和一個服務茴她。該工作區(qū)的配置文件 angular.json 中也添加了一個 'library' 類型的項目。

"projects": {
  ...
  "my-lib": {
    "root": "projects/my-lib",
    "sourceRoot": "projects/my-lib/src",
    "projectType": "library",
    "prefix": "lib",
    "architect": {
      "build": {
        "builder": "@angular-devkit/build-ng-packagr:build",
        ...

3.使用 CLI 命令來構建程奠、測試和 lint 這個項目

   ng build my-lib
   ng test my-lib
   ng lint my-lib

注意:

該項目配置的構建器與應用類項目的默認構建器不同丈牢。此構建器可以確保庫永遠使用 AoT 編譯器構建,而不必再指定--prod標志瞄沙。
要讓庫代碼可以復用己沛,你必須為它定義一個公共的 API慌核。這個“用戶層”定義了庫中消費者的可用內容。該庫的用戶應該可以通過單個的導入路徑來訪問公共功能(如NgModules申尼、服務提供商和工具函數(shù))遂铡。

庫的公共 API 是在庫文件夾下的 public-api.ts 文件中維護的。當你的庫被導入應用時晶姊,從該文件導出的所有內容都會公開扒接。請使用 NgModule 來暴露這些服務和組件。

你的庫里應該提供一些文檔(通常是 README 文件)來指導別人安裝和維護们衙。

與 CLI 集成

庫中可以包含那些能與 Angular CLI 集成的 schematics 钾怔。

  • 包含一個安裝型 schematic,以便 ng add 可以把你的庫添加到項目中蒙挑。
  • 包含一些生成型 schematic 宗侦,以便 ng generate 可以為項目中的已定義工件(組件,服務忆蚀,測試等)生成腳手架矾利。
  • 包含一個更新(update)原理圖 ,以便 ng [update](https://www.angular.cn/api/forms/NgModel#update) 可以更新此庫的依賴馋袜,并針對新版本中的破壞性變更提供輔助遷移男旗。

要了解更多信息,參見 原理圖概覽供庫使用的原理圖欣鳖。

發(fā)布你的庫

使用 Angular CLI 和 npm 包管理器來把你的庫構建并發(fā)布成 npm 包察皇。默認情況下,庫是在 AoT模式 下構建的泽台,因此在構建發(fā)布時你不需要指定-prod標志什荣。

   ng build my-lib
   cd dist/my-lib
   npm publish

如果你之前從未在 npm 中發(fā)布過包,就必須創(chuàng)建一個用戶帳號怀酷。點此閱讀發(fā)布 npm 包的更多信息稻爬。

在應用中使用自己的庫

你不必把庫發(fā)布到 npm 包管理器上就可以在自己的應用中使用它,但必須先構建它蜕依。
要想在應用中使用你自己的庫:

  • 構建該庫桅锄。在構建之前,無法使用庫笔横。
   content_copy
   ng build my-lib
  • 在你的應用中竞滓,按名字從庫中導入:
   content_copy
   import { myExport } from 'my-lib';
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市吹缔,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌锯茄,老刑警劉巖厢塘,帶你破解...
    沈念sama閱讀 217,826評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件茶没,死亡現(xiàn)場離奇詭異,居然都是意外死亡晚碾,警方通過查閱死者的電腦和手機抓半,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,968評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來格嘁,“玉大人笛求,你說我怎么就攤上這事「獠荆” “怎么了探入?”我有些...
    開封第一講書人閱讀 164,234評論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長懂诗。 經常有香客問我蜂嗽,道長,這世上最難降的妖魔是什么殃恒? 我笑而不...
    開封第一講書人閱讀 58,562評論 1 293
  • 正文 為了忘掉前任植旧,我火速辦了婚禮,結果婚禮上离唐,老公的妹妹穿的比我還像新娘病附。我一直安慰自己,他們只是感情好亥鬓,可當我...
    茶點故事閱讀 67,611評論 6 392
  • 文/花漫 我一把揭開白布胖喳。 她就那樣靜靜地躺著,像睡著了一般贮竟。 火紅的嫁衣襯著肌膚如雪丽焊。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,482評論 1 302
  • 那天咕别,我揣著相機與錄音技健,去河邊找鬼。 笑死惰拱,一個胖子當著我的面吹牛雌贱,可吹牛的內容都是我干的。 我是一名探鬼主播偿短,決...
    沈念sama閱讀 40,271評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼欣孤,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了昔逗?” 一聲冷哼從身側響起降传,我...
    開封第一講書人閱讀 39,166評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎勾怒,沒想到半個月后婆排,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體声旺,經...
    沈念sama閱讀 45,608評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,814評論 3 336
  • 正文 我和宋清朗相戀三年段只,在試婚紗的時候發(fā)現(xiàn)自己被綠了腮猖。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,926評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡赞枕,死狀恐怖澈缺,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情炕婶,我是刑警寧澤姐赡,帶...
    沈念sama閱讀 35,644評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站古话,受9級特大地震影響雏吭,放射性物質發(fā)生泄漏。R本人自食惡果不足惜陪踩,卻給世界環(huán)境...
    茶點故事閱讀 41,249評論 3 329
  • 文/蒙蒙 一杖们、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧肩狂,春花似錦摘完、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,866評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至审磁,卻和暖如春谈飒,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背态蒂。 一陣腳步聲響...
    開封第一講書人閱讀 32,991評論 1 269
  • 我被黑心中介騙來泰國打工杭措, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人钾恢。 一個月前我還...
    沈念sama閱讀 48,063評論 3 370
  • 正文 我出身青樓手素,卻偏偏與公主長得像,于是被迫代替她去往敵國和親瘩蚪。 傳聞我的和親對象是個殘疾皇子泉懦,可洞房花燭夜當晚...
    茶點故事閱讀 44,871評論 2 354

推薦閱讀更多精彩內容