使用 pkg 打包 Puppeteer 应用：跨平台自动化的轻量级选择

使用 `pkg` 打包 Puppeteer 应用

pkg 是一个非常强大的工具，它允许你将 Node.js 项目打包成独立的可执行文件，这意味着你可以在没有安装 Node.js 环境的设备上运行该应用。这对于希望分发不暴露源代码的应用程序、创建跨平台的快速演示版本或简化部署流程的开发者来说，是一个非常有用的工具。

使用了2天用pkg打包，在运行main.exe总提示 Passed function cannot be serialized 错误。后面终止成功运行了。

安装 `pkg`

首先，你需要全局安装 pkg。在你的命令行界面中运行以下命令：

npm install -g pkg

打包你的 Node.js 项目

使用 pkg 打包你的项目非常简单。首先，确保你有一个入口文件，例如 index.js。然后，在项目目录下运行 pkg 命令：

pkg index.js --target=node16 --platform=all --output=myapp

这里的参数解释如下：

index.js 是你的入口文件路径。
--target=node16 指定目标 Node.js 版本，可以是具体的版本号或 latest。
--platform=all 打包所有支持的平台（或指定具体平台如 linux, win, macos）。
--output=myapp 输出文件名前缀，生成的文件将是 myapp_*.exe 或相应格式。

package.json的内容

{
  "name": "puppeteer-extra",
  "version": "1.0.0",
  "main": "dist/bundle.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "rollup --config rollup.config.mjs"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": "",
  "dependencies": {
    "browsers": "^1.0.2",
    "js-yaml": "^4.1.0",
    "puppeteer": "^23.6.0",
    "puppeteer-extra-plugin-recaptcha": "^3.6.8",
    "puppeteer-extra-plugin-stealth": "^2.11.2",
    "yarn": "^1.22.22"
  },
  "bin": {
    "your-app": "src/main.js"
  },
  "devDependencies": {
    "@rollup/plugin-commonjs": "^28.0.1",
    "@rollup/plugin-node-resolve": "^15.3.0",
    "electron": "^33.0.2",
    "electron-builder": "^25.1.8",
    "electron-packager": "^17.1.2",
    "puppeteer-core": "^23.6.0",
    "puppeteer-extra": "^3.3.6",
    "rollup": "^4.24.2",
    "webpack": "^5.95.0",
    "webpack-cli": "^5.1.4"
  },
  "build": {
    "appId": "com.example.yourapp",
    "productName": "YourApp",
    "win": {
      "target": "nsis"
    }
  },
  "pkg": {
    "scripts": [
      "node_modules/puppeteer-extra-plugin-stealth/**/*"
    ]
  }
}

注意事项

当打包私有依赖或非标准路径的资源时，可能需要在 package.json 的 pkg 配置中明确指定脚本和资产路径。
对于生产环境，考虑安全性需求，尤其是 macOS 上的代码签名要求。
跨平台打包可能需要额外的设置，比如在 Linux 上配置 QEMU 用于模拟其他架构。

使用 `pkg` 打包 Puppeteer

由于 Puppeteer 是一个庞大的 Node.js 库，并且包含二进制文件，它并不适合被打包到浏览器环境中。但是，如果你确实需要在浏览器环境中使用某些 Puppeteer 功能，你可以使用 puppeteer-core，它是 Puppeteer 的一个轻量级版本，不包含自动下载的浏览器。

在使用 pkg 打包包含 puppeteer-core 的项目时，你可能会遇到路径问题或序列化问题。为了解决这些问题，你可以在 pkg 命令中添加 --public 参数，这将帮助你正确地序列化传递的函数：

pkg index.js -t=win --public

–public很重要，不加上会出现下面的错误

 Passed function cannot be serialized!

如果在运行pkg时提示有下载fetched-v18.5.0-win-x64,网上的教程下载fetched-v18.5.0-win-x64都不对我花了2天时间都没有成功。后面来硬的，找人用科学上网下载成功了。

此外，确保你的 Puppeteer 配置正确，特别是 executablePath 参数，这将指向你的 Chrome 可执行文件路径。如果你在不同平台上打包，确保为每个平台指定正确的浏览器路径。

通过上述步骤，你可以成功地使用 pkg 打包你的 Node.js 项目，包括使用 Puppeteer 或 puppeteer-core 的应用。这将使你的应用在不同环境中更加易于部署和运行。