"use client"; /** * PwaInstallOverlay PWA 安装提示触发器 * * 行为: * - 等聊天消息数量达到触发阈值后才开始检查 * - 检查 PWA 支持(pwaUtil.isSupported) * - 检查 PWA 是否已安装(pwaUtil.isInstalled)—— 已安装则不弹 * - 检查是否已经显示过(使用 AppStorage 持久化) * - 延迟后弹出 PwaInstallDialog * - 生产环境有效;开发环境 1s 后立即弹出(测试用) * * 注意:PWA install prompt API(`beforeinstallprompt`)在浏览器差异较大, * 本轮仅实现"显示时机"逻辑,具体 install prompt 调用由 Dialog 内部处理。 */ import { useEffect } from "react"; import { canShowPwaInstallPromptOnce, recordPwaInstallPromptShown, } from "@/lib/chat/pwa_install_prompt"; import { pwaUtil } from "@/utils"; import { PwaInstallDialog } from "./pwa-install-dialog"; import styles from "./pwa-install-overlay.module.css"; const DEVELOPMENT_DIALOG_DELAY_MS = 1000; const PRODUCTION_DIALOG_DELAY_MS = 1500; export interface PwaInstallOverlayProps { enabled: boolean; } export function PwaInstallOverlay({ enabled }: PwaInstallOverlayProps) { useEffect(() => { if (!enabled) return; let mounted = true; let timer: number | undefined; let unsubscribe: (() => void) | undefined; const init = async () => { // const isDev = AppEnvUtil.isDevelopment(); const isDev = false; // 提前挂 beforeinstallprompt 监听,避免用户点 OK 时事件已在更早时机丢失。 pwaUtil.prepareInstallPrompt(); const tryScheduleDialog = async () => { const shouldShowDialog = await shouldShowPwaInstallDialog(isDev); if (!mounted || !shouldShowDialog || timer !== undefined) return; // 达到聊天数量阈值后稍作停顿,避免弹窗与消息刷新挤在同一瞬间。 const delay = isDev ? DEVELOPMENT_DIALOG_DELAY_MS : PRODUCTION_DIALOG_DELAY_MS; timer = window.setTimeout(() => { if (!mounted) return; showPwaDialog(); }, delay); }; await tryScheduleDialog(); unsubscribe = pwaUtil.subscribe(() => { void tryScheduleDialog(); }); }; void init(); return () => { mounted = false; unsubscribe?.(); if (timer !== undefined) window.clearTimeout(timer); }; }, [enabled]); return