让它可安装

目标： 一个不仅能被安装，还会在恰当时机邀请安装、且启动体验接近原生的应用。 满足标准是地板；本指南覆盖地板，再覆盖之上的体验。

若尚未达到可安装的地板，请先做入门再回到这里。

步骤

1. 确认已满足标准。 有效的清单、安全来源、带 fetch 处理器的已注册 Service Worker， 以及所需的图标尺寸。完整门槛见安装参考。

2. 刻意选择显示模式。 standalone 隐藏浏览器外壳以获得类应用框架；minimal-ui 保留细窄控制条；browser 留在标签页内。按 display 参考选择，并在 清单显示兼容性数据中验证你想要的模式在目标平台上被遵守。

3. 设置 scope 与起始 URL。 scope 限定哪些 URL 在已安装应用内打开；start_url 是启动落点。把它们配置正确，避免应用泄漏到浏览器标签页——见 scope 参考与 scope 兼容性。

4. 捕获并延迟安装提示。 在会触发 beforeinstallprompt 的引擎上，存下该事件， 并从用户手势呈现你自己的安装入口，而不是仅由默认界面驱动。机制见 安装提示参考；引擎覆盖见 安装提示兼容性数据。

5. 显式处理 iOS。 Safari 不触发 beforeinstallprompt；用户通过 分享 → 添加到主屏幕安装。检测 iOS 并展示量身定制的说明，而非一个什么都不做的按钮。 见 iOS / Safari 平台说明。

6. 安装后再互动。 安装后，角标可把用户拉回。在依赖它之前先在 角标兼容性数据中确认支持，并在合适处与 通知搭配。

设计安装时机

首屏即弹出的提示转化很差。要赢得安装：

• 等待信号 —— 在用户做出表明意图的动作后再提供安装。
• 说明价值 —— 告诉他们安装能带来什么（离线、主屏图标），而不只是安装二字。
• 尊重拒绝 —— 若被拒绝，不要立即再次询问。

下一步

• 离线策略 —— 已安装的应用以离线韧性受评判。
• 性能 —— 启动应当感觉即时。
• 安装参考 —— 权威标准。

← 返回指南总览。