设置HTTPS服务器后Capacitor的@capacitor/app插件在Android上失效

问题分析 #

切换到HTTPS远程服务器后出现"App" plugin is not implemented on android错误，核心原因是androidScheme设为https时，Android系统会将应用的WebView识别为普通网页环境，跳过Capacitor的插件桥接初始化流程，导致原生插件无法被Web端调用。

解决方案 #

1. 调整Capacitor配置 #

修改capacitor.config.ts中的androidScheme为默认值capacitor，避免与系统HTTPS协议冲突：

server: {
  url: "https://test.example.tn",
  androidScheme: "capacitor", // 改回默认scheme
  cleartext: true
},

2. 重新同步并清理项目 #

执行以下命令确保配置和插件完全同步到Android项目，同时清理构建缓存：

# 同步Capacitor配置和插件
npx cap sync android

# 进入Android目录清理缓存
cd android && ./gradlew clean && cd ..

3. 验证AndroidManifest配置 #

打开android/app/src/main/AndroidManifest.xml，确认MainActivity的intent-filter包含Capacitor的scheme配置：

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="@string/custom_url_scheme" />
</intent-filter>

确保@string/custom_url_scheme对应的值为capacitor（可在android/app/src/main/res/values/strings.xml中查看）。

4. 重新构建并运行 #

使用Capacitor命令重新运行Android应用，确保加载最新配置：

npx cap run android

额外注意事项 #

• 如果使用自签名HTTPS证书，Android 7+设备需要手动安装证书或在项目中配置证书信任，否则WebView可能无法正常连接服务器，间接导致插件初始化失败。
• 无需手动修改MainActivity代码，BridgeActivity会自动注册所有已安装的Capacitor插件。

内容的提问来源于stack exchange，提问作者Charfeddine Mohamed Ali