新闻资讯
GEEKAT JOURNAL

浏览器插件从开发到发布到 Chrome、Edge 商店

本文是一篇面向独立开发者、软件团队与企业发布者的实用教程。本文以 Chromium 系浏览器扩展(Chrome / Microsoft Edge)为主,平台政策和后台操作可能调整,实际以官方最新页面为准。

日常使用浏览器时,我们经常会遇到各种“小而具体”的需求:保存完整网页、管理多个标签页、自动填充表单、对比网页改版前后的差异,或者把当前网页内容发送到笔记软件。很多时候,为这些需求单独开发一个网站或桌面程序并不合适,而 浏览器插件(Browser Extension) 就是一种很自然的解决方式。

浏览器插件可以直接融入浏览器,在用户访问网页时提供额外功能。它既可以是简单的一键操作按钮,也可以拥有侧边栏、独立管理页面、右键菜单和自动化能力。对于独立开发者或小型团队,它也是一种开发和分发成本相对较低的软件产品形态。

本文首先介绍浏览器插件的技术特点和应用场景,再以 Chrome Web Store 和 Microsoft Edge Add-ons 为例,梳理从工程准备、企业账号注册、商店提交到后续版本更新的完整流程,并重点说明权限、隐私和企业主体变更等容易忽略的问题。

一、浏览器插件是什么?

浏览器插件通常也叫浏览器扩展。它是在浏览器提供的扩展机制和权限边界内运行的一组程序,可以在浏览器界面或网页上增加原本没有的功能。

与普通网页不同,扩展可以在获得相应授权后使用浏览器提供的 API,例如读取当前标签页的信息、显示通知、创建右键菜单、保存本地数据,或者与当前网页交互。但它并不是“拥有浏览器全部权限”的程序:不同能力需要声明不同权限,并受到浏览器安全模型与商店政策限制。

常见应用场景包括:

类型 典型功能 适用人群
效率工具 标签页管理、待办事项、快捷操作 普通用户、办公人员
内容收藏 网页剪藏、长截图、书签分类 写作者、研究人员
开发者工具 JSON 格式化、接口调试、网页检查 前后端开发者
设计工具 颜色拾取、字体识别、截图对比 设计师、产品经理
工作流辅助 表单填充、站内操作辅助 运营、客服、企业团队
无障碍与阅读 阅读模式、文字辅助、界面优化 广泛用户群体

以 PageJelly 为例:它帮助网站创作者保存不同版本的网页界面,支持网页发现、截图、版本归档与历史对比。这种功能需要与当前浏览器页面紧密配合,因此很适合以扩展形式交付。

浏览器插件与网站、桌面软件有什么不同?

  • 网站适合提供完整的在线业务和跨设备服务,但不一定方便访问浏览器标签页或当前页面的内容。
  • 桌面软件可以深度使用本地系统资源,适合复杂文件处理或常驻任务,但安装、更新和跨平台适配成本通常更高。
  • 浏览器插件贴近用户正在浏览的页面,安装轻量、使用路径短,适合清晰、聚焦的增强功能;但受权限、浏览器生命周期和商店政策约束。

如果产品的核心交互是“用户打开网页后,点击一下就完成某个操作”,插件往往是值得优先考虑的载体。反之,如果需要浏览器关闭后持续运行、长时间后台爬取或复杂系统级访问,仅靠插件可能并不合适。

二、浏览器插件的基本技术结构

Chrome 和 Edge 都基于 Chromium,扩展通常使用 HTML、CSS、JavaScript 或 TypeScript 开发。当前新项目一般应采用 Manifest V3(MV3)。

一个典型工程可能包含:

终端窗口
my-extension/
├── manifest.json # 扩展元信息、权限和入口
├── popup.html # 点击浏览器工具栏图标出现的弹窗
├── popup.js
├── background.js # 后台 Service Worker
├── content.js # 按需注入网页的内容脚本
├── options.html # 可选:设置页面
└── icons/
├── 16.png
├── 48.png
└── 128.png

其中,manifest.json 是扩展最重要的配置文件。下面是一个仅用于解释结构的简化示例(不是可直接上线的完整产品):

{
"manifest_version": 3,
"name": "Example Extension",
"version": "1.0.0",
"description": "A simple browser extension example.",
"action": { "default_popup": "popup.html" },
"background": { "service_worker": "background.js" },
"permissions": ["storage", "activeTab"],
"icons": { "16": "icons/16.png", "48": "icons/48.png", "128": "icons/128.png" }
}

开发时尤其需要理解三类运行环境:

  1. 扩展页面(如 popup、options、side panel):展示用户界面,并可调用被授权的扩展 API。
  2. Content Script:在网页上下文附近运行,用于读取或操作页面 DOM,但与网页脚本之间存在隔离机制。
  3. Service Worker:承担事件驱动的后台逻辑;MV3 的 Worker 不是传统常驻进程,可能被浏览器暂停或终止,不能依赖它永久运行。

同一套 Chromium 扩展源码通常可以兼容 Chrome 和 Edge,但应分别测试 API、权限提示、运行行为与商店要求,不能仅凭“同内核”就假定完全兼容。

三、发布前应该准备什么?

浏览器扩展上架不是简单上传一个 ZIP。发布者需要同时准备程序、商店资料、开发者账号和合规说明。

1. 完成扩展工程与测试

在本地先完成以下验证:

  • 在 Chrome 的 chrome://extensions 和 Edge 的 edge://extensions 开启开发者模式,加载解压后的扩展目录。
  • 验证主要功能、异常提示和权限授权流程。
  • 检查首次安装、浏览器重启、页面刷新、插件重新加载后的行为。
  • 检查桌面端与不同分辨率下的界面显示;必要时验证多语言。
  • 针对登录后页面、特殊网站、数据量较大等场景进行边界测试。
  • 确认没有调试代码、无用权限、明文密钥或不必要的第三方跟踪组件。

特别注意:扩展的“开发者模式可加载”不代表“符合商店审核要求”。商店还会检查扩展的实际用途、权限、数据使用、代码和展示资料。

2. 打包扩展

商店上传的通常是 .zip,而不是包含 README、测试代码、Git 历史、开发文档的完整源码仓库压缩包。假设项目已经构建出 dist/:

终端窗口
# 在项目根目录构建
npm run build
# 将 dist 内部文件打包;manifest.json 必须在 ZIP 根目录
cd dist
zip -r ../my-extension.zip .
cd ..
# 可选:检查打包内容
unzip -l my-extension.zip | head -30

正确的 ZIP 结构示例:

my-extension.zip
├── manifest.json
├── popup.html
├── background.js
└── icons/...

不应多包一层 dist/ 目录,导致 manifest.json 不在 ZIP 根目录。上传前还应确认 manifest.json 的版本号是将要发布的版本;更新时版本号需要递增。

3. 准备商店资料

建议提前准备:

  • 扩展名称、简短介绍、详细功能描述和适当的分类。
  • 统一的图标,以及能够展示真实操作的产品截图。
  • 如有需要,准备宣传图、演示视频和中英文商店文案。
  • 产品官网、技术支持邮箱、帮助文档及隐私政策链接。
  • 对审核员有用的测试步骤;如果必须登录才能验证功能,提供专门的测试账号,不要提供真实用户的凭证。

Chrome 的商店截图常用规格是 1280×800 或 640×400;可选的小型宣传图为 440×280,大型 Marquee 宣传图为 1400×560。Edge 的素材要求应以提交表单和官方文档为准。不要把精美的品牌宣传图当作真实功能截图,最好两类素材都准备。

四、注册 Chrome Web Store 开发者账号

Chrome Web Store 要求发布者先注册开发者账号,并支付一次性注册费;具体支付金额和可用支付方式以注册页面实际显示为准。完成注册后,并不是每发布一个插件都需要再缴一次注册费。

