我的GitHub
0%

无星的前端之旅(二十八)—— 离线安装npm库

背景

上文我们说到了怎么更新ms-playwright

本篇我们来聊聊怎么迁移playwright的版本

可能有朋友会奇怪,这有什么难的,把node_modulesplaywright相关的库全部移进去不就行了

其实也对,但是如果我是pnpm

其实虽然这一篇是升级playwright,但其实更多的是想表达,如何迁移npm库到离线环境

playwright为例,下面是我的一些探索

各种包管理工具下的迁移

运气比较好

本文成于2023.8.20

有老哥在2023.8.7总结了一次

节省了我很大的时间

npm 仓库私有包离线化安装方案

其中yarn我没测试过,npm稍有不准,pnpm可行

这其中,npm提到了一个库npm-package-privatify


ps:

我估摸着作者应该是这位小哥jjjona0215

虽然他在文中说到,不用关心解决了什么问题哈哈哈

1


为什么说npm稍有不准呢,因为npm-package-privatify并不会打包npm目标库的依赖库,作者的目标是解决私有库的问题,确实只是相似而不是同一目标,但是他给出了一些方向上的指引

本地库的加载

npm 仓库私有包离线化安装方案
离线环境安装npm包如何以tar.gz的形式离线安装npm包?

中,我们不难发现,包管理工具是支持通过tar.gz或者tgz加载的

那么我们的问题,其实变成了,如何生成tar.gz或者tgz


ps:

npm-pack-all 我试过了,相当不好用


压缩包的生成

其实这一步是最离谱的

说实话,我一直认为这是个简单打包命令

cdnode_modules下面的库

1
tar -zcvf <yourname>.tar.gz <yourpath>

这样做确实能得到tar.gz

但是当你通过pnpm或者其他工具安装时

你会发现package.json里的库名变成了操蛋的xxx.tar.gz

用起来各种报错

那么我们还有接下来几种方案

方式1.使用代码生成tar.gz

tar命令不靠谱,但是我试用npm-package-privatify发现,它打的tar.gz我能正常引入

关键代码如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
const fs = require("fs-extra")
const compressing = require('compressing')
const path = require('path')

// 将文件压缩为.tar.gz
/**
*
* @param {*} fileName 需要打包的npm库名
* @param {*} packagePath 待打包的路径,到node_modules即可
* @param {*} zipFileName 打包后压缩包名字
*/
const tarGz = async (fileName, packagePath, zipFileName) => {
await compressing.tar.compressDir(
path.join(packagePath, fileName),
path.join(packagePath, `${zipFileName}.tar`)
)
await compressing.gzip.compressFile(
path.join(packagePath, `${zipFileName}.tar`),
path.join(packagePath, `${zipFileName}.tar.gz`)
)
fs.removeSync(path.join(packagePath, `${zipFileName}.tar`))
// fs.removeSync(path.join(packagePath, fileName))
}

诶,就正常了

方式2.直接从npm仓库下载

打开package-lock.json会发现

我们要的库其实都是tgz压缩包,直接下载就行了

2

而且你会惊讶的发现,下载下来是可以通过包管理工具加载成功的


到这里是不是以为这就完事大吉了,两种方式都可以得到压缩包

NO

你会发现,这个压缩包只是单纯的压缩包,它不包含任何自身所需的依赖啊我去

所以我们还需要对playwright的依赖打包,并且修改package.json的依赖为file

这里所幸我需要的库仅为playwright-core,且这个库没有任何其他的依赖

那么我需要的就是

  • 1.下载playwright-coretgz
  • 2.修改playwrightpackage.json的依赖为file:类型
  • 3.给playwright打包

这里一定要注意第2点,因为一般执行npm install等其他命令时,都在项目根目录下执行

所以依赖的file:一定要写准备把playwright-core放在什么目录安装

例如,我准备把两个压缩包,都放在一个特定的文件下workspace/OfflineLibrary/playwright/

3.png

那么我在打包的时候,就需要写为file:OfflineLibrary/playwright/playwright-core-1.37.1.tgz
4.png

这里我给个playwright@1.37.1的产物包,大伙有需要的可以试一下断网安装

playwright-1.37.1.tar.gz

playwright-core-1.37.1.tgz

在项目根目录下,新建两个文件夹OfflineLibrary/playwright,将两个包丢进去,然后在项目根目录下执行pnpm add ./OfflineLibrary/playwright/playwright-1.37.1.tar.gz就可以成功安装了。

总结

到此为止,我们应该知道怎么去做npm库的离线包了

比如我们需要对库A做离线包

  • 1.下载A的所有依赖库,并打压缩包
  • 2.修改A的依赖项为file路径
  • 3.将A打压缩包
  • 4.将所有的依赖包丢到目标仓库进行安装

到目前我没找到称手的工具,可能需要按这个思路自己写一个吧(摊手)

如果有老哥老姐知道有写好的工具,麻烦丢一份给我,感谢

我是阿星,阿星的阿,阿星的星!