前言
為新羅等地區(qū)用戶提供了全套網(wǎng)頁設(shè)計(jì)制作服務(wù),及新羅網(wǎng)站建設(shè)行業(yè)解決方案。主營業(yè)務(wù)為成都網(wǎng)站制作、成都網(wǎng)站設(shè)計(jì)、外貿(mào)營銷網(wǎng)站建設(shè)、新羅網(wǎng)站設(shè)計(jì),以傳統(tǒng)方式定制建設(shè)網(wǎng)站,并提供域名空間備案等一條龍服務(wù),秉承以專業(yè)、用心的態(tài)度為用戶提供真誠的服務(wù)。我們深信只要達(dá)到每一位用戶的要求,就會(huì)得到認(rèn)可,從而選擇與我們長期合作。這樣,我們也可以走得更遠(yuǎn)!
前段時(shí)間9月21日參加了在成都舉辦的第五屆FEDAY, 印象比較深刻的是白鷺引擎首席架構(gòu)師@王澤分享的《框架開發(fā)中的基礎(chǔ)設(shè)施搭建》 ,提到了在下一代白鷺引擎中使用到monorepo模式,以用來管理多個(gè)模塊,協(xié)調(diào)各個(gè)模塊之間的依賴更新。
正好在國慶期間10月5日尤大公開了vue3.0已完成的源碼,也是采用了monorepo管理模式,看來monorepo確實(shí)有其獨(dú)到的優(yōu)勢,再加上以前在項(xiàng)目中遇到過相關(guān)的痛點(diǎn),所以深入地了解了一下這種模式,本文將基于vue3.0討論如何通過monorepo模式來管理代碼的。
什么是 monorepo?
monorepo是一種將多個(gè)package放在一個(gè)repo中的代碼管理模式,摒棄了傳統(tǒng)的多個(gè)package多個(gè)repo的模式。
目前 Babel, React, Angular, Ember, Meteor, Jest等許多開源項(xiàng)目都使用該種模式來管理代碼。
解決的問題
帶來的問題
如何實(shí)現(xiàn) monorepo?
目前業(yè)界最佳實(shí)踐是采用yarn workspace + lerna 來實(shí)現(xiàn),vue3.0也是采用兩者結(jié)合的方式來實(shí)現(xiàn)。
yarn workspace可以實(shí)現(xiàn)在一個(gè)項(xiàng)目中實(shí)現(xiàn)多個(gè)模塊的依賴新增和共用,而lerna的功能則更完善,不僅可以管理多個(gè)模塊,還有清除模塊node_modules,發(fā)布模塊到npm,自動(dòng)更新模塊間版本依賴,并支持全量發(fā)布和根據(jù)改動(dòng)單獨(dú)發(fā)布等功能。
yarn官方推薦用yarn來處理依賴安裝,用lerna來處理依賴更新和發(fā)布問題。
下面開始基于monorepo模式來搭建一個(gè)仿vue3.0的項(xiàng)目
1. 全局安裝 yarn 和 lerna
$ npm i -g yarn lerna
2. 初始化項(xiàng)目
$ mkdir vue-next && cd vue-next $ lerna init // 此時(shí)項(xiàng)目結(jié)構(gòu) vue-next |-packages |-lerna.json |-package.json
3. 添加yarn workspace配置
// vue-next/package.json "private": true, // 項(xiàng)目根目錄下的private必須設(shè)置成true,否則workspace不會(huì)被啟用 "workspaces": [ // 指定需要管理的模塊 "packages/*" ],
4. 添加模塊內(nèi)容
// 此時(shí)項(xiàng)目結(jié)構(gòu) vue-next |-packages // packages下的所有包結(jié)構(gòu)類似,下面僅展示了compiler-core包的目錄結(jié)構(gòu) |-compiler-core // 與平臺(tái)無關(guān)的編譯器 |-__tests__ // 測試用例 |-src // 源文件 |-index.js // 根文件 |-package.json // 包配置 |-compiler-dom // 與瀏覽器相關(guān)的編譯器 |-reactivity // 數(shù)據(jù)響應(yīng)式系統(tǒng) |-runtime-core // 與平臺(tái)無關(guān)的runtime |-runtime-dom // 與瀏覽器相關(guān)的runtime |-runtime-test // 為了測試的輕量級runtime |-server-renderer // 服務(wù)端渲染 |-shared // 內(nèi)部幫助方法 |-template-explorer // 預(yù)覽模版轉(zhuǎn)化成render函數(shù)的工具 |-vue // 用于構(gòu)建完整的vue版本 |-lerna.json |-package.json
5. 安裝相關(guān)依賴
項(xiàng)目中一般只會(huì)用到以下3種安裝形式
5.1 給根項(xiàng)目安裝依賴(一般是公用的開發(fā)工具)
// yarn 使用 workspace 模式安裝 npm 包時(shí)必須加 -W 參數(shù) $ yarn add -W -D rollup typescript jest prettier ...
5.2 給package安裝外部npm包
// @vue/compiler-core 是取 vue-next/packages/compiler-core/package.json 的 name 字段 $ yarn workspace @vue/compiler-core add acorn estree-walker source-map $ yarn workspace @vue/template-explorer add monaco-editor
5.3 給package安裝內(nèi)部npm包
// @vue/compiler-core 是取 vue-next/packages/compiler-core/package.json 的 name 字段 $ yarn workspace @vue/compiler-dom add @vue/compiler-core@3.0.0-alpha.1 // 一定要指定正確的版本號,不然會(huì)到npm查找包 $ yarn workspace @vue/runtime-core add @vue/reactivity@3.0.0-alpha.1 $ yarn workspace @vue/runtime-dom add @vue/runtime-core@3.0.0-alpha.1 $ yarn workspace @vue/runtime-test add @vue/runtime-core@3.0.0-alpha.1 $ yarn workspace vue add @vue/compiler-dom@3.0.0-alpha.1 @vue/runtime-dom@3.0.0-alpha.1 // 可同時(shí)安裝多個(gè)
至此已經(jīng)完成了項(xiàng)目的基礎(chǔ)搭建(打包等工程化內(nèi)容略過,本文主要介紹monorepo相關(guān)),似乎主要是yarn在工作,lerna沒有沒有派上用場,下面來介紹lerna在哪些地方可以賦能vue3.0。
lerna介紹
A tool for managing JavaScript projects with multiple packages.
一個(gè)在js項(xiàng)目中用來管理多個(gè)package的工具。
主要是便于開發(fā)者更加高效簡便地管理package本身,依賴,發(fā)布。
1. 初始化項(xiàng)目
// 生成基本項(xiàng)目結(jié)構(gòu)和 lerna 配置 $ lerna init
2. 安裝依賴
如果需要重新安裝依賴,切記在刪除項(xiàng)目根路徑的node_modules前進(jìn)行g(shù)it提交保存,因?yàn)閙onorepo模式是以軟鏈接的形式來實(shí)現(xiàn)內(nèi)部 package 引用的,直接刪除整個(gè)node_modules的同時(shí)會(huì)把所有package的文件刪掉,難以恢復(fù)!
建議永不進(jìn)行刪除整個(gè)node_modules的操作,可以進(jìn)入node_modules全選后再取消勾選內(nèi)部package軟鏈接再刪除。
// 給所有 package 安裝依賴,在對于的目錄生成 node_modules,并在 node_modules 中為內(nèi)部package生成軟鏈接 $ lerna bootstrap // 默認(rèn)會(huì)使用 npm 安裝,但是本項(xiàng)目使用 yarn,可以指定使用 yarn $ lerna bootstrap --npm-client=yarn // 或者在 lerna.json 配置 {"npmClient": "yarn"} // 上述安裝方式如果不同package之間安裝了同一個(gè)npm包,會(huì)造成重復(fù)安裝,增加安裝時(shí)間和項(xiàng)目體積 // 可以利用 node_modules 向上查找的特性,將所有依賴安裝到項(xiàng)目根路徑的 node_modules 中,lerna 加上 --hosit即可 $ lerna bootstrap --hosit // 使用lerna bootstrap --npm-client=yarn --hoist // 會(huì)有沖突,報(bào)錯(cuò)--hoist is not supported with --npm-client=yarn, use yarn workspaces instead ------------------------------------------------ $ yarn // 推薦??! 用 yarn workspace 特性替代 lerna bootstrap
3. 清除pacakge中多余的node_modules
// 在 6.2 安裝依賴時(shí),部分npm包會(huì)給當(dāng)前的package目錄安裝 node_modules // 同時(shí)根路徑中的 node_modules 也會(huì)安裝項(xiàng)目 $ lerna clean
4. 查看所有pacakge
// package.json 中設(shè)置了 "private": true 的 package 不會(huì)展示 $ lerna ls
5. 查看有改動(dòng)的pacakge
// package.json 中設(shè)置了 "private": true 的 package 不會(huì)展示 // 在 Independent mode 下只有改動(dòng)過的 package 才會(huì)被發(fā)布 // vue3.0 采用的是 Fixed/Locked mode (default),每次都會(huì)發(fā)布所有 package,package 版本跟隨項(xiàng)目的版本走 $ lerna changed
6. 推送到git和發(fā)布到npm(重要)
// 根據(jù)當(dāng)前的 lerna 模式(Fixed/Locked mode (default) 或者 Independent mode)來進(jìn)行整包發(fā)布或者有改動(dòng)的 package 單獨(dú)發(fā)布 // 每次發(fā)布會(huì)自動(dòng)更新相關(guān)package的版本號,并且會(huì)更新引用該package的其他package依賴 $ lerna publish
monorepo demo 鏈接
總結(jié)
本文介紹了vue3.0中monorepo管理模式的實(shí)現(xiàn),通過yarn workspace和lerna兩者相結(jié)合,達(dá)到了在一個(gè)repo 中高效便捷地管理多個(gè)package的目的。
在我們?nèi)粘9ぷ髦锌赡軟]有開發(fā)白鷺引擎,vue這類大型框架的需求,但是這不代表我們用不到該模式,下面我總結(jié)了幾種適合monorepo管理模式的場景:
參考資料
框架開發(fā)中的基礎(chǔ)設(shè)施搭建
Vue 3 源碼導(dǎo)讀
基于lerna和yarn workspace的monorepo工作流
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持創(chuàng)新互聯(lián)。