OpenCode AI e9899d2e6d
Some checks failed
Android CI Build / check (push) Has been cancelled
Android CI Build / package-apks (push) Has been cancelled
Docs Deploy / build (push) Has been cancelled
Module Market Check / Validate modules/ (push) Has been cancelled
Module Market Publish / Generate submissions.json (push) Has been cancelled
Docs Deploy / deploy (push) Has been cancelled
Initial DruksCode V2: fresh fork of web-to-app (f3b488e) with DruksCode identity
- Package rename com.webtoapp -> br.com.drukstech.codeapp
- Product rename WebToApp/web-to-app -> DruksCode/drukscode
- Design system Wta* -> Dkc*
- applicationId br.com.drukstech.codeapp (.play for gplay flavor)
- rootProject.name DruksCode
- Fresh git history (upstream kept as remote for sync)
2026-09-12 02:42:02 +02:00

51 lines
3.5 KiB
Markdown

# 特殊设置
兼容性 polyfill、桥接和其他专门开关。这张卡片汇集了专门的 `WebViewConfig` 选项。
**位置:**[编辑通用配置](/zh/guide/app-actions/edit-common-config/)编辑器中的 **特殊设置** 卡片。
## Polyfill 与桥接
- **剪贴板 polyfill** —— `enableClipboardPolyfill`。
- **通知 polyfill** —— Web Notification 支持(`enableNotificationPolyfill`)。
- **方向 polyfill** —— `enableOrientationPolyfill`。
- **兼容 polyfill** —— 一组兼容 shim(`enableCompatPolyfills`)。
- **原生桥** —— 暴露带能力门控的原生桥(`enableNativeBridge`、`nativeBridgeCapabilities`)。
- **打印桥** —— 拦截 `window.print()` 和 PDF 输出到 Android 打印框架(`enablePrintBridge`)。
- **媒体会话桥** —— 把网页媒体接入系统媒体通知和锁屏控制,支持蓝牙耳机和 Android Auto(`enableMediaSession`)。
- **分享桥** —— `enableShareBridge`。
- **缩放 polyfill** —— `enableZoomPolyfill`。
## 媒体与内容
- **媒体自动播放** —— 带范围(`mediaAutoplayEnabled`、`mediaAutoplayScope`:仅视频……)。
- **图片修复** —— 修复损坏的图片(`enableImageRepair`)。
- **滚动记忆** —— 记住滚动位置(`enableScrollMemory`)。
- **返回状态保留** —— `enableBackStatePreservation`。
- **Blob 下载拦截** —— 带范围和大小阈值(`enableBlobDownloadInterception`、`blobInterceptThresholdMb`)。
## JavaScript 与窗口
- **JS 可打开窗口** —— 带策略(`javaScriptCanOpenWindows`、`jsOpenWindowsPolicy`)。
- **预置用户激活** —— 合成用户手势,带模式和时机(`primeUserActivation`、`primeUserActivationMode`、`primeUserActivationTiming`)。
- **Base64 深度链接** —— 解码 base64 深度链接,仅手势或总是(`decodeBase64DeepLinks`、`decodeBase64Mode`)。
## 安全与其他
- **跨源隔离** —— `enableCrossOriginIsolation`。
- **防截屏** —— 阻止屏幕截取(`antiCapture`)。
- **视频全屏时隐藏状态栏** —— 网页视频进入 HTML5 全屏播放时强制隐藏状态栏,退出全屏后恢复(`hideStatusBarInVideoFullscreen`,默认开启)。视频全屏期间优先于[全屏模式](/zh/guide/app-actions/edit-common-config/fullscreen)中的"全屏显示状态栏"选项。
- **文件 URL 的文件访问** —— `allowFileAccessFromFileURLs`、`allowUniversalAccessFromFileURLs`。
- **错误页** —— 自定义错误页配置(`errorPageConfig`)。
- **性能优化** —— `performanceOptimization`。
- **PWA 离线** —— 离线缓存策略(`pwaOfflineEnabled`、`pwaOfflineStrategy`)。
- **浮动返回按钮** —— `showFloatingBackButton`。
- **键盘调整模式** —— `keyboardAdjustMode`(resize……)。在 Android 10 及以下,RESIZE 模式走经典窗口缩放路径(窗口非 edge-to-edge),键盘可可靠地压缩内容。
- **全屏视频方向** —— 全屏视频如何转向(`fullscreenVideoOrientation`),如自动传感器横屏。
- **隐藏 URL 预览** —— `hideUrlPreview`。
## 说明
- 这些是高级用户开关;大多数应用保持默认即可。
- **默认值:**以下安全体验特性对新应用默认**开启**——剪贴板/方向/兼容 polyfill、媒体会话、分享、缩放与打印桥、图片修复、滚动记忆、返回状态保留、Blob 拦截、JS 窗口、用户激活预置、Base64 深链、私网桥和原生桥。刻意保持**关闭**:通知 polyfill(否则每个导出包都会弹通知权限)、定位、混合内容、第三方 Cookie、自动播放和弹窗拦截。