This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/packaging.html
Title: 打包 - Google Chrome 扩展程序开发文档(非官方中文版)  •  Size: 24332

打包

这一页面描述如何将您的扩展程序打包。如概述中所述,扩展程序打包为已签名的 ZIP 文件,文件扩展名为“crx”,例如 myextension.crx

注意:您通常不需要为您的扩展程序打包。如果您使用 Chrome 开发者信息中心发布扩展程序,那么您不需要创建自己的 .crx 文件,除非您需要发布一个非公开版本,例如用于测试人员。您可以在 Chrome 网上应用店的入门教程中从步骤 5:为您的应用创建 ZIP 文件(英文)这一部分开始,找到发布扩展程序和应用的有关信息。

当您为扩展程序打包时,扩展程序将获得唯一的密钥对,扩展程序的标识符基于公钥的散列,私有密钥用来为每一个版本的扩展程序签名,必须严格保护,不能由公众访问。注意千万不要将您的私有密钥包含在扩展程序中!

创建包

要为扩展程序打包:

  1. 进入以下URL,打开扩展程序管理页面:
    chrome://extensions
  2. 确保右上角的开发者模式复选框已选中。
  3. 单击打包扩展程序按钮,出现一个对话框。
  4. 扩展程序根目录字段中,指定扩展程序所在文件夹的路径,例如,C:\myext。(忽略其他字段,您第一次为一个扩展程序打包时不需要指定私有密钥文件。)
  5. 单击打包扩展程序。打包程序将创建两个文件:一个 .crx 文件,是实际的可安装的扩展程序;另一个是 .pem 文件,包含私有密钥。

不要丢失私有密钥!确保 .pem 文件保密,并存放在安全的地方。如果您今后需要做如下事情,您需要这一文件:

如果扩展程序打包成功,您会看到如下对话框,告诉您 .crx 文件与 .pem 文件的位置:

更新扩展程序

要创建您的扩展程序的更新版本:

  1. 增加 manifest.json 中的版本号。
  2. 进入如下 URL,打开扩展程序管理页面: chrome://extensions
  3. 单击打包扩展程序按钮,出现一个对话框。
  4. 扩展程序根目录字段中指定扩展程序所在文件夹,例如 C:\myext
  5. 私有密钥文件字段中,指定已生成的用于该扩展程序的 .pem 文件位置,例如 C:\myext.pem
  6. 单击打包扩展程序

如果已更新的扩展程序打包成功,您将会看到如下对话框:

将已经打包的扩展程序上传到 Chrome 网上应用店

您可以使用 Chrome 开发者信息中心来上传您之前自己打包的扩展程序。然而,除非您进行特别的处理,Chrome 网上应用店中的扩展程序标识符将与您创建的扩展程序包不同。如果您已经发布了扩展程序包,不同的标识符可能会出问题,因为这样将允许用户安装您的扩展程序的多个版本,分别具有单独的本地数据。

如果您希望保持扩展程序的标识符不变,请遵循以下步骤:

  1. 将您创建 .crx 文件时生成的私有密钥文件重命名为 key.pem
  2. key.pem 文件放在您的扩展程序根目录中。
  3. 将这一目录压缩为 ZIP 文件。
  4. 使用 Chrome 开发者信息中心上传 ZIP 文件。

在命令行中打包

为扩展程序打包的另一种方式是在命令行中执行 chrome.exe(在 Linux 或 Mac OS X 上为 chrome)。使用 --pack-extension 参数指定扩展程序所在文件夹的位置,使用 --pack-extension-key 指定扩展程序私有密钥文件的位置。例如:

chrome.exe --pack-extension=C:\myext --pack-extension-key=C:\myext.pem

扩展程序包的格式和脚本

有关格式的更多信息以及您可以用来创建 .crx 文件的脚本,请参见 CRX 包的格式