原生 manifest

原生消息清单

原生消息清单是一个文件，其名称与扩展程序传递到 runtime.connectNative() 或 runtime.sendNativeMessage() 的字符串匹配，并带有 .json 扩展名。它包含一个具有以下属性的 JSON 对象：

例如，这是 原生消息示例 中 ping_pong 原生应用程序的 ping_pong.json 清单文件的内容：

{
  "name": "ping_pong",
  "description": "Example host for native messaging",
  "path": "/path/to/native-messaging/app/ping_pong.py",
  "type": "stdio",
  "allowed_extensions": ["ping_pong@example.org"]
}

这允许 ID 为 ping_pong@example.org 的扩展程序通过将名称 ping_pong 传递给相关的 runtime API 函数进行连接。原生应用程序位于 /path/to/native-messaging/app/ping_pong.py。

托管存储清单

托管存储清单是一个文件，其名称与扩展程序的 browser_specific_settings 键中指定的 ID 匹配，并带有 .json 扩展名。它包含一个具有以下属性的 JSON 对象：

例如，在 favourite-colour 示例 中，托管存储数据设置在名为 favourite-colour-examples@mozilla.org.json 的文件中，该文件包含：

{
  "name": "favourite-colour-examples@mozilla.org",
  "description": "ignored",
  "type": "storage",
  "data": {
    "color": "management thinks it should be blue!"
  }
}

然后，favourite-colour-examples@mozilla.org 扩展程序使用如下代码访问数据：

let storageItem = browser.storage.managed.get("color");
storageItem.then((res) => {
  console.log(`Managed color is: ${res.color}`);
});

PKCS #11 清单

PKCS #11 清单是一个文件，其名称与 PKCS #11 模块的名称（如 pkcs11 API 中使用）匹配，并带有 .json 扩展名。它包含一个具有以下属性的 JSON 对象：

例如

{
  "name": "my_module",
  "description": "My test module",
  "type": "pkcs11",
  "path": "/path/to/libpkcs11testmodule.dylib",
  "allowed_extensions": ["my-extension@mozilla.org"]
}

给定此 JSON 清单，保存为 my_module.json，my-extension@mozilla.org 扩展程序可以使用如下代码安装位于 /path/to/libpkcs11testmodule.dylib 的安全模块：

browser.pkcs11.installModule("my_module");

清单位置

在 Linux 和 macOS 上，您需要将清单存储在特定位置。在 Windows 上，您需要创建一个指向清单位置的注册表项。

详细规则对所有清单类型都相同，只是路径的倒数第二个组件标识了清单的类型。以下示例显示了三种不同类型的清单的格式。在所有示例中，<name> 是原生清单中 name 属性的值。

Windows

为了全局可见性，请创建一个具有以下名称的注册表项：

HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\NativeMessagingHosts\<name>

HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\ManagedStorage\<name>

HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\PKCS11Modules\<name>

该键应该有一个默认值，即清单的路径。

为了用户可见性，请创建一个具有以下名称的注册表项：

HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\<name>

HKEY_CURRENT_USER\SOFTWARE\Mozilla\ManagedStorage\<name>

HKEY_CURRENT_USER\SOFTWARE\Mozilla\PKCS11Modules\<name>

该键应该有一个默认值，即清单的路径。

macOS

为了全局可见性，请将清单存储在：

/Library/Application Support/Mozilla/NativeMessagingHosts/<name>.json

/Library/Application Support/Mozilla/ManagedStorage/<name>.json

/Library/Application Support/Mozilla/PKCS11Modules/<name>.json

为了用户可见性，请将清单存储在：

~/Library/Application Support/Mozilla/NativeMessagingHosts/<name>.json

~/Library/Application Support/Mozilla/ManagedStorage/<name>.json

~/Library/Application Support/Mozilla/PKCS11Modules/<name>.json

Linux

为了全局可见性，请将清单存储在以下任一位置：

/usr/lib/mozilla/native-messaging-hosts/<name>.json

/usr/lib/mozilla/managed-storage/<name>.json

/usr/lib/mozilla/pkcs11-modules/<name>.json

or

/usr/lib64/mozilla/native-messaging-hosts/<name>.json

/usr/lib64/mozilla/managed-storage/<name>.json

/usr/lib64/mozilla/pkcs11-modules/<name>.json

为了用户可见性，请将清单存储在：

~/.mozilla/native-messaging-hosts/<name>.json

~/.mozilla/managed-storage/<name>.json

~/.mozilla/pkcs11-modules/<name>.json