From 310fd066e91f454b990372ffa30e803cc8120975 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:56:40 +0100 Subject: unslug zh-cn: move --- .../package_your_extension_/index.html | 98 ++++++++++++++++++++++ .../porting_a_google_chrome_extension/index.html | 22 +++++ .../temporary_installation_in_firefox/index.html | 83 ++++++++++++++++++ 3 files changed, 203 insertions(+) create mode 100644 files/zh-cn/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html create mode 100644 files/zh-cn/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html create mode 100644 files/zh-cn/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html (limited to 'files/zh-cn/orphaned/mozilla/add-ons') diff --git a/files/zh-cn/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html new file mode 100644 index 0000000000..e7792b75d4 --- /dev/null +++ b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/package_your_extension_/index.html @@ -0,0 +1,98 @@ +--- +title: 发布你的附加组件 +slug: Mozilla/Add-ons/WebExtensions/Publishing_your_WebExtension +tags: + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/Package_your_extension_ +--- +
{{AddonSidebar}}
+ +

一般当你完成了基于WebExtension技术的附加组件的代码编写和测试, 你可能会想与其他人分享这成果(不管出于什么目的...). Mozilla旗下有一个网站: addons.mozilla.org (简称AMO), 开发者们可以在这里发布附加组件, 而其他用户可以在这里找到这些附加组件并安装使用, 通过在AMO上发布你的附加组件, 你可以加入到我们的社区里来, 这里有一群用户和创造者, 说不准会发现几个使用你的附加组件的人哦.

+ +

你编写的附加组件并不一定需要发布在AMO上， 但是、即使你不打算在AMO上发布你的附加组件, 你也必须提交你的附加组件到AMO上来进行审核以获得签名。因为火狐浏览器会拒绝安装没有AMO签名的附加组件。

+ +

所以发布一个附加组件的流程, 可概述为:

+ +
    +
  1. 压缩你所创建的附加组件文件
    2. +
  2. 在AMO上创建一个属于你的账户
    3. +
  3. 上传你的压缩文件到AMO来进行签名和审核, 并选择是否在AMO上进行发布
    4. +
  4. 修复在审核中发现的任何问题
    5. +
  5. 如果你选择不在AMO上发布, 可以恢复已签名的附件组件, 并自行发布
    6. +
+ +

当你准备发布附加组件的新版本时, 你可以访问 addons.mozilla.org 的附加组件页来更新它, 并上传新的版本.
+ 需要注意的是: 你必须在这个附加组件页进行更新, 否则AMO没法知道你是要更新一个已经存在的附加组件呢, 还是要上传一个全新的附加组件呢.

+ +

如果你选择在AMO上发布你的附加组件, 之后火狐浏览器会自动检查更新. 如果你选择自行发布,  你需要在你的manifest.json中手动设置一个applications 唯一标识, 并且需要手动设置update_url属性指向你的update manifest file.

+ +
+
+

火狐浏览器把附加组件包的后缀叫做或改为".xpi", 这只是".zip"的一个扩展.

+ +

在上传附加组件到AMO的时候, 你不需要把压缩包的后缀改为".XPI".

+
+
+ +

1. 使用zip压缩你的附加组件文件

+ +

首先你的附加组件文件夹应该包含一个manifest.json和其他一些需要的文件 - javascript文件, icons文件, HTML文件等等. 你需要使用zip把它们压缩成一个文件以便上传到AMO.

+ +

注意: 请将你的附加组件目录的的所有文件压缩为zip包,而 不要直接对附加组件根目录进行压缩(见下图所示).

+ +

Windows

+ +
    +
  1. 打开你的附加组件所在的文件夹.
    2. +
  2. 选中所有文件.
    3. +
  3. 右键并选择发送到 → 压缩到(zipped)文件夹.
    4. +
+ +

+ +

Mac OS X

+ +
    +
  1. 打开你的附加组件所在的文件夹.
    2. +
  2. 选中所有文件.
    3. +
  3. 右键并选择压缩n项.
    4. +
+ +

+ +

Linux / Mac OS X Terminal

+ +
    +
  1. cd path/to/my-addon/
    2. +
  2. zip -r ../my-addon.zip *
    3. +
+ +

2. 在AMO上创建一个账户

+ +

访问https://addons.mozilla.org/. 如果你已经有一个火狐账户, 你可以直接使用它来登录. 否则, 点击"注册"并按要求创建一个火狐账户.

+ +

3. 上传你的zip压缩文件

+ +

接下来, 上传压缩后的附加组件到AMO进行签名和审查, 并选择是否发布到AMO, 更多细节, 可查看Submitting to AMO.

+ +
+

需要注意的是一旦你上传了你的附加组件(基于WebExtension技术)到AMO, 你不能使用Add-on SDK或过时的XUL/XPCOM技术来更新该附加组件. 如果你切换到了这些技术平台之一, 必须把它做为新的附加组件并重新提交.

+ +

总而言之: 像Add-on SDK和XUL/XPCOM等过时的技术体系在不久的将来都将被淘汰, WebExtensions才是唯一.

+ +

在上传你的附加组件之前，请再次检查你的zip包内没有包含其他不相关的文件.

+
+ +

4. 修复审查中出现的问题

+ +

