Cordova-iOS 项目中外部链接在 iOS 18 上的兼容性问题解析

在 Cordova-iOS 项目中，开发者经常需要处理外部链接的打开问题。近期随着 iOS 18 的发布，一些开发者发现原本正常工作的外部链接功能出现了异常。本文将深入分析这一问题的根源，并提供解决方案。

问题现象

在 iOS 17 及以下版本中，通过以下方式打开外部链接可以正常工作：

<a target="_system" href="https://example.com">点击我</a>

然而在升级到 iOS 18 后，这个功能突然失效了。Xcode 控制台会显示如下警告信息：

BUG IN CLIENT OF UIKIT: The caller of UIApplication.openURL(_:) needs to migrate to the non-deprecated UIApplication.open(_:options:completionHandler:). Force returning false (NO).

问题根源

这个问题源于 iOS 18 对 UIApplication 类中 openURL 方法的弃用处理。苹果官方在 iOS 10 时就引入了新的 open(_:options:completionHandler:) API，但直到 iOS 18 才强制要求开发者迁移到新 API。

在 Cordova 生态系统中，多个插件仍然使用旧的 openURL 方法，包括但不限于：

1. cordova-plugin-inappbrowser
2. cordova-plugin-photo-library
3. 其他可能调用此方法的自定义插件

技术背景

iOS 的 URL 打开机制经历了多次演进：

1. 最初使用 openURL 方法
2. iOS 10 引入 open(_:options:completionHandler:) 方法
3. iOS 18 强制弃用 openURL 方法

新方法提供了更多功能和更好的错误处理机制，包括：

• 可选的参数配置
• 完成回调处理
• 更好的错误反馈

解决方案

针对这个问题，开发者可以采取以下几种解决方案：

1. 更新插件代码

对于使用 cordova-plugin-inappbrowser 的开发者，可以修改 CDVWKInAppBrowser.m 文件中的相关代码：

// 旧代码
[[UIApplication sharedApplication] openURL:url];

// 新代码
if (@available(iOS 10.0, *)) {
    [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {
        if (!success) {
            NSLog(@"Failed to open URL: %@", url);
        }
    }];
} else {
    BOOL success = [[UIApplication sharedApplication] openURL:url];
    if (!success) {
        NSLog(@"Failed to open URL: %@", url);
    }
}

2. 使用最新版插件

检查并更新所有相关插件到最新版本。许多插件维护者已经针对 iOS 18 进行了适配更新。

3. 自定义解决方案

对于需要完全控制链接打开行为的开发者，可以考虑实现自定义的链接处理逻辑：

function openExternalUrl(url) {
    if (device.platform === 'iOS') {
        window.open(url, '_system');
    } else {
        // 其他平台的实现
    }
}

最佳实践

1. 及时更新：保持 Cordova 和所有插件的最新版本
2. 全面测试：在 iOS 18 设备上进行充分测试
3. 错误处理：实现完善的错误处理机制
4. 兼容性检查：使用 @available 宏确保代码在不同 iOS 版本上的兼容性

总结

随着 iOS 18 的发布，苹果加强了对旧 API 的限制，这影响了 Cordova 项目中外部链接的打开功能。通过理解问题根源并采取适当的更新措施，开发者可以确保应用在所有 iOS 版本上都能正常工作。建议开发者定期检查项目中的 API 使用情况，及时跟进苹果的 API 变更，以保持应用的兼容性和稳定性。