Android Setup

该插件是 Android-first 并执行本机 WebView 提供商版本检查。

Android 支持矩阵

• API 22+ (Android 5.1 或更高)
• Android 5-6 和 10+: Android System WebView 提供商
• Android 7-9: Google Chrome 提供商

默认行为 (主要用例)

默认模式是基于 Browserslist 的兼容性:

• minimumDeviceSharePercent 默认为 3
• 基于 caniuse 数据的 dataset 在构建时被打包
• 除非您设置了 runtime dataset URL 调用，否则不需要 dataset URL versionShareApiUrl

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    WebviewVersionChecker: {},
  },
};

export default config;

基本插件配置

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    WebviewVersionChecker: {
      autoPromptOnOutdated: true,
    },
  },
};

export default config;

高级阈值模式 (自定义数据集)

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    WebviewVersionChecker: {
      minimumDeviceSharePercent: 3,
      versionShareByMajor: {
        '137': 58.2,
        '136': 21.3,
        '135': 4.6,
        '134': 2.1,
      },
    },
  },
};

export default config;

versionShareByMajor explanation:

• key = 主 WebView 版本（例如 137)
• value = 分享百分比（0..100)
• minimumDeviceSharePercent: 3 表示“仅兼容当前主版本 >= 3% 在数据集中”

您还可以通过 versionShareApiUrl with：

• { "versionShareByMajor": { "137": 54.2, "136": 23.8 } }
• { "shareByMajor": { "137": 54.2, "136": 23.8 } }
• { "versions": [{ "major": 137, "share": 54.2 }, { "version": "136.0.0.0", "percent": 23.8 }] }

继续从 Android Setup

如果您正在使用 Android Setup 来规划原生媒体和界面行为，连接它 使用 @capgo/capacitor-webview-version-checker 为原生能力在使用 @capgo/capacitor-webview-version-checker 中 使用 @capgo/capacitor-live-activities 为原生能力在使用 @capgo/capacitor-live-activities 中 @capgo/capacitor-live-activities 为实现细节在 @capgo/capacitor-live-activities 中 使用 @capgo/capacitor-video-player 为原生能力在使用 @capgo/capacitor-video-player 中 @capgo/capacitor-video-player 为实现细节在 @capgo/capacitor-video-player 中