当你上传了附加组件, AMO服务器将运行一些基本的检查并立即通知你有关的一切问题. 这些问题分为2种类型: "错误"和"警告". 如果你有错误, 你必须修复它们并重新提交, 如果只是警告, 你最好也搞定它们(当可以也忽略警告): 然后可以继续提交.

+ +

如果自动检查器没有报告任何错误, 该附件组件将进行更为详细的审核(复查). 你同样会收到审查结果并且需要修复所有问题, 然后重新提交.

+ +

5. 发布你的附加组件

+ +

如果你选择了在AMO上托管你的附加组件, 这意味着发布过程的结束. AMO会对该附加组件进行签名和发布, 之后其他用户就能下载并安装使用了.

+ +

如果你选择不在AMO上进行发布, 可以恢复已签名的附加组件, 并自行发布(比如把附件组件的压缩包直接发给别人).

+ +

 

diff --git a/files/zh-cn/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html new file mode 100644 index 0000000000..496abe0bd3 --- /dev/null +++ b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/porting_a_google_chrome_extension/index.html @@ -0,0 +1,22 @@ +--- +title: 从 Google Chrome 移植 +slug: Mozilla/Add-ons/WebExtensions/Porting_from_Google_Chrome +tags: + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/Porting_a_Google_Chrome_extension +--- +
{{AddonSidebar}}
+ +

使用 WebExtension API 开发的扩展是专为跨浏览器兼容而设计的：很大程度上，该技术与 Google Chrome 和 Opera 支持的扩展 API 代码直接兼容。为这些浏览器编写的扩展，在大多数情况下，只需少数修改就能在 Firefox 中运行。几乎所有的扩展 API 都支持使用 chrome 命名空间下的回调函数，跟 Chrome 一样。那些仅有的 chrome 命名空间不支持的 API 是故意不与 Chrome 兼容的。这些情况下，API 文档页将明确声明它仅在 browser 命名空间中受支持。从 Chrome 或者 Opera 移植一个扩展的过程大概这样：

+ +
    +
  1. 检查你 manifest.json 使用的功能并了解 WebExtension API 对应的 Chrome 不兼容参考表。如果你在使用的功能或者 API 还未被 Firefox 支持，那你可能还不能移植你的扩展。Mozilla 提供了一个服务可助您自动执行此步：https://www.extensiontest.com/。
    2. +
  2. 安装你的扩展至 Firefox 并对其进行测试。
    3. +
  3. 如有任何问题，可通过 dev-addons 邮件列表或 IRC 上的 #webextensions 联系我们。
    4. +
  4. 提交您的附加组件至 AMO 以供签名及分发。
    5. +
+ +

如果您依赖 Chrome 命令行选项来加载解压的扩展，请参看 Firefox 中进行临时安装的 web-ext 工具以便开发。

+ + diff --git a/files/zh-cn/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html new file mode 100644 index 0000000000..654aaea253 --- /dev/null +++ b/files/zh-cn/orphaned/mozilla/add-ons/webextensions/temporary_installation_in_firefox/index.html @@ -0,0 +1,83 @@ +--- +title: 打包和安装 +slug: Mozilla/Add-ons/WebExtensions/Packaging_and_installation +translation_of: Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox +translation_of_original: Mozilla/Add-ons/WebExtensions/Packaging_and_installation +--- +

打包你的扩展

+ +

Firefox 扩展应打包为 XPI 文件。它只是一个 ZIP 文件，但采用 .xpi 作为扩展名。

+ +

最重要的一点，ZIP 文件必须是扩展文件的 ZIP 打包，不能包含一层根目录。

+ +

Windows

+ +
    +
  1. 打开你的扩展文件所在的文件夹。
    2. +
  2. 选择所有文件。
    3. +
  3. 右击并选择 发送到 → 压缩(zipped)文件夹。
    4. +
  4. 将得到的文件从 文件名.zip 重命名为 文件名.xpi。
    5. +
+ +

Screenshot of the Windows Explorer context menu showing Send to compressed (zipped) folder

+ +

Mac OS X

+ +
    +
  1. 打开你的扩展文件所在的文件夹。
    2. +
  2. 选择所有文件。
    3. +
  3. 右击并选择 压缩 n 项。
    4. +
  4. 将得到的文件从 Archive.zip 重命名为  文件名.xpi。
    5. +
+ +

Screenshot of the Finder context menu showing the Compress 15 Items option

+ +

Linux / Mac OS X 终端

+ +
    +
  1. cd path/to/my-extension/
    2. +
  2. zip -r ../my-extension.xpi *
    3. +
+ +

安装你的扩展

+ +
    +
  1. 导航到 about:addons
    2. +
  2. 拖拽 XPI 到页面上，或者打开齿轮菜单，选择“从文件安装附加组件...”
    3. +
  3. 点击弹出的对话框中的“安装”
    4. +
+ +

在 Firefox OS 上安装你的扩展

+ +

你可以使用 WebIDE 提供的 USB 或者 Wifi 进行安装

+ +

故障排除

+ +

下面是几种你可能会遇到的常见问题：

+ +

"此附加组件无法安装，因为它未经验证。"

+ + + +

"该附加组件无法安装，因为它似乎已损坏。"

+ + + +

完全没反应

+ + -- cgit v1.2.3-54-g00ecf