使用Angular Cli如何創建Angular私有庫詳解

前言

在實際開發中，會發現我們好多工作都是重復的，在代碼層面，發現好多代碼是可以被重用的。這樣我們就可以建一個庫，類似于java的庫，來提高工作效率。

下面話不多說了，來一起看看詳細的介紹吧

創建Angular項目

打開命令行終端， cd 到用于創建應用的目錄下，執行創建Angular項目命令：

ng new arsprojects -S

此命令將會創建一個新的Angular項目，文件夾名為 arsprojects 。 -S 參數表示不創建測試文件。我們創建的ng庫都將依托于 arsprojects 項目，它只是作為ng庫的容器存在，不需要建立測試。

用IDE打開 arsprojects 項目。

看到的文件結構就是我們常用的Angular項目結構。平時我們開發Angular項目，就是在 src/app 目錄下進行的。

我們想建的是一個ng庫，它和原來的Angular項目還是有一定差異的，ng庫不需要操作 src/app 下的內容。

創建一個組件庫

ng g library ars-components -p ars

g 是generate的簡寫方式， library 表示我們創建的是一個庫。 -p ars 表示我們創建的庫里面的組件是以 ars 開頭的。例如我們創建一個checkbox組件，那么他的selector就是 ars-checkbox ，在HTML中通過標簽來使用我們組件。

執行完該命令后，在ide中會發現，在我們的arsprojects中多了一個 projects 文件夾，里面是我們剛創建的 ars-components 。

同時，我們一開始創建arsprojects項目時創建的angular-cli.json也會被修改。里面會增加 ars-components 的項目信息。

"ars-components": {
"root": "projects/ars-components",
"sourceRoot": "projects/ars-components/src",
"projectType": "library",
"prefix": "ars",
"architect": {
"build": {
"builder": "@angular-devkit/build-ng-packagr:build",
"options": {
"tsConfig": "projects/ars-components/tsconfig.lib.json",
"project": "projects/ars-components/ng-package.json"
},
"configurations": {
"production": {
"project": "projects/ars-components/ng-package.prod.json"
}
}
},
"test": {
"builder": "@angular-devkit/build-angular:karma",
"options": {
"main": "projects/ars-components/src/test.ts",
"tsConfig": "projects/ars-components/tsconfig.spec.json",
"karmaConfig": "projects/ars-components/karma.conf.js"
}
},
"lint": {
"builder": "@angular-devkit/build-angular:tslint",
"options": {
"tsConfig": [
"projects/ars-components/tsconfig.lib.json",
"projects/ars-components/tsconfig.spec.json"
],
"exclude": [
"**/node_modules/**"
]
}
}
}
}
},
"defaultProject": "arsprojects"

同時會在 tsconfig.json 中創建 paths 選項。

"paths": {
"ars-components": [
"dist/ars-components"
]

通過修改tsconfig.json配置，可以讓我們方便的使用ars-components庫。

創建web站點項目

ng g application arswebsite --prefix web

此命令通過 application 腳手架創建一個名為 arswebsite 的項目，selector前綴為 web 。在ide中發現在ars-commponents同級目錄下創建了arswebsite和arswebsite-e2e兩個文件夾。

運行項目

在運行項目前，先做一些小改動，用于區分項目。

修改 projects/arswebsite/src/app/app.component.html 為

<h2>ArsWeb</h2>

修改 src/app/app.component.html 為

<h2>Main Angular App</h2>

啟動項目

ng serve

打開瀏覽器，訪問 http://localhost:4200。

另打開一個終端，執行命令

ng serve arswebsite --port 4201

打開瀏覽器，訪問 http://localhost:4201。

此時會發現，訪問了兩個不同的項目內容。

在ng庫中創建新組件

cd projects/ars-components/src/lib
ng generate component checkbox --project=ars-components

這樣就會在我們的ars-components庫中創建一個checkbox組件，組件的selector為ars-checkbox

編譯組件

cd yourfolder/arsprojects
ng build ars-components

會在dist目錄下生成ars-components編譯后的內容。

安裝組件

編譯后的組件，想要使用，需要現在本地安裝。

npm install dist/ars-components

使用組件

在arswebsite中使用ars-components組件，此時和使用其他第三方組件沒有任何區別。

website/src/app/app.moudle.ts 中引入 ArsComponentsModule :

import { ArsComponentsModule } from 'ars-components';

....

imports: [
 BrowserModule, ArsComponentsModule
],

這樣就可以在arswebsite中直接使用自定義庫中的庫組件了。

arswebsite/src/app/app.component.html 添加自定義組件

<ars-checkbox></ars-checkbox>

總結

在使用Angular cli創建庫總體來說還是很方便的，創建庫的意義就是讓我們在實際開發過程中，總結的一些可以被復用的代碼形成一個可被共享的資源，從而提高效率。

好了，以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，如果有疑問大家可以留言交流，謝謝大家對億速云的支持。