Chrome扩展Native Messaging疑问：宿主打包及Manifest V3配置问题

1. Native Host能否随Chrome扩展打包同步安装？ #

不行。Chrome扩展的安装包（.crx格式）仅支持包含网页资源、JS、CSS、图片等Web相关文件，Native Host的可执行程序（exe/二进制文件）无法打包进扩展。原因是Native Messaging依赖系统级的注册表（Windows）或配置文件（macOS/Linux）来让Chrome识别宿主程序的位置，这些注册操作必须在用户本地系统完成，无法通过扩展安装自动执行。

你需要单独打包Native Host的可执行文件和对应的注册配置文件，分发给对方后，指导他们完成本地安装和注册步骤（比如Windows下添加注册表项，macOS/Linux下把配置文件放到指定目录）。

2. Manifest V3的Native Messaging示例 #

直接上可运行的极简示例：

示例1：Manifest.json配置 #

{
  "manifest_version": 3,
  "name": "Native Messaging Demo",
  "version": "1.0",
  "background": {
    "service_worker": "background.js"
  },
  "host_permissions": [
    "nativeMessaging://com.yourcompany.nativehost"
  ],
  "action": {
    "default_popup": "popup.html"
  }
}

示例2：Service Worker（background.js）发送消息 #

// 连接Native Host并发送消息
async function sendMessageToNativeHost() {
  try {
    const port = chrome.runtime.connectNative('com.yourcompany.nativehost');
    port.postMessage({ text: 'Hello from extension!' });
    
    // 接收Native Host的响应
    port.onMessage.addListener((response) => {
      console.log('Received from native host:', response);
    });
    
    port.onDisconnect.addListener(() => {
      if (chrome.runtime.lastError) {
        console.error('Connection error:', chrome.runtime.lastError.message);
      }
    });
  } catch (err) {
    console.error('Failed to connect:', err);
  }
}

// 监听popup的调用
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  if (message.type === 'sendNativeMessage') {
    sendMessageToNativeHost();
    sendResponse({ status: 'Message sent' });
  }
});

示例3：Native Host注册文件（Windows版，com.yourcompany.nativehost.json） #

{
  "name": "com.yourcompany.nativehost",
  "description": "Sample Native Host",
  "path": "C:\\Path\\To\\Your\\NativeHost.exe",
  "type": "stdio",
  "allowed_origins": [
    "chrome-extension://<你的扩展ID>/"
  ]
}

3. Manifest V3中host_permissions配置Native Messaging的错误解决 #

常见错误多是格式不正确，正确配置需注意以下几点：

• 必须使用nativeMessaging://前缀：host_permissions里的条目格式为nativeMessaging://<Native Host的ID>，比如"nativeMessaging://com.yourcompany.nativehost"
• 不要重复在permissions里声明nativeMessaging：MV3中Native Messaging的权限已整合到host_permissions，无需单独在permissions数组里添加"nativeMessaging"
• Native Host ID必须和注册文件一致：确保host_permissions里的ID和Native Host注册文件中的name字段完全匹配
• 扩展ID必须在Native Host的allowed_origins中：注册文件里的allowed_origins要包含你的扩展ID（格式为chrome-extension://<扩展ID>/）

错误示例（会导致配置失败）：

// 错误：缺少nativeMessaging://前缀
"host_permissions": ["com.yourcompany.nativehost"]

// 错误：同时在permissions里声明nativeMessaging
"permissions": ["nativeMessaging"],
"host_permissions": ["nativeMessaging://com.yourcompany.nativehost"]

正确示例：

"host_permissions": [
  "nativeMessaging://com.yourcompany.nativehost"
]

内容的提问来源于stack exchange，提问作者Tian Qin