@Capacitor/App-launcher打开网页而非应用问题求助

API 探路者

2026-7-8

问题原因及解决方案

核心问题是你直接传入Android应用包名给AppLauncher.openUrl，但Capacitor的openUrl方法要求传入的是URL Scheme、Android App Link或符合Intent规范的URL，而非单纯的包名。直接传包名会被Capacitor识别为相对路径，自动拼接成http://localhost/[包名]，因此才会打开网页而非目标应用。

解决步骤

1. 配置Android包可见性（Android 11+ 必需）

Android 11及以上版本限制了应用对其他应用的可见性，需在android/app/src/main/AndroidManifest.xml中添加<queries>标签，声明要启动的应用包名，否则canOpenUrl可能返回false：

<manifest ...>
    <!-- 其他原有配置 -->
    <queries>
        <package android:name="com.android.calendar" />
        <package android:name="com.google.android.youtube" />
        <package android:name="com.android.deskclock" />
    </queries>
</manifest>

2. 使用正确的URL格式调用`openUrl`

针对Android应用，需使用Intent格式的URL指定要启动的应用包名，示例代码如下：

打开日历应用

import { AppLauncher } from '@capacitor/app-launcher';

async function openCalendar() {
  // 采用Android Intent格式URL
  const intentUrl = 'intent://#Intent;package=com.android.calendar;end';
  const { value } = await AppLauncher.canOpenUrl({ url: intentUrl });
  
  if (value) {
    await AppLauncher.openUrl({ url: intentUrl });
  } else {
    console.log('无法打开日历应用');
  }
}

打开YouTube应用

async function openYoutube() {
  const intentUrl = 'intent://#Intent;package=com.google.android.youtube;end';
  const { value } = await AppLauncher.canOpenUrl({ url: intentUrl });
  
  if (value) {
    await AppLauncher.openUrl({ url: intentUrl });
  } else {
    console.log('无法打开YouTube应用');
  }
}