SuperAPI AI 工具集

capacitor-compat

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:本技能用于在 Capacitor 的 iOS WKWebView 与 Android WebView 环境中编写兼容代码,避免依赖会静默失效的浏览器 API。

主要能力与限制:在 iOS WKWebView 中,以编程方式创建 <a download> 并点击无法触发文件下载,download 属性会被完全忽略;程序化点击 <a target="_blank"> 被阻止(原生应用没有标签页);window.open() 在没有用户手势上下文时可能被阻止或行为异常。更细的 Apple Lockdown Mode 限制需加载 lockdown-mode 技能。

必要用法:文件下载与打开 URL 应改用 src/lib/downloadFile.ts 中的工具,而非手动构造 anchor。downloadTextFile(filename, content) 在 Web 上使用 <a download>,在原生端通过 @capacitor/filesystem 写入缓存目录并用 @capacitor/share 调起原生分享面板;openUrl(url) 在 Web 上打开新标签页,在 Capacitor 上弹出原生分享面板。示例:import { downloadTextFile } from '@/lib/downloadFile'; await downloadTextFile('backup.txt', fileContents); 以及 import { openUrl } from '@/lib/downloadFile'; await openUrl('https://example.com/image.jpg');。切勿使用 document.createElement('a') 加 .click(),该写法在 iOS 上会静默失败。

平台检测:使用 @capacitor/core 的 Capacitor.isNativePlatform() 区分 iOS/Android 与 Web,仅在行为确有差异时(分享面板、安全存储、触觉反馈)做平台分支,多数 UI 代码应保持平台无关。

已装插件:@capacitor/app、@capacitor/core、@capacitor/filesystem、@capacitor/haptics、@capacitor/keyboard、@capacitor/local-notifications、@capacitor/share、@capacitor/status-bar、@capgo/capacitor-autofill-save-password、capacitor-secure-storage-plugin。增删插件后运行 npm run cap:sync 更新原生工程。其它细节资料未提供。