Android Wear OS如何在配对iPhone上触发Safari打开验证URL？

核心问题原因 #

Wear OS与iPhone配对时，无法通过自定义Intent Action或URL前缀直接触发Safari，所有跨设备交互需通过Google Wear iOS应用中转，必须遵循Google定义的跨平台Intent规范。

正确实现步骤 #

1. 配置必要权限 #

在AndroidManifest.xml中添加远程Activity权限：

<uses-permission android:name="com.google.android.wearable.permission.REMOTE_ACTIVITY" />

2. 构造标准可浏览Intent #

使用Intent.ACTION_VIEW搭配标准HTTPS URL，添加CATEGORY_BROWSABLE确保Intent可被浏览器处理，无需自定义safari-https://前缀：

val authUrl = "https://your-validation-url.com"
val intent = Intent(Intent.ACTION_VIEW).apply {
    data = Uri.parse(authUrl)
    addCategory(Intent.CATEGORY_BROWSABLE)
    // 无需指定包名，RemoteActivityHelper会自动适配iOS中转逻辑
}

3. 调用RemoteActivityHelper并处理回调 #

通过RemoteActivityHelper启动远程Activity，同时监听回调排查问题：

val remoteActivityHelper = RemoteActivityHelper(context)
remoteActivityHelper.startRemoteActivity(intent, object : RemoteActivityCallback() {
    override fun onSuccess(intentSender: IntentSender?) {
        // 成功发起跨设备请求，等待iPhone端响应
    }

    override fun onFailure(errorCode: Int) {
        // 根据错误码定位问题：
        // ERROR_UNSUPPORTED_INTENT: Intent格式不被支持，检查URL和Category
        // ERROR_DEVICE_UNAVAILABLE: iPhone未配对或离线
        // ERROR_REMOTE_APP_UNAVAILABLE: Google Wear iOS应用未安装或版本过低
        Log.e("RemoteActivity", "启动失败，错误码：$errorCode")
    }
})

关键注意事项 #

• 必须使用标准HTTPS/HTTP URL，自定义Scheme（如safari://）无法被Google Wear iOS应用正确解析
• 确保iPhone已安装最新版Google Wear应用，且与Wear OS设备正常配对
• 若回调返回ERROR_UNSUPPORTED_INTENT，检查是否遗漏CATEGORY_BROWSABLE，或URL是否存在格式错误

备选方案（Fallback） #

若上述方法仍无法生效，可通过Wear OS发送包含验证URL的通知到iPhone，用户点击通知后会自动唤起Safari：

val notificationManager = context.getSystemService(NotificationManager::class.java)
val pendingIntent = PendingIntent.getActivity(context, 0, intent, PendingIntent.FLAG_IMMUTABLE)
val notification = NotificationCompat.Builder(context, "AUTH_CHANNEL")
    .setContentTitle("完成登录验证")
    .setContentText("点击打开验证页面")
    .setSmallIcon(R.drawable.ic_notification)
    .setContentIntent(pendingIntent)
    .build()
notificationManager.notify(1, notification)

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