打包你的扩展
Firefox 扩展应打包为 XPI 文件。它只是一个 ZIP 文件,但采用 .xpi
作为扩展名。
最重要的一点,ZIP 文件必须是扩展文件的 ZIP 打包,不能包含一层根目录。
Windows
- 打开你的扩展文件所在的文件夹。
- 选择所有文件。
- 右击并选择 发送到 → 压缩(zipped)文件夹。
- 将得到的文件从
文件名.zip
重命名为文件名.xpi
。
Mac OS X
- 打开你的扩展文件所在的文件夹。
- 选择所有文件。
- 右击并选择 压缩 n 项。
- 将得到的文件从
Archive.zip
重命名为文件名.xpi
。
Linux / Mac OS X 终端
cd path/to/my-extension/
zip -r ../my-extension.xpi *
安装你的扩展
- 导航到
about:addons
- 拖拽 XPI 到页面上,或者打开齿轮菜单,选择“从文件安装附加组件...”
- 点击弹出的对话框中的“安装”
在 Firefox OS 上安装你的扩展
你可以使用 WebIDE 提供的 USB 或者 Wifi 进行安装
故障排除
下面是几种你可能会遇到的常见问题:
"此附加组件无法安装,因为它未经验证。"
"该附加组件无法安装,因为它似乎已损坏。"
- 确保你是直接压缩你的附加组件文件,而不是压缩它们所在的文件夹。你的 manifest.json 文件必须在 zip 文件的根目录中。
- 确保你正在使用 Nightly 版本的 Firefox。
完全没反应
- 确保你的文件名称以
.xpi
结尾,因为某些操作系统可能会隐藏真实的文件扩展名。- 在 Windows 上,选中 查看 → 显示 / 隐藏:文件扩展名。
- 在 Mac OS X 上,选中 文件 → 获取信息 → 名称和扩展名。
- 还有一种可能,你不小心点击并因此驳回了安装提示。在 Nightly 中的后退按钮旁边找到一个拼图图标。点击它将重获这个弹出提示。