将 Chrome 扩展从 Manifest V2 更新到 Manifest V3 对于开发人员来说是关键的一步，因为 Google 已经逐步停止了对 Manifest V2 的支持。在本文中，我们将逐步介绍将最初使用 Manifest V2 构建的 Pomodoro Timer 扩展升级到更新的 Manifest V3 标准的过程。

我的故事

我有一个 4 年前免费制作的 Pomodoro Timer 扩展，我收到了 Google 的通知，要求我更新 Manifest。

我的番茄计时器的原始版本是我自己设计的，用霸王龙的咆哮作为周期结束通知？它既古怪又有趣，我什至惊讶地看到有 24 个人在使用它。

这就是它的样子：

我的妻子最近开始学习设计，由于我需要更新清单，我请她更新设计。结果在文章最后。剧透：我认为结果很棒。

为什么升级到 Manifest V3？

Manifest V3 引入了几项关键更改，旨在增强 Chrome 扩展程序的隐私性、安全性和性能。这些变化包括：

• Service Workers： 后台页面被 Service Worker 替换，因为它们不会连续运行，所以效率更高。
• 增强安全性：减少权限范围并引入 declarativeNetRequest API 来管理网络请求。
• 改进的性能：通过优化扩展程序与浏览器资源的交互方式，V3 确保更好的资源管理。

第 1 步：了解核心差异

在深入了解更新之前，了解 Manifest V2 和 V3 之间的关键变化非常重要：

1. 后台脚本：在V2中，后台脚本连续运行。在 V3 中，这些被替换为仅在需要时运行的 Service Worker。
2. 权限：Manifest V3 要求显式声明所有权限，某些权限已被弃用或替换。
3. API 更改： 一些 API 已被删除或替换，并且扩展的不同组件之间的消息传递系统已更新。

第2步：更新清单文件

以下是如何将 Pomodoro 计时器扩展的 manifest.json 文件从 V2 更新到 V3：

原始清单 V2 示例：

{
  "name": "Pomodoro Clock",
  "version": "1.1.0",
  "description": "Simple background timer for productivity",
  "manifest_version": 2,
  "permissions": ["storage"],
  "browser_action": {
    "default_popup": "popup.html",
    "default_icon": {
      "16": "img/tomato16.png",
      "32": "img/tomato32.png",
      "48": "img/tomato48.png",
      "128": "img/tomato128.png"
    }
  },
  "icons": {
    "16": "img/tomato16.png",
    "32": "img/tomato32.png",
    "48": "img/tomato48.png",
    "128": "img/tomato128.png"
  },
  "background": {
    "scripts": ["background.js"]
  },
  "options_page": "options.html"
}

更新了 Manifest V3 示例：

{
  "name": "Pomodoro Timer & Focus Clock",
  "version": "2.0.1",
  "description": "Boost productivity with this simple Pomodoro timer. Focus on tasks, minimize distractions, and manage your time effectively.",
  "manifest_version": 3,
  "permissions": ["storage","notifications","alarms"],
  "action": {
    "default_popup": "popup.html",
    "default_icon": {
      "16": "img/tomato16.png",
      "32": "img/tomato32.png",
      "48": "img/tomato48.png",
      "128": "img/tomato128.png"
    }
  },
  "icons": {
    "16": "img/tomato16.png",
    "32": "img/tomato32.png",
    "48": "img/tomato48.png",
    "128": "img/tomato128.png"
  },
  "background": {
    "service_worker": "background.js"
  }
}

清单中的主要变化：

后台脚本：

• V2: "background": {"scripts": ["background.js"]}
• V3: "background": {"service_worker": "background.js"}

在 V3 中，后台脚本被 Service Worker 替换。 Service Worker 仅在必要时运行，提高资源效率。

操作与浏览器操作：

• V2: "browser_action": { ... }
• V3: "动作": { ... }

browser_action 已被 action 取代，这巩固了功能并简化了清单。

步骤 3：更新后台脚本以使用 Service Worker

我的扩展在后台使用了一个简单的 setInterval() ，对于服务工作者，此行为将不起作用，因为为了节省浏览器资源，它仅在需要时运行。

在我的例子中，我必须修改计时器并将时间戳存储在存储中，使用警报来安排通知调用者的触发代码运行。

当然，使用chrome的内置通知来发送通知，以摆脱烦人的霸王龙后方。如果我的扩展的早期用户阅读了我的内容，我真的很抱歉？

这里不会有代码示例，因为它太具体了。

结论

结果如下。我觉得这很酷。简约且易于使用

更新并没有那么困难，主要是了解旧的后台脚本和服务工作者之间的区别，但是要小心警报，我什至在测试时使 Chrome 崩溃了几次？

随意尝试更新的番茄钟计时器和焦点时钟扩展，祝您更新成功！