Ionic/Capacitor项目获取Android第三方应用Intent传递数据的咨询

原理说明 #

1. appUrlOpen事件、getLaunchUrl()方法仅响应携带URI数据的Intent拉起场景，你当前第三方应用用putExtra附加的是Intent自定义额外参数，不属于URI范畴，所以官方API不会返回对应数据。
2. 你当前的intent-filter配置错误：自定义Scheme的data标签和ACTION_MAIN的启动配置放在同个intent-filter块中，不会被系统识别为有效的深度链接入口。

解决方案 #

优先推荐第一种跨平台通用的URL Scheme方案，第二种为适配现有第三方应用不变更代码的原生扩展方案。

方案一：使用URL Scheme传参（推荐，跨Android/iOS通用） #

步骤1：修正AndroidManifest.xml配置

在现有MainActivity的配置块中，新增单独的深度链接intent-filter：

<activity
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode"
    android:name="com.myapp.appname.MainActivity"
    android:label="@string/title_activity_main"
    android:theme="@style/AppTheme.NoActionBarLaunch"
    android:launchMode="singleTask">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <!-- 新增深度链接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" />
        <!-- 这里scheme替换为你自己的自定义协议，比如myapp -->
        <data android:scheme="myapp" />
    </intent-filter>
</activity>

步骤2：修改第三方应用拉起代码

把原本putExtra的参数拼到URI中：

Intent intent = getPackageManager().getLaunchIntentForPackage("com.myapp.appname");
if (intent != null) {
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    // 把参数拼到自定义URI中，注意参数值要做URL编码
    intent.setData(Uri.parse("myapp://transfer?company_uuid=test%201&job_no=JN1234"));
    startActivity(intent);
} else {
    intent = new Intent(Intent.ACTION_VIEW);
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    intent.setData(Uri.parse("market://details?id=" + "com.myapp.appname"));
    startActivity(intent);
}

步骤3：Capacitor端接收参数

可以直接用官方App插件的API获取并解析参数：

import { App } from '@capacitor/app';
import { useHistory } from 'react-router-dom';
import { useEffect } from 'react';

const AppUrlListener: React.FC<any> = () => {
  const history = useHistory();

  // 解析URL参数的工具方法
  const parseUrlParams = (url: string) => {
    const urlObj = new URL(url);
    return {
      companyUuid: urlObj.searchParams.get('company_uuid'),
      jobNo: urlObj.searchParams.get('job_no')
    };
  };

  useEffect(() => {
    // 处理应用冷启动时的拉起参数
    const getLaunchParams = async () => {
      const res = await App.getLaunchUrl();
      if (res?.url) {
        const params = parseUrlParams(res.url);
        console.log('冷启动拿到参数', params);
        // 业务逻辑处理
      }
    };
    getLaunchParams();

    // 处理应用在后台时的拉起参数
    const listener = App.addListener('appUrlOpen', (data) => {
      const params = parseUrlParams(data.url);
      console.log('后台唤醒拿到参数', params);
      // 业务逻辑处理
    });

    return () => {
      listener.remove();
    };
  }, [history]);

  return null;
};

export default AppUrlListener;

方案二：原生适配自定义Extra参数（无需修改第三方应用代码） #

如果无法变更第三方应用的拉起逻辑，只能接收putExtra传递的参数，可以通过扩展MainActivity实现参数透传：

步骤1：修改MainActivity.java代码

import android.content.Intent;
import android.os.Bundle;
import com.getcapacitor.BridgeActivity;

public class MainActivity extends BridgeActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        dispatchIntentExtras(getIntent().getExtras());
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        dispatchIntentExtras(intent.getExtras());
    }

    // 把Extra参数通过自定义事件发给Web层
    private void dispatchIntentExtras(Bundle extras) {
        if (extras == null || bridge == null) return;
        String companyUuid = extras.getString("COMPANY_UUID", "");
        String jobNo = extras.getString("JOB_NO", "");
        // 构造事件数据，注意特殊字符转义
        String eventData = String.format("{\"companyUuid\":\"%s\",\"jobNo\":\"%s\"}",
                companyUuid.replace("\"", "\\\""),
                jobNo.replace("\"", "\\\""));
        // 触发Web层的自定义JS事件
        bridge.getWebView().post(() -> {
            bridge.triggerJSEvent("intentExtrasReceived", "window", eventData);
        });
    }
}

步骤2：Capacitor端监听自定义事件

useEffect(() => {
  const handleExtras = (e: any) => {
    const { companyUuid, jobNo } = e.detail;
    console.log('收到Intent额外参数', companyUuid, jobNo);
    // 业务逻辑处理
  };
  window.addEventListener('intentExtrasReceived', handleExtras);
  return () => {
    window.removeEventListener('intentExtrasReceived', handleExtras);
  };
}, []);

注意事项 #

• 方案一为跨平台通用方案，iOS端仅需配置对应的URL Scheme即可复用完全相同的TS代码，适配成本最低。
• 方案二仅适用于Android平台，如果后续要适配iOS还需要单独实现iOS端的原生参数透传逻辑。

内容的提问来源于stack exchange，提问作者DougB