Unity Application.OpenURL编辑器正常 Android打包后跳转失效

现有实现逻辑 #

跳转功能代码如下：

public void ToHyperLink()
{
    string theURL = parentButton.GetComponent<BLButton>().btnRefObj.GetComponent<HyperlinkAttri>().prodURL;
    Application.OpenURL(theURL);
}

URL参数通过Inspector面板传入，配置参考如下：

当前现象：PC端编辑器内测试、独立端运行时跳转均正常，打包为Android安装包在真机运行时，点击按钮无跳转响应。

逐点排查步骤 #

• 校验URL格式与取值正确性
  Android系统对URL格式校验比PC端严格，不会自动补全缺失的协议头：
  • 确认配置的URL必须以http://或https://开头，仅填写域名（如www.example.com）会导致Android端调用失败
  • 在Application.OpenURL调用前新增日志打印Debug.Log($"待跳转URL：{theURL}")，打包后通过Unity Android Logcat工具抓取真机日志，确认运行时拿到的URL不为空、无多余空格/转义字符、无拼接错误
• 检查Android清单文件配置
  不同Unity版本、Android版本对跨应用调用有权限限制，需修改Assets/Plugins/Android/AndroidManifest.xml补充配置：
  • 适配Android 11（API 30）及以上的包可见性限制：在<manifest>根节点下添加如下声明，否则应用无权限查询系统浏览器，OpenURL会静默失败

    <queries>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="http"/>
        </intent>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <data android:scheme="https"/>
        </intent>
    </queries>
    

  • 若跳转目标为HTTP明文链接（非HTTPS），需在<application>节点添加属性android:usesCleartextTraffic="true"，否则Android 9及以上系统会默认拦截明文网络请求
• 校验调用线程合法性
  Unity所有原生API调用必须在主线程执行，若按钮点击逻辑经过异步回调（如网络请求返回、延时回调）触发，需确认回调逻辑已切回主线程，子线程调用Application.OpenURL在Android端会直接失效，PC端可能偶现正常。
• 验证引用链路有效性
  写死固定测试URL（如"https://unity.com"）替换从组件取值的逻辑，重新打包测试：
  • 若写死URL可正常跳转，说明问题出在参数获取链路：大概率是构建时btnRefObj、HyperlinkAttri组件的引用丢失（常见于资源打包、Prefab嵌套时引用未正确序列化的情况，编辑器下引用正常不代表真机构建后引用不丢失），逐节点检查组件引用即可。
  • 若写死URL仍无法跳转，回到上述清单配置、权限步骤重新核对。

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