PWAsForFirefox 命令行工具使用指南

PWAsForFirefox 命令行工具使用指南

PWAsForFirefox A tool to install, manage and use Progressive Web Apps (PWAs) in Mozilla Firefox 项目地址: https://gitcode.com/gh_mirrors/pw/PWAsForFirefox

项目概述

PWAsForFirefox 项目提供了一个名为 firefoxpwa 的命令行工具，用于在 Firefox 浏览器中安装、启动和管理渐进式 Web 应用（PWA）。相比浏览器扩展，命令行工具提供了更灵活的控制方式，适合高级用户和技术人员使用。

工具安装与基础使用

该命令行工具在安装时会自动添加到系统 PATH 环境变量中。要获取帮助信息，可以运行以下命令：

firefoxpwa --help
# 或查看特定命令的帮助
firefoxpwa <command> --help

项目还提供了多种 Shell 的自动补全支持，包括：

• Bash
• Elvish
• Fish
• PowerShell
• Zsh

注意：在 Windows 系统上，所有补全文件都安装在所选安装目录的 completions 子目录中，但需要手动加载到 Shell 中。使用 DEB、RPM 包或通过 Homebrew、Arch 安装时，Bash、Fish 和 Zsh 的补全会自动安装到正确位置。

运行时管理

安装运行时

要启动 Web 应用，首先需要安装 Firefox 运行时：

firefoxpwa runtime install

这个运行时与您的主 Firefox 安装完全分离，不会干扰其他 Firefox 实例。

Windows 用户注意：安装运行时需要 7-Zip 支持。安装过程会自动触发 7-Zip 安装程序（可能需要 UAC 确认）。安装完成后可以安全删除 7-Zip。

高级选项

您可以选择使用替代的 Firefox 版本或分支（如 LibreWolf、IceCat、Waterfox 等），但兼容性无法保证。

运行时维护

卸载运行时（将导致无法启动 Web 应用）：

firefoxpwa runtime uninstall

修补运行时（建议在安装自定义运行时后执行）：

firefoxpwa runtime patch

配置文件管理

Web 应用使用独立的配置文件系统，与普通 Firefox 配置文件隔离。这提高了可靠性并允许额外定制。

创建配置文件

firefoxpwa profile create --name 配置文件名称 --description "描述信息" --template 模板路径

参数说明：

• --name 和 --description 可选
• --template 允许基于现有配置创建新配置

最佳实践：使用模板时，确保源配置文件未运行，避免锁文件问题。

配置文件操作

列出所有配置文件：

firefoxpwa profile list

更新配置文件属性：

firefoxpwa profile update 配置文件ID --name 新名称 --description "新描述"

删除配置文件（不可逆操作）：

firefoxpwa profile remove 配置文件ID

注意：默认配置文件（ID为全零）无法完全删除，只能清空。

Web 应用管理

安装 Web 应用

firefoxpwa site install 清单URL --profile 配置文件ID

关键注意事项：

1. 不同 Web 应用不应使用相同名称
2. 同一配置文件中无法安装同一应用的多个实例
3. 要使用多账户，应为每个实例创建独立配置文件

应用维护

卸载应用：

firefoxpwa site uninstall 应用ID

更新应用（包括重新获取清单）：

firefoxpwa site update 应用ID --name 新名称 --description "新描述"

启动应用

基本启动：

firefoxpwa site launch 应用ID

高级启动选项：

• --url：使用自定义起始URL（可多次指定以打开多个标签页）
• --protocol：通过协议处理器启动（需应用支持）

技术细节与最佳实践

1. 数据隔离：Web 应用配置文件与主浏览器完全隔离，建议通过 Firefox 账户同步重要数据

2. 性能优化：为高频使用的应用创建独立配置文件可提高稳定性

3. 多账户管理：通过不同配置文件实现同一服务的多账户同时登录

4. 企业部署：可使用模板功能预配置企业标准环境

5. 调试技巧：在测试新应用时，建议先创建临时配置文件

通过掌握这些命令行工具的使用方法，您可以更灵活地管理和定制 Firefox 中的 PWA 应用体验，满足各种高级使用场景的需求。

PWAsForFirefox A tool to install, manage and use Progressive Web Apps (PWAs) in Mozilla Firefox 项目地址: https://gitcode.com/gh_mirrors/pw/PWAsForFirefox