CLI開發(fā)工具前端構(gòu)建構(gòu)建工具代碼生成前端【免費(fèi)下載鏈接】angular-cliCLI tool for Angular項(xiàng)目地址https://gitcode.com/gh_mirrors/an/angular-cli點(diǎn)擊查看免費(fèi)下載導(dǎo)讀angular-devkit/core是 Angular CLI 生態(tài)中所有開發(fā)工具包DevKit共用的基礎(chǔ)庫(kù)負(fù)責(zé)提供跨平臺(tái)路徑處理、虛擬文件系統(tǒng)抽象、JSON Schema 校驗(yàn)、層級(jí)日志、工作區(qū)workspace讀寫與字符串/模板工具等底層能力。本文以倉(cāng)庫(kù)中由 API Extractor 自動(dòng)生成的官方 API 報(bào)告 goldens/public-api/angular_devkit/core/index.api.md 為骨架逐模塊拆解其全部公共導(dǎo)出符號(hào)類、接口、函數(shù)、類型與命名空間并結(jié)合 packages/angular_devkit/core/src 下的真實(shí)源碼幫助讀者理解每個(gè) API 的職責(zé)、調(diào)用約定與典型應(yīng)用場(chǎng)景。讀完本文你將能夠熟練使用這套基礎(chǔ)設(shè)施開發(fā)自己的 Angular 構(gòu)建工具、Schematics 或 CLI 插件。一、文檔性質(zhì)與整體導(dǎo)出結(jié)構(gòu)index.api.md是 API Extractor 工具自動(dòng)生成的“API 報(bào)告文件”API Report File它精確記錄了angular-devkit/core包對(duì)外公開的完整 TypeScript 類型簽名是理解該包能力邊界最權(quán)威的索引。報(bào)告開頭的 import 列表揭示了核心依賴ajvSchema 校驗(yàn)引擎、rxjs響應(yīng)式流貫穿整個(gè) API、source-map模板源碼映射的Position類型。從包入口 packages/angular_devkit/core/src/index.ts 可以看到核心模塊按功能域劃分為以下命名空間與頂層導(dǎo)出命名空間 / 導(dǎo)出職責(zé)virtualFs虛擬文件系統(tǒng)host 抽象、內(nèi)存實(shí)現(xiàn)、裝飾器、路徑操作json含json.schemaJSON 類型系統(tǒng)與 Schema 校驗(yàn)/轉(zhuǎn)換體系logging基于 rxjs Observable 的層級(jí)日志系統(tǒng)workspaces工作區(qū)angular.json的讀取、建模與寫入strings字符串命名轉(zhuǎn)換camelize、dasherize 等tags模板字符串標(biāo)簽函數(shù)oneLine、stripIndent 等test測(cè)試用虛擬文件系統(tǒng)TestHost頂層函數(shù)與類路徑工具、BaseException異常體系、PriorityQueue、template模板引擎源碼入口通過export *直接透出 exception.ts、json/index.ts、utils/index.ts、virtual-fs/index.ts 的全部符號(hào)因此報(bào)告中的所有頂層函數(shù)如normalize、join都可直接從包根導(dǎo)入。二、路徑系統(tǒng)Path類型與路徑工具函數(shù)Angular DevKit 將“路徑”建模為帶品牌標(biāo)記的字符串類型從根本上杜絕了 Unix 風(fēng)格/與 Windows 風(fēng)格\混用導(dǎo)致的跨平臺(tái) bug。API 報(bào)告定義了以下核心類型export type Path string { __PRIVATE_DEVKIT_PATH: void }; export type PathFragment Path { __PRIVATE_DEVKIT_PATH_FRAGMENT: void }; export type PosixPath string { __PRIVATE_DEVKIT_POSIX_PATH: void }; export type WindowsPath string { __PRIVATE_DEVKIT_WINDOWS_PATH: void };這些類型的實(shí)現(xiàn)見 packages/angular_devkit/core/src/virtual-fs/path.tsPath是“已被大多數(shù) DevKit 方法識(shí)別的規(guī)范化路徑”PathFragment是單個(gè)文件/目錄名不帶分隔符兩個(gè)常量NormalizedSep/與NormalizedRoot/分別定義了規(guī)范化路徑的分隔符與根。2.1 核心路徑函數(shù)一覽API 報(bào)告公開的路徑函數(shù)全部從包根直接導(dǎo)出包括函數(shù)簽名行為說明normalize(path: string): Path將任意字符串規(guī)范化為Path統(tǒng)一分隔符、合并重復(fù)分隔符noCacheNormalize(path: string): Path不做緩存的規(guī)范化版本避免長(zhǎng)駐進(jìn)程中的路徑緩存膨脹resetNormalizeCache(): void清空normalize內(nèi)部緩存join(p1: Path, ...others: string[]): Path拼接多個(gè)路徑片段并規(guī)范化relative(from: Path, to: Path): Path求相對(duì)路徑要求兩個(gè)入?yún)⒕鶠榻^對(duì)路徑否則拋出PathMustBeAbsoluteExceptionresolve(p1: Path, p2: Path): Path類似 Nodepath.resolve的規(guī)范化解析split(path: Path): PathFragment[]按分隔符切分為片段數(shù)組末尾空片段會(huì)被剔除basename(path: Path): PathFragment取文件名dirname(path: Path): Path取目錄名extname(path: Path): string取擴(kuò)展名含點(diǎn)號(hào)isAbsolute(p: Path): boolean判斷是否以/開頭fragment(path: string): PathFragment將字符串轉(zhuǎn)換為片段類型getSystemPath(path: Path): string轉(zhuǎn)換為當(dāng)前操作系統(tǒng)原生路徑格式asPosixPath/asWindowsPath(path: Path): PosixPath / WindowsPath顯式轉(zhuǎn)換為對(duì)應(yīng)平臺(tái)格式源碼中join的實(shí)現(xiàn)path.ts展示了其歸一化策略(p1 ? p1 / : ) others.join(/)后交給normalizerelative則先校驗(yàn)絕對(duì)性再對(duì)兩個(gè)路徑逐段比較公共前綴并回溯..dirname對(duì)根目錄下的文件如/file做了特判返回/。這些邊界處理正是 DevKit 路徑 API 比手寫字符串操作更可靠的原因。2.2path模板標(biāo)簽報(bào)告同時(shí)導(dǎo)出一個(gè)path: TemplateTagPath允許以 ES6 模板字符串形式構(gòu)造規(guī)范化路徑import { path } from angular-devkit/core; const p path/src/${app}/main.ts; // 類型為 Path內(nèi)容已規(guī)范化其實(shí)現(xiàn)基于 utils/literals.ts 中的TemplateTag機(jī)制與tags命名空間中的oneLine、stripIndent等共用同一套模板標(biāo)簽基礎(chǔ)設(shè)施。三、虛擬文件系統(tǒng)virtualFs統(tǒng)一一切文件訪問virtualFs是angular-devkit/core最有價(jià)值的抽象之一它把“文件系統(tǒng)”建模為一個(gè)基于 rxjs Observable 的異步接口使同一套業(yè)務(wù)代碼可以透明地運(yùn)行在真實(shí)磁盤、內(nèi)存、壓縮包或測(cè)試夾具之上。接口定義見 packages/angular_devkit/core/src/virtual-fs/host/interface.ts。3.1 核心接口ReadonlyHost與Hostinterface ReadonlyHostStatsT extends object {} { readonly capabilities: HostCapabilities; exists(path: Path): Observableboolean; isDirectory(path: Path): Observableboolean; isFile(path: Path): Observableboolean; list(path: Path): ObservablePathFragment[]; read(path: Path): ObservableFileBuffer; stat(path: Path): ObservableStatsStatsT | null | null; } interface HostStatsT extends object {} extends ReadonlyHostStatsT { delete(path: Path): Observablevoid; rename(from: Path, to: Path): Observablevoid; watch(path: Path, options?: HostWatchOptions): ObservableHostWatchEvent | null; write(path: Path, content: FileBufferLike): Observablevoid; }關(guān)鍵設(shè)計(jì)點(diǎn)文件內(nèi)容類型FileBuffer即ArrayBufferFileBufferLike為ArrayBufferLike強(qiáng)調(diào)二進(jìn)制安全報(bào)告標(biāo)記為 deprecated 的stringToFileBuffer/fileBufferToString提供了與字符串互轉(zhuǎn)的兼容通道。能力標(biāo)志HostCapabilities只有一個(gè)synchronous: boolean字段用于標(biāo)注 host 是否支持同步訪問這是SyncDelegateHost能否安全包裝的判據(jù)。監(jiān)聽機(jī)制watch返回ObservableHostWatchEvent事件對(duì)象攜帶path、time與typeHostWatchEventType枚舉定義了Changed(0)、Created(1)、Deleted(2)、Renamed(3)四種事件類型Renamed作用于原文件路徑。HostWatchOptions支持persistent與recursive兩個(gè)選項(xiàng)。元數(shù)據(jù)Stats類型在宿主自定義字段基礎(chǔ)上混入isFile()、isDirectory()以及size、atime、mtime、ctime、birthtime與 Nodefs.Stats對(duì)齊。3.2 內(nèi)存實(shí)現(xiàn)SimpleMemoryHost與TestHostSimpleMemoryHost是純內(nèi)存的Host實(shí)現(xiàn)內(nèi)部維護(hù)MapPath, StatsSimpleMemoryHostStats緩存所有讀寫操作exists、isDirectory、isFile、list、read、stat、delete、rename、write、watch均有對(duì)應(yīng)的受保護(hù)同步版本_exists、_read等并提供reset()一鍵清空。SimpleMemoryHostStats攜帶content: FileBuffer | null與inspect()。TestHost繼承SimpleMemoryHost并疊加測(cè)試能力構(gòu)造時(shí)可傳入{[path: string]: string}初始文件映射$exists、$read、$write等以$前綴的同步便捷方法直接操作字符串內(nèi)容records/clearRecords()記錄每次文件操作的日志TestLogRecord用于斷言“讀取了哪些文件”files屬性列出全部文件sync返回SyncDelegateHost同步視圖。它是 modules/testing/builder 等測(cè)試基建的核心底座。3.3 裝飾器鏈ResolverHost及其子類ResolverHostT是一個(gè)抽象包裝類把路徑解析邏輯抽成protected abstract _resolve(path: Path): Path子類只需實(shí)現(xiàn)路徑重寫規(guī)則即可透明裝飾任意底層 hostAliasHost通過_aliases: MapPath, Path實(shí)現(xiàn)路徑別名get aliases()暴露映射表PatternMatchingHost以正則MapRegExp, ReplacementFunction實(shí)現(xiàn)模式替換addPattern(pattern, replacementFn)注冊(cè)規(guī)則ScopedHost以_root: Path將整個(gè) host 限定在某個(gè)子目錄視野內(nèi)對(duì)外路徑自動(dòng)拼接到 root 下。這三者分別服務(wù)于“路徑重定向”“批量規(guī)則改寫”“目錄隔離”三類典型場(chǎng)景且全部保持 Observable 異步語義不變。3.4 記錄與提交CordHostCordHost命名取自“cord/編目”在內(nèi)存 host 之上記錄所有待執(zhí)行變更實(shí)現(xiàn)“事務(wù)式”文件系統(tǒng)變更集合_filesToCreate、_filesToOverwrite、_filesToDelete、_filesToRename/_filesToRenameRevert查詢方法willCreate(path)、willOverwrite(path)、willDelete(path)、willRename(path)、willRenameTo(path, to)records(): CordHostRecord[]導(dǎo)出變更清單記錄類型為聯(lián)合類型CordHostCreate | CordHostOverwrite | CordHostRename | CordHostDelete每種都帶kind判別字段與path創(chuàng)建/覆蓋還帶content重命名帶from/tocommit(host, force?)將全部記錄應(yīng)用到目標(biāo) host返回Observablevoidclone()可復(fù)制當(dāng)前狀態(tài)。這使 DevKit 可以在“模擬執(zhí)行”與“真正落盤”之間自由切換與 Schematics 的 Tree 思想一脈相承。3.5 同步適配與工廠SyncDelegateHostT將異步HostT包裝為同步接口read返回FileBuffer、write為void內(nèi)部通過_doSyncCall阻塞等待 Observable 完成若底層 host 不滿足capabilities.synchronous相關(guān)調(diào)用會(huì)拋出SynchronousDelegateExpectedException。createSyncHostStatsT(handler: SyncHostHandlerStatsT): HostStatsT反向操作把一組純同步回調(diào)SyncHostHandler全部方法直接返回值而非 Observable適配為異步Host。Empty實(shí)現(xiàn)ReadonlyHost的空文件系統(tǒng)一切存在性查詢恒為 false。SafeReadonlyHost為ReadonlyHost提供防御性包裝避免外部誤用可變接口。四、JSON 類型系統(tǒng)與 Schema 校驗(yàn)體系json/json.schemajson命名空間定義了 DevKit 通用的 JSON 值類型json.schema則提供完整的 JSON Schema 編譯、校驗(yàn)、提示與轉(zhuǎn)換能力是angular.json、Schematic 選項(xiàng)等所有配置校驗(yàn)的底層引擎。4.1 JSON 值類型export type JsonValue boolean | string | number | JsonArray | JsonObject | null; export interface JsonObject { [prop: string]: JsonValue; } export interface JsonArray extends ArrayJsonValue {}配套的類型守衛(wèi)isJsonObject(value): value is JsonObject與isJsonArray(value): value is JsonArray可用于安全收窄類型。JsonPointer是帶品牌標(biāo)記的字符串類型string { __PRIVATE_DEVKIT_JSON_POINTER: void }配合buildJsonPointer(fragments)、joinJsonPointer(root, ...others)、parseJsonPointer(pointer)三個(gè)函數(shù)完成 JSON PointerRFC 6901的構(gòu)造與解析。4.2CoreSchemaRegistrySchema 注冊(cè)中心CoreSchemaRegistry implements SchemaRegistry是整套校驗(yàn)體系的中心實(shí)現(xiàn)見 packages/angular_devkit/core/src/json/schema/registry.ts。其構(gòu)造函數(shù)默認(rèn)創(chuàng)建Ajv實(shí)例并加載ajv-formats關(guān)鍵成員如下成員說明compile(schema)將JsonSchema編譯為PromiseSchemaValidatoraddFormat(format)注冊(cè)自定義SchemaFormatnameformatter: Format對(duì)應(yīng) ajv 的 FormataddSmartDefaultProviderT(source, provider)注冊(cè)“智能默認(rèn)值”提供者SmartDefaultProvider輸入 schema、返回T | ObservableTusePromptProvider(provider)啟用交互式提示當(dāng) schema 中聲明x-prompt時(shí)按PromptDefinition收集用戶輸入useXDeprecatedProvider(onUsage)上報(bào) schema 中x-deprecated標(biāo)記的使用情況addPreTransform/addPostTransform在編譯校驗(yàn)前后注入JsonVisitor轉(zhuǎn)換器支持依賴排序內(nèi)部用PartiallyOrderedSet管理registerUriHandler(handler)注冊(cè)$ref外部 URI 的解析器UriHandler失敗時(shí)回退到內(nèi)置 HTTP 客戶端?flatten(schema)展平$ref引用的內(nèi)部方法4.3 校驗(yàn)器與結(jié)果interface SchemaValidator { (data: JsonValue, options?: SchemaValidatorOptions): PromiseSchemaValidatorResult; } interface SchemaValidatorResult { data: JsonValue; errors?: SchemaValidatorError[]; // SchemaValidatorError PartialErrorObject來自 ajv success: boolean; }SchemaValidatorOptions提供applyPreTransforms、applyPostTransforms、withPrompts三個(gè)開關(guān)可精確控制校驗(yàn)管線。校驗(yàn)失敗時(shí)拋出SchemaValidationException繼承自BaseException其靜態(tài)方法createMessages(errors)會(huì)把 ajv 錯(cuò)誤轉(zhuǎn)換為可讀消息——源碼對(duì)additionalProperties關(guān)鍵字會(huì)給出“Unknown option xxx. Valid options are: ...”對(duì)enum會(huì)列出允許值顯著提升了 CLI 報(bào)錯(cuò)的用戶體驗(yàn)。4.4 遍歷與合并工具visitJsonContextT(json, visitor, schema?, refResolver?, context?)按 schema 驅(qū)動(dòng)遍歷 JSON 樹JsonVisitor可返回ObservableJsonValue | JsonValue從而支持異步轉(zhuǎn)換ReferenceResolver負(fù)責(zé)解析遍歷中遇到的$ref。visitJsonSchema(schema, visitor)遍歷 schema 自身結(jié)構(gòu)JsonSchemaVisitor收到(current, pointer, parentSchema?, index?)。mergeSchemas(...schemas)合并多個(gè) schema。getTypesOfSchema(schema): Setstring提取 schema 聲明的類型集合。transforms命名空間addUndefinedDefaults(value, pointer, schema?)與addUndefinedObjectDefaults為 schema 中聲明了default但數(shù)據(jù)中缺失的屬性補(bǔ)填默認(rèn)值是“智能默認(rèn)值”的靜態(tài)實(shí)現(xiàn)。PromptDefinition是交互式提示的定義結(jié)構(gòu)id、message、type、propertyTypes、可選default、items普通值或{value, label}對(duì)象、multiselect、validator與rawPromptProvider接收定義數(shù)組并返回ObservableInput{[id]: JsonValue}將問題與答案映射起來。關(guān)于x-prompt的完整約定可參見 docs/specifications/schematic-prompts.md。五、層級(jí)日志系統(tǒng)logging基于 Observable 的 Loggerlogging命名空間提供一套可組合、可級(jí)聯(lián)、可變換的日志實(shí)現(xiàn)核心類Logger直接繼承 rxjs 的ObservableLogEntry實(shí)現(xiàn)見 packages/angular_devkit/core/src/logger/logger.ts這意味著日志流天然支持map、filter、merge等所有 rxjs 操作符。5.1 核心類型與等級(jí)export type LogLevel debug | info | warn | error | fatal; interface LogEntry extends LoggerMetadata { level: LogLevel; message: string; timestamp: number; } interface LoggerMetadata extends JsonObject { name: string; path: string[]; }Logger構(gòu)造時(shí)通過遍歷 parent 鏈構(gòu)建path元數(shù)據(jù)如[root, build]因此每條日志都自帶“日志來源層級(jí)路徑”。LoggerApi接口定義了createChild、log以及debug/info/warn/error/fatal五個(gè)等級(jí)方法Logger.asApi()返回剝離 Observable 能力的純接口視圖便于在不想暴露訂閱能力的場(chǎng)景下傳遞。5.2 級(jí)聯(lián)與子 LoggercreateChild(name)創(chuàng)建子 Logger子 Logger 的每條日志會(huì)自動(dòng)上拋給父 Logger構(gòu)造函數(shù)中通過訂閱父_subject實(shí)現(xiàn)最終匯聚到根 Logger——這正是 CLI 中“各模塊分別打印、統(tǒng)一采集”架構(gòu)的基礎(chǔ)。forEach(next, promiseCtor?)提供以 Promise 方式遍歷日志流的能力。5.3 變換型 Logger類行為IndentLogger構(gòu)造參數(shù)indentation: string每條日志自動(dòng)加上縮進(jìn)前綴適合嵌套任務(wù)的可視化縮進(jìn)LevelTransformLogger以(level: LogLevel) LogLevel變換日志等級(jí)如把 fatal 降級(jí)為 errorLevelCapLogger基于levelMap靜態(tài)表將日志等級(jí)“封頂”到指定上限超限等級(jí)被映射為上限等級(jí)TransformLogger以(stream: ObservableLogEntry) ObservableLogEntry對(duì)流做任意變換是最靈活的擴(kuò)展點(diǎn)NullLogger丟棄所有日志的無操作實(shí)現(xiàn)用于靜默模式六、工作區(qū) APIworkspaces讀寫angular.jsonworkspaces命名空間封裝了 Angular 工作區(qū)配置文件的建模與讀寫是 CLI 命令如ng config、ng generate操作angular.json的統(tǒng)一入口。核心實(shí)現(xiàn)見 packages/angular_devkit/core/src/workspace/core.ts 與 definitions.ts。6.1 定義模型interface WorkspaceDefinition { readonly extensions: Recordstring, JsonValue | undefined; readonly projects: ProjectDefinitionCollection; } interface ProjectDefinition { readonly extensions: Recordstring, JsonValue | undefined; readonly targets: TargetDefinitionCollection; root: string; prefix?: string; sourceRoot?: string; } interface TargetDefinition { options?: Recordstring, JsonValue | undefined; configurations?: Recordstring, Recordstring, JsonValue | undefined | undefined; defaultConfiguration?: string; builder: string; }ProjectDefinitionCollection與TargetDefinitionCollection均繼承內(nèi)部DefinitionCollectionV一個(gè)實(shí)現(xiàn)ReadonlyMap的集合其set/delete會(huì)觸發(fā)可選的DefinitionCollectionListenerV監(jiān)聽器——這正是“修改工作區(qū)模型 → 自動(dòng)同步回磁盤”機(jī)制的關(guān)鍵。add()方法用于向集合添加定義項(xiàng)目名重復(fù)時(shí)拋出Project name already exists.見 definitions.ts。6.2 讀寫流程interface WorkspaceHost { isDirectory(path: string): Promiseboolean; isFile(path: string): Promiseboolean; readFile(path: string): Promisestring; writeFile(path: string, data: string): Promisevoid; } function createWorkspaceHost(host: virtualFs.Host): WorkspaceHost; async function readWorkspace(path: string, host: WorkspaceHost, format?: WorkspaceFormat): Promise{ workspace: WorkspaceDefinition }; function writeWorkspace(workspace: WorkspaceDefinition, host: WorkspaceHost, path?: string, format?: WorkspaceFormat): Promisevoid;WorkspaceFormat目前只有JSON一種取值。createWorkspaceHost把virtualFs.Host適配為基于 Promise 的WorkspaceHost實(shí)現(xiàn)“虛擬文件系統(tǒng) ←→ 工作區(qū)讀寫”的橋接。readWorkspace的行為見 core.ts若傳入的是目錄則在其中查找已知工作區(qū)文件——目前僅angular.json與.angular.json找不到時(shí)報(bào)錯(cuò)Unable to locate a workspace file...若傳入的是文件則根據(jù)文件名推斷格式最終委托readJsonWorkspace解析并將格式記錄在formatLookupWeakMap 中供writeWorkspace復(fù)用。倉(cāng)庫(kù)中 packages/angular_devkit/core/src/workspace/json/test/cases 目錄下的大量 JSON 用例AddProject1.json、ProjectAddTarget.json、ArrayPush.json等驗(yàn)證了工作區(qū)修改的各種邊界場(chǎng)景可作為理解數(shù)據(jù)模型變化的參考。七、字符串、模板與通用工具7.1strings命名風(fēng)格轉(zhuǎn)換strings命名空間提供 CLI 領(lǐng)域高頻使用的命名轉(zhuǎn)換函數(shù)實(shí)現(xiàn)見 packages/angular_devkit/core/src/utils/strings.ts其行為在源碼注釋中有明確示例函數(shù)示例decamelize(str)innerHTML→inner_htmldasherize(str)innerHTML→inner-htmlaction_name→action-namecamelize(str)將-、_、.、空格后的字符大寫classify(str)首字母大寫的 camelize用于生成類名underscore(str)innerHTML→inner_h_t_m_l基于/([a-z\d])([A-Z])/g規(guī)則capitalize(str)首字母大寫levenshtein(a, b)計(jì)算編輯距離CLI 中用于“您是不是想輸入 xxx”的拼寫建議7.2tags模板字符串標(biāo)簽oneLine(strings, ...values)將多行模板字符串合并為單行stripIndent/stripIndents去除公共縮進(jìn)indentBy(indentations)生成按指定空格數(shù)縮進(jìn)的標(biāo)簽函數(shù)trimNewlines去除首尾空行。7.3template模板編譯引擎templateT(content, options?): (input: T) string將字符串編譯為帶類型參數(shù)T的渲染函數(shù)配合templateParser(sourceText, fileName): TemplateAst與TemplateAst*系列節(jié)點(diǎn)類型TemplateAstContent、TemplateAstEvaluate、TemplateAstComment、TemplateAstEscape、TemplateAstInterpolate使用。TemplateOptions支持fileName、module、sourceMap、sourceRoot、sourceURL。這是 Schematics 中.template文件渲染機(jī)制的底層實(shí)現(xiàn)例如 packages/schematics/angular/component/files 下的模板即由它驅(qū)動(dòng)。7.4 其他通用結(jié)構(gòu)PriorityQueueT二叉堆式優(yōu)先隊(duì)列提供push、pop、peek、clear、toArray、size構(gòu)造時(shí)傳入比較器(x, y) number。PartiallyOrderedSetTdeprecated帶依賴關(guān)系的偏序集合add(item, deps?)支持聲明依賴并在出現(xiàn)循環(huán)時(shí)拋出CircularDependencyFoundException已逐步被替換但仍被CoreSchemaRegistry的 visitor 排序內(nèi)部使用。deepCopyTdeprecated通用深拷貝工具。isPromise(obj)deprecatedPromise 類型守衛(wèi)已被更現(xiàn)代的判斷方式取代。八、異常體系BaseException與派生異常報(bào)告頂部與各模塊中散布的異常類統(tǒng)一繼承自BaseException extends Error定義見 packages/angular_devkit/core/src/exception.ts構(gòu)成一棵清晰的異常樹通用UnknownException攜帶自定義消息、CircularDependencyFoundException、DependencyNotFoundException路徑相關(guān)InvalidPathException、PathCannotBeFragmentException、PathIsDirectoryException、PathIsFileException、PathMustBeAbsoluteException以及文件相關(guān)FileDoesNotExistException、FileAlreadyExistExceptionSchema 相關(guān)SchemaValidationException見 registry.ts同步適配相關(guān)SynchronousDelegateExpectedException。BaseException目前僅是對(duì)Error的薄封裝各派生類在構(gòu)造時(shí)生成面向用戶的友好消息如Path x does not exist.CLI 層通過統(tǒng)一的異常處理流程將這些消息呈現(xiàn)給用戶。九、典型應(yīng)用場(chǎng)景總結(jié)綜合以上模塊angular-devkit/core在倉(cāng)庫(kù)內(nèi)的典型協(xié)作方式是CLI 命令層如 packages/angular/cli/src/commands使用workspaces.readWorkspace讀取工作區(qū)模型通過ProjectDefinitionCollection/TargetDefinitionCollection增刪改項(xiàng)目與 target構(gòu)建與生成邏輯使用virtualFs.Host抽象訪問文件真實(shí)環(huán)境用磁盤 host測(cè)試環(huán)境用TestHost用CordHost實(shí)現(xiàn)變更暫存與提交所有配置angular.json、schema.json經(jīng)CoreSchemaRegistry編譯校驗(yàn)缺失選項(xiàng)由addSmartDefaultProvider補(bǔ)默認(rèn)值、usePromptProvider在交互模式下向用戶提問命令行輸出經(jīng)Logger層級(jí)體系逐級(jí)上拋、統(tǒng)一采集與格式化生成文件的命名組件名、類名、選擇器由strings命名轉(zhuǎn)換函數(shù)完成跨平臺(tái)路徑由normalize、join、relative等PathAPI 保證一致性。從 API 報(bào)告 index.api.md 到各模塊源碼virtual-fs、json/schema、logger、workspace、utilsangular-devkit/core始終貫徹“小而穩(wěn)、可組合、響應(yīng)式”的設(shè)計(jì)哲學(xué)。對(duì)于希望擴(kuò)展 Angular CLI 或開發(fā) Schematics 工具的開發(fā)者而言這份公共 API 就是最重要的開發(fā)地圖。贊分享CLI開發(fā)工具前端構(gòu)建構(gòu)建工具代碼生成前端【免費(fèi)下載鏈接】angular-cliCLI tool for Angular項(xiàng)目地址https://gitcode.com/gh_mirrors/an/angular-cli點(diǎn)擊查看免費(fèi)下載相關(guān)推薦GitHub Copilot Hooks 編寫指南從配置到腳本契約的完整實(shí)戰(zhàn)GitHub Copilot Hooks 編寫指南從配置到腳本契約的完整實(shí)戰(zhàn) Hooks 是 GitHub Copilot 在會(huì)話生命周期關(guān)鍵節(jié)點(diǎn)觸發(fā)的 小型CLI開發(fā)工具前端構(gòu)建構(gòu)建工具代碼生成前端Angular Material Core 公共 API 全解析angular/material/core 的核心基礎(chǔ)設(shè)施與擴(kuò)展指南Angular Material Core 公共 API 全解析angular/material/core 的核心基礎(chǔ)設(shè)施與擴(kuò)展指南 angular/ma前端UI組件設(shè)計(jì)系統(tǒng)4步把電視盒子變成家庭K歌房TVBoxOSC 卡拉OK功能上手指南4步把電視盒子變成家庭K歌房TVBoxOSC 卡拉OK功能上手指南 想邀朋友來家里唱歌又不想花錢訂KTV包廂你手邊的電視盒子就能派上用場(chǎng)。TVBoxOSCCLI開發(fā)工具前端構(gòu)建構(gòu)建工具代碼生成前端上一篇如何用Type Helper優(yōu)化DTOPartialType、PickType、OmitType實(shí)戰(zhàn)下一篇Lockbox安全最佳實(shí)踐防止數(shù)據(jù)泄露與長(zhǎng)度分析攻擊創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考