本插件开发文档翻译于Google官方文档Chrome Extension development basics - Chrome Developers
一、插件开发
hello-world插件开发的具体流程如下:
-
创建目录
hello-world, 存放源代码 -
在此目录中创建一个名为
manifest.json的新文件并添加以下代码:注意:必须将
manifest.json文件放在扩展的根目录中。{ "manifest_version": 3, "name": "Hello Extensions", "description": "Base Level Extension", "version": "1.0", "action": { "default_popup": "hello.html", "default_icon": "hello_extensions.png" } }这个JSON对象描述了扩展的功能和配置。例如,“action”键声明了Chrome应该用作扩展的操作图标的图像,以及单击扩展的操作图标时在弹出窗口中显示的超文本标记语言页面。将图标下载到您的目录,并确保更改其名称以匹配“
default_icon”键中的内容。 -
对于弹出窗口,创建一个名为
hello. html的文件,并添加以下代码:<html> <body> <h1>Hello Extensions</h1> </body> </html>现在,当单击扩展的操作图标(工具栏图标)时,扩展会显示一个弹出窗口。让我们通过在本地加载它来Chrome测试它。确保所有文件都已保存。
插件开发源码链接
二、加载未打包的扩展
在开发人员模式下加载解压的扩展:
-
通过在新选项卡中输入
chrome://扩展进入扩展页面。(也可以通过单击扩展菜单拼图按钮,然后选择菜单底部的管理扩展等方式进入扩展页面)
-
通过单击开发人员模式旁边的切换开关启用开发人员模式,然后单击按钮
加载已解压的扩展程序并选择扩展目录。![(img-mxKLW5PU-1689431402825)(images/image-20230715214720459.png)]](https://img-blog.csdnimg.cn/3a0b95ea44a64751b33a6ba9b6eace88.png)
扩展程序已成功安装。由于
manifest.json中没有包含扩展程序图标,因此将为扩展程序创建一个通用图标。
三、插件使用结果
单击扩展程序的操作图标(工具栏图标), 会看到一个弹出窗口 。 弹出窗口的内容为hello. html文件里面的内容。
默认情况下,当您在本地加载扩展时,它会出现在扩展菜单中。将您的扩展固定到工具栏可以在开发过程中快速访问您的扩展。
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-lfNdJboy-1689431402826)(images/image-20230715215142561.png)]](https://img-blog.csdnimg.cn/ed9f659dfe594e4f86c30bda89b8f5ed.png)
四、重新加载扩展程序
修改manifest.json的代码并将扩展的名称更改为“Hello Extension of the world!”
{
"manifest_version": 3,
"name": "Hello Extensions of the world!",
...
}
保存文件后,要在浏览器中查看此更改,您还必须刷新扩展。转到扩展页面并单击开/关切换旁边的刷新图标:
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-SKUGxyFS-1689431402826)(images/image-20230715215731661.png)]](https://img-blog.csdnimg.cn/9286b266b1da46fa9f19a25d29a14c27.png)
刷新扩展后,重新加载扩展程序的结果如下:
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-abDFm6TG-1689431402826)(images/image-20230715220013349.png)]](https://img-blog.csdnimg.cn/43027cfe707943f5b8dd80712df737fb.png)
并非所有组件都需要重新加载才能查看所做的更改,如下表所示:
| Extension component | Requires extension reload |
|---|---|
| The manifest | Yes |
| Service worker | Yes |
| Content Scripts | Yes (plus the host page) |
| The popup | No |
| Options page | No |
| Other extension HTML pages | No |
五、查找控制台日志和错误日志
5.1 Console logs
在开发过程中,您可以通过访问浏览器控制台日志来调试代码。在这种情况下,我们将找到弹出窗口的日志。首先向hello. html添加脚本标记。
<html>
<body>
<h1>Hello Extensions</h1>
<script src="popup.js"></script>
</body>
</html>
然后,创建一个popup.js文件并添加以下代码
console.log("This is a popup!")
注意,由于此时添加了Content Scripts这部分内容, 需要重新加载扩展程序
要查看控制台中记录的此消息,具体步骤为:
- 打开弹出窗口。
- 右键单击弹出窗口。
- 选择检查。
- 在DevTools中,浏览器会自动导航到控制台面板。
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-6nSmRwdq-1689431402827)(images/image-20230715221138648.png)]](https://img-blog.csdnimg.cn/5ef8a4cdab294c65aa5bb957761c41ed.png)
5.2 Error logs
在popup.js文件中添加一段错误的代码:
console.log("This is a popup!) //broken code
转到扩展页面并打开弹出窗口, 将出现一个错误按钮。
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ZIPi9nwW-1689431402827)(images/image-20230715221618754.png)]](https://img-blog.csdnimg.cn/e3634b8946974f50abf3a864aa2f2930.png)
单击错误按钮可以了解有关错误的更多信息:
![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8WLnoG4W-1689431402827)(images/image-20230715221705966.png)]](https://img-blog.csdnimg.cn/e1040c3b08f14ded87477b62a661dd0c.png)
要了解有关service worker, options page, and content scripts 的更多信息,可以查阅Debugging extensions.。



