基本流程:

  1. 准备长期使用的 Google 账号,建议专门用于公司软件发布。
  2. 进入开发者控制台,同意协议并完成一次性注册费支付。
  3. 配置开发者名称、联系邮箱等发布者信息,完成平台要求的账号验证。
  4. 启用 Google 账号两步验证,这是发布和更新扩展的要求。
  5. 如使用公司官网,可以根据官方指引验证网站所有权,提升发布者信息的可信度。
  6. 点击 Add new item,上传扩展 ZIP。
  7. 完成 Store Listing、Privacy、Distribution、Test instructions 等栏目。
  8. 提交审核,审核通过后自动或手动发布。

Chrome 支持按可见性分发:Public(公开)、Unlisted(不公开展示但持链接可安装)、Private(限定测试用户)。这些选项都需要遵守商店政策,也都会经过审核。首次发布时也可以考虑使用延期发布,等待审核通过后自行选择上线时间。

有一个容易被忽略的细节:Chrome Web Store 开发者账号创建后不能直接更换其注册邮箱。如果必须更换,通常需要新建账号并申请转移扩展。因此,公司发布账号要考虑长期可控性,避免依赖某位员工的私人邮箱。

五、注册 Microsoft Edge Add-ons 开发者账号

Microsoft Edge 扩展通过 Microsoft Partner Center 发布。根据微软官方文档,Edge 扩展开发者注册目前免费,并支持 **Individual(个人)**与 **Company(企业)**两类账号。

基本流程:

  1. 准备 Microsoft Account(MSA),用于登录 Partner Center。
  2. 注册 Microsoft Edge 开发者计划。
  3. 选择账号类型:个人开发者选 Individual;企业名义发布选 Company。
  4. 企业账号按正式登记资料填写公司名称、地址、联系方式和授权审核人。
  5. 按要求完成身份、域名或企业真实性验证。
  6. 验证通过后,在 Partner Center 创建新的扩展项目。
  7. 上传 ZIP,填写 Availability、Properties、Privacy、Store Listings 和认证测试说明。
  8. 提交认证;审核通过后按配置发布。

企业账号的验证通常比个人账号复杂。微软可能核对营业执照、企业名称和地址、域名归属及授权人信息。企业账号类型在注册后不能随意切换,因此如果确定以公司名义发布,建议一开始就选择 Company。

此外,Edge 扩展开发者账号需要 MSA 作为主要所有者;企业账号也可以在后续增加团队成员和权限管理。

六、权限、隐私与安全:最重要的审核要点

插件能够访问用户正在浏览的内容,天然比普通静态网页更敏感。发布者应遵守“目的明确、权限最小、数据透明、用户可控”的原则。

1. 只申请必要权限

不同 API 对应不同权限:例如存储设置可能需要 storage,用户主动操作当前标签页可以考虑 activeTab,特定网页访问能力可能涉及 host_permissions。不要为了省事就默认申请所有网站的长期访问权限。

如果确实需要 debugger、cookies、tabs 等较敏感的权限,应明确描述业务必要性,向用户提示,并在 Chrome 的 Privacy 表单及 Edge 的相应栏目中作出解释。

像 PageJelly 这样的网页截图工具,应重点说明:为什么需要捕获网页、是否读取页面内容、什么时候触发截图,以及截图的保存和删除方式。

2. 本地存储也需要隐私说明

“数据不上传云端”是有价值的隐私设计,但并不意味着插件不会接触敏感信息。保存的截图可能包含姓名、订单、后台业务数据或其他私密内容。

隐私政策至少应说明:

  • 插件处理哪些数据(如 URL、网页内容、截图、版本元数据)。
  • 数据用于哪些功能,是否上传服务器或分享给第三方。
  • 本地存储位置、保留方式、删除和导出办法。
  • 如何利用已有登录会话,以及是否保存用户名、密码或令牌。
  • 第三方 SDK、统计与崩溃报告(如有)。
  • 用户如何联系开发者,隐私政策何时更新。

隐私政策必须和实际代码行为及商店后台的隐私声明一致。即使确实不上传任何数据,也应该清楚地解释本地处理方式,而不是笼统写“我们不收集任何信息”。

3. 遵守 MV3 代码与审核要求

Manifest V3 对远程托管和执行代码有限制。扩展的核心逻辑应能被商店审核人员从提交包中理解和检查,不能依赖偷偷加载的远程脚本绕开审核。

除此以外,还需要注意:

  • 不要宣传未实现的功能,不要使用误导性截图和虚假评价。
  • 不要未经授权收集账号密码、浏览历史或其他用户数据。
  • 避免在网页中意外触发表单提交、购买、删除等副作用。
  • 不要把真实密钥、私人凭证或企业内部数据写进插件安装包。
  • 如果扩展需要账号或特定业务环境,提供可供审核的测试流程。

对权限较强的插件,发布前做一次权限与隐私专项审查,往往比只检查界面更重要。

七、一个源码仓库,如何同时发布 Chrome 和 Edge?

推荐维护一个 Git 仓库、一个主要扩展工程、两个商店发布条目。

Git 仓库
└── 源码与文档
├── 自动化测试
└── 构建脚本
└── dist/(可安装的扩展目录)
├── Chrome Web Store → 上传 ZIP
└── Edge Add-ons → 上传 ZIP

典型发布步骤:

  1. 修改源码并运行测试;在 Chrome、Edge 分别验证。
  2. 更新 manifest.json 中的版本号,并维护更新日志。
  3. 构建并从 dist/ 生成 ZIP。
  4. 给代码打 Git Tag,例如 v1.0.0,保留构建包与发布记录。
  5. 分别在 Chrome 和 Edge 后台上传扩展包,填写各自需要的说明。
  6. 提交审核;通过后检查商店页面、安装链接和升级行为。

如果同一个包在两家商店都兼容,就可以复用;一旦出现平台 API 差异,应在构建流程中引入平台适配层,而不是直接复制出两份长期独立维护的代码。

建议区分两种 ZIP:

  • 源码包:供开发者阅读、测试、修改,通常包括 src/、docs/、tests/ 等。
  • 扩展发布包:只保留浏览器运行所需文件,解压后可在开发者模式下加载,亦可上传商店。

八、插件上线后的更新与维护

发布完成并不代表工作结束。浏览器不断更新,商店政策、页面权限和浏览器 API 也可能变化。

建议建立固定的版本发布流程:

  • 使用 Git Tags 和 CHANGELOG.md 记录每次版本修改。
  • 每次升级都递增 manifest.json 的版本号。
  • 对权限新增、数据处理方式变化等事项进行重点复查。
  • 保留自动化测试与手工回归测试用例。
  • 定期处理用户反馈、兼容性问题和安全漏洞。
  • 在官网持续提供产品文档、支持渠道和隐私政策。

Chrome 和 Edge 商店均支持对已发布条目上传新版本。上架后的普通用户通常通过商店管理的扩展更新机制获得升级;不需要每次手动下载新的 ZIP。

长期看,可以进一步使用 CI/CD 自动执行测试和生成发行包,甚至使用官方发布 API 自动提交部分流程。但首次上架建议先手动走完一遍,弄清每个平台的资料要求与审核反馈,再逐步自动化。

九、公司名义发布,需要特别注意什么?

对于准备长期运营多个软件产品的公司,发布者账号是一项重要资产。建议尽早规范管理。

企业账号与品牌名称

公司法定名称和产品品牌可以不同。例如,开发者法律主体是“广州极客艾特计算机系统有限公司”,产品品牌是“GeekAt”,某个具体扩展叫“PageJelly”。

在商店后台应根据具体字段区分法律主体名称、发布者展示名称、产品名称。尤其是 Edge Company 账号,正式登记名称和企业验证资料必须准确一致;不能假定所有展示字段都能自由使用英文品牌名称。

公司迁址、更名是否需要重新注册?

假设企业从广州迁移到深圳,并且通过市场监管部门办理的是同一法律主体的住所和名称变更,而不是注销后重新设立另一家公司:

  • Chrome:正常情况下可保留原开发者账号和已发布扩展;一次性开发者注册费通常不因名称、地址变更而重复收取。需要更新平台保存的资料,涉及已核验法律信息的应向官方确认是否重新验证。
  • Edge:Partner Center 支持企业法律信息变更,微软可能对新名称、地址和联系人重新核验;通常不需要为了同一主体的变更另建开发者账号。

保留营业执照、变更登记文件、原公司与新公司名称的连续性证明、统一社会信用代码等材料,可以降低沟通成本。

如果注销旧公司、注册新公司,则是另一种情况,可能涉及扩展所有权转移或重新建立开发者关系,不应直接当作普通地址变更处理。具体仍应以平台审核结果为准。

企业账号安全建议

  • 使用公司可长期控制的发布账号,启用多因素认证。
  • 将账号、商店条目、域名及应急恢复信息纳入企业资产台账。
  • 避免把唯一管理员账号长期绑定在离职员工的私人联系方式上。
  • 通过官方团队协作或权限管理功能授权成员,尽量不共享密码。
  • 留存商店条目 ID、产品 URL、注册凭证、历史发布记录和关键支持工单。

十、浏览器插件发布检查清单

首次提交前,可以逐项核对:

  • 使用 Manifest V3,扩展可在 Chrome / Edge 正常加载。
  • 功能、登录态、浏览器重启及异常场景已实际测试。
  • 扩展 ZIP 根目录包含 manifest.json,且版本号正确。
  • 已审查并移除多余权限、密钥、调试代码及不必要的外部依赖。
  • 已准备真实产品截图、图标、商店描述和技术支持入口。
  • 隐私政策公开可访问,并与真实数据处理行为一致。
  • 公司或个人账号信息准确,已完成必需的验证。
  • Chrome 开发者账号已启用两步验证。
  • 已为需要登录的功能准备安全的审核测试方案。
  • 已分别在两家商店完成隐私、权限及分发声明。
  • 已记录提交版本、商店条目 ID、Git Tag 和后续更新责任人。

结语

浏览器插件是一种贴近用户真实操作场景的软件形态。它不要求开发者从零搭建完整的在线服务,也未必需要云服务器;一个聚焦的问题、一套清晰的交互和合理的浏览器权限,就可能形成有价值的工具。

但发布插件的门槛不仅在于编码。企业身份、账号安全、安装包规范、权限最小化、隐私透明和长期维护,同样决定了产品能否获得用户和商店的信任。

对于准备同时进入 Chrome Web Store 和 Microsoft Edge Add-ons 的开发者,最有效的做法通常是:一套源码、两家商店、统一品牌、分别审核、持续维护。先把功能和合规基础做好,再逐步扩展更多浏览器与自动化发布流程。


参考资料

商店政策与界面可能更新,实际操作时请再次核对。

  1. Google Chrome — Register your developer account
  2. Google Chrome — Prepare your extension
  3. Google Chrome — Publish in the Chrome Web Store
  4. Google Chrome — Fill out the privacy fields
  5. Google Chrome — Creating a great listing page
  6. Google Chrome — Developer Program Policies
  7. Google Chrome — Set up distribution
  8. Microsoft Edge — Register as an extension developer
  9. Microsoft Edge — Publish a Microsoft Edge extension
  10. Microsoft Edge — Verify your company account

本文为技术与平台发布流程介绍,不构成法律意见。企业登记、税务和数据合规的特殊问题,应结合实际业务与当地法规另行确认。

← 返回新闻资讯
欢迎来到极客艾特
✳ SMART TECH, TRUE VALUE.

让智能技术
回归价值本质.

你好,我们是极客艾特。
从一块电路板到一款软件,用扎实的工程能力,把有意思的想法做成有用的产品。

了解我们的能力
智能硬件开发数字化产品构建技术培训与教育
GEEKAT · CN