本文介绍如何通过自定义 uri scheme 实现：当应用处于后台时，外部浏览器完成操作后自动拉起应用并传递回调数据，无需用户手动切换，从而实现无缝体验。
本文介绍如何通过自定义 uri scheme 实现：当应用处于后台时，外部浏览器完成操作后自动拉起应用并传递回调数据，无需用户手动切换，从而实现无缝体验。
在 Android 开发中，常见场景如 OAuth 登录、支付跳转或第三方授权，需从 App 启动外部浏览器（如 Chrome），待用户在网页端完成操作后，再安全、自动地返回 App 并携带结果。但若仅使用 Intent.ACTION_VIEW 打开网页，系统默认不会主动唤醒你的 App —— 用户必须手动切回，导致流程中断、体验割裂。
根本解法是利用 Android 的 Intent 深度链接（Deep Link）机制，配合自定义 Scheme（而非 http:// 或 https://），让浏览器在回调时触发系统唤起你的 App，并将数据带回。该方案无需 WebSocket、后台服务或通知栏提醒，轻量、标准、兼容性好（Android 4.1+ 均支持）。
✅ 正确配置：声明自定义 Scheme
在 AndroidManifest.xml 中，为接收回调的 Activity 添加如下
<intent-filter><action android:name="android.intent.action.VIEW"></action><category android:name="android.intent.category.DEFAULT"></category><category android:name="android.intent.category.BROWSABLE"></category><data android:scheme="myapp"></data><!-- 替换为你的唯一 scheme，如 mybank、payflow --></intent-filter>
⚠️ 注意事项：
- scheme 必须全部小写，且避免与通用协议（如 http, https, file）冲突；
- 不要添加 android:host（如 127.0.0.1），否则仅匹配特定 host，无法被浏览器识别回调；
- 确保该 Activity 的 launchMode 为 singleTask 或 singleTop，以便复用实例并正确接收 onNewIntent()。
✅ 发起跳转：携带回调地址
启动浏览器前，构造含 referrer 的 Intent，显式告知目标页面“完成后的跳转地址”（部分 Web SDK 如 OAuth 2.0 授权服务器会读取 Referer 或 redirect_uri，因此需确保前端配置一致）：
String callbackUrl = "myapp://callback";
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(exe)); // exe 是目标网页 URL
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setPackage("com.android.chrome"); // 可选：指定 Chrome（需用户已安装）
intent.putExtra(Intent.EXTRA_REFERRER, Uri.parse(callbackUrl)); // 关键：声明 referrer
try {
context.startActivity(intent);
} catch (ActivityNotFoundException e) {
// Chrome 未安装时降级使用系统浏览器
intent.setPackage(null);
context.startActivity(intent);
}
? 补充说明：Intent.EXTRA_REFERRER 并非强制生效，真正决定唤起行为的是网页端发起的 window.location.href = "myapp://callback?code=abc" 或 。因此，请务必与前端同学协同，确保服务端或 JS 代码中重定向 URL 使用你声明的 myapp:// 协议。
✅ 处理回调：在 Activity 中捕获数据
当浏览器触发 myapp://callback?param=value 时，系统会拉起你的 Activity（若已在后台，则调用 onNewIntent()；若未启动，则走 onCreate()）。需同时覆盖两个入口：
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
handleIntent(getIntent()); // 处理首次启动
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
setIntent(intent); // 必须更新 intent，否则 getIntent() 仍返回旧值
handleIntent(intent);
}
private void handleIntent(Intent intent) {
Uri data = intent.getData();
if (data != null && "myapp".equals(data.getScheme())) {
String code = data.getQueryParameter("code");
String state = data.getQueryParameter("state");
// ✅ 解析回调参数，执行登录/支付验证等逻辑
processCallback(code, state);
}
}
✅ 进阶建议（提升健壮性）
- 状态校验：在跳转前生成随机 state 参数并持久化（如 SharedPreferences），回调时比对，防止 CSRF；
- 超时控制：启动浏览器后启动 Handler 倒计时（如 30s），若未收到回调则提示用户重试；
- 多进程兼容：若 App 启用多进程，onNewIntent() 不会跨进程触发，此时需改用 BroadcastReceiver 或 LocalBroadcastManager 中转；
-
Android 12+ 限制：自定义 Scheme 在 Android 12（API 31）起受 Package Visibility 影响，需在 AndroidManifest.xml 中声明
：
<queries><intent><action android:name="android.intent.action.VIEW"></action><data android:scheme="myapp"></data></intent></queries>
通过以上三步（声明 Scheme → 携带回调跳转 → 捕获并解析 Intent），即可彻底消除用户手动切回 App 的步骤，实现真正的“后台自动唤起 + 数据回传”，大幅提升流程闭环率与用户体验一致性。
