本文介绍通过自定义 uri scheme 实现外部浏览器操作完成后自动唤醒 android 应用并接收回调，无需用户手动切回，彻底消除流程中断，提升用户体验。
本文介绍通过自定义 uri scheme 实现外部浏览器操作完成后自动唤醒 android 应用并接收回调，无需用户手动切回，彻底消除流程中断，提升用户体验。
在 Android 开发中，当应用跳转至外部浏览器（如 Chrome）完成授权、支付或 OAuth 流程后，常需通过回调 URL 返回应用。但若此时 App 已退至后台，仅靠普通 Intent 启动无法保证前台恢复，导致页面“卡住”，必须用户手动切换——这严重损害体验。解决方案并非引入 WebSocket 或通知监听器，而是利用 Android 原生的 App Links / Custom Scheme + onNewIntent 机制，实现真正无缝唤起。
✅ 正确做法：自定义 Scheme + 深度链接唤醒
1. 配置 AndroidManifest.xml 中的 Intent Filter
为接收回调，需声明一个专属 Scheme（如 myapp），禁止使用 http:// 或 https://（易被系统拦截或交由浏览器处理）：
<activity android:name=".MainActivity" android:exported="true"><!-- 主启动入口 --><intent-filter><action android:name="android.intent.action.MAIN"></action><category android:name="android.intent.category.LAUNCHER"></category></intent-filter><!-- 关键：用于接收回调的自定义 Scheme --><intent-filter android:autoverify="true"><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></intent-filter></activity>
⚠️ 注意：android:exported="true" 在 Android 12+ 是必需项；android:autoVerify="true" 可选（用于验证 HTTPS App Links），但自定义 Scheme 无需验证。
2. 构造带回调地址的浏览器 Intent
启动外部浏览器时，将自定义回调地址作为参数传递（部分 SDK 或网页端会读取 Referer 或 redirect_uri，此处以通用方式显式传入）：
String callbackUrl = "myapp://callback?token=abc123&state=xyz";
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://example.com/auth?redirect_uri=" + Uri.encode(callbackUrl)));
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setPackage("com.android.chrome"); // 可选：指定 Chrome，避免弹出选择框
try {
context.startActivity(intent);
} catch (ActivityNotFoundException e) {
// Chrome 未安装，降级使用系统浏览器
intent.setPackage(null);
context.startActivity(intent);
}
✅ 网页端需正确解析并重定向至 myapp://callback?... —— 这是唤醒 App 的关键触发点。
3. 在 Activity 中捕获回调数据
当回调 URL 被触发时，系统会创建新任务或复用现有任务，并调用对应 Activity 的生命周期方法：
- 若 App 完全关闭 → onCreate() 中通过 getIntent().getData() 获取；
- 若 App 已在后台运行 → onNewIntent() 被调用，必须在此处更新 Intent 并处理数据：
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
setIntent(intent); // 必须调用，确保 getIntent() 返回最新 Intent
handleCallback(intent);
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
handleCallback(getIntent()); // 处理首次启动时的回调
}
private void handleCallback(Intent intent) {
Uri data = intent.getData();
if (data != null && "myapp".equals(data.getScheme())) {
String token = data.getQueryParameter("token");
String state = data.getQueryParameter("state");
Log.d("Callback", "Received token: " + token + ", state: " + state);
// ✅ 此处可解析参数、更新 UI、跳转页面、触发网络请求等
// 示例：跳转至结果页
Intent resultIntent = new Intent(this, ResultActivity.class);
resultIntent.putExtra("token", token);
resultIntent.putExtra("state", state);
startActivity(resultIntent);
finish(); // 可选：关闭当前 Activity
}
}
4. 补充说明与最佳实践
- 不推荐 FLAG_ACTIVITY_NEW_TASK 单独使用：它仅保证新任务栈，但无法保证前台显示；真正唤醒依赖 Scheme 匹配与系统调度。
- 避免 startActivityForResult()：该 API 已废弃（AndroidX 中被 registerForActivityResult 替代），且对外部浏览器无效——浏览器不属于你的进程，无法返回 Result。
-
测试建议：
- 使用 adb shell am start -W -a android.intent.action.VIEW -d "myapp://callback?test=1" com.yourpackage 模拟回调；
- 在 Chrome 中访问 myapp://callback?...，验证是否自动拉起 App。
- 安全提醒：自定义 Scheme 存在劫持风险（其他 App 可注册相同 Scheme），生产环境建议结合 android:exported="false" + Intent 显式 Component 启动，或升级为 Android App Links（基于 HTTPS + 数字资产链接验证）。
通过以上配置，用户在浏览器完成操作后，点击“完成”或页面自动跳转 myapp://callback，系统将立即拉起你的 App 并传递参数，整个过程无感知、零手动切换，真正实现闭环体验。
