框架
工作流
开发服务器

启动开发服务器

完成项目设置后,通过导航到项目目录并运行以下命令开始开发扩展:

pnpm dev
# 或者
npm run dev
# 或者
plasmo dev

Plasmo 将为您的扩展创建一个开发包,并启动一个实时重新加载的开发服务器。每当文件发生变化时,它会自动更新扩展包,并在源代码更改时重新加载浏览器。此外,它会在扩展名称前加上 DEV |,并将图标变为灰度,以区分开发和生产环境的扩展包。

加载扩展

我们计划在未来实现自动化,但目前需要按照以下步骤将扩展加载到 Chrome 中。

转到 chrome://extensions 并启用开发者模式。

启用开发者模式

点击“加载已解压的扩展”并导航到扩展的 build/chrome-mv3-dev(或 build/chrome-mv3-prod)目录。

要查看弹出窗口,请点击 Chrome 工具栏上的拼图图标,然后点击您的扩展。

提示: 通过点击固定按钮,将扩展固定到 Chrome 工具栏以方便访问。

固定弹出窗口

指定目标

使用 Plasmo 构建时,您构建的是一个 Plasmo 扩展,而不是 Chrome 或 Firefox 扩展。这意味着您可以构建一个适用于所有支持浏览器的单一扩展,只需进行少量调整。您可以使用 --target 标志指示 Plasmo 为特定浏览器和清单版本构建扩展:

plasmo dev --target=firefox-mv2

最终的包将位于 build/firefox-mv2-dev 目录中。

有关官方支持的目标列表,请访问此链接

禁用sourcece-maps

默认情况下,Plasmo 在开发期间为您的扩展生成sourcece-maps。如果需要禁用此功能,可以使用 --no-source-maps 标志:

plasmo dev --no-source-maps

当您有与sourcece-maps不兼容的依赖项时,这非常有用。

指定主机名和端口

开发服务器默认绑定到 localhost 和端口 1012。您可以使用 --serve-host--serve-port 更改这些设置:

plasmo dev --serve-host=localhost --serve-port=1012

同样,默认情况下,热模块重载 WebSocket 绑定到 localhost 和端口 1815,构建报告器绑定到 HMR 套接字 + 1(默认为 1816)。您可以使用 --hmr-host--hmr-port 更改这些设置:

plasmo dev --hmr-host=localhost --hmr-port=1815