原生 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