Cordova-iOS 项目中外部链接在iOS 18失效问题解析

在iOS 18系统环境下，Cordova-iOS项目中出现了一个值得开发者注意的问题：通过target="_system"属性设置的外部链接无法正常打开。这个问题最初被发现于iOS 17升级到iOS 18后，原本正常工作的外部链接功能突然失效。

问题现象

开发者在使用类似以下HTML代码时遇到了问题：

<a target="_system" href="https://www.npmjs.com/package/cordova-ios">点击我</a>

在iOS 17及以下版本中，这样的链接能够正常在外部浏览器（通常是Safari）中打开，但在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 API的更新导致的。苹果在iOS 10中引入了新的open(_:options:completionHandler:)方法，并逐渐废弃了旧的openURL(_:)方法。在iOS 18中，苹果加强了对废弃API的限制，直接调用openURL(_:)会导致操作被强制返回false，从而阻止了链接的打开。

解决方案

对于Cordova项目开发者，有以下几种解决方案：

1. 更新相关插件： 检查项目中使用的插件是否包含调用openURL(_:)的代码，特别是以下常见插件：

   • cordova-plugin-inappbrowser
   • cordova-plugin-photo-library 这些插件的最新版本应该已经更新了API调用方式。

2. 手动修改插件代码： 如果暂时无法获取插件更新，可以手动修改插件中的相关代码。将：

   [[UIApplication sharedApplication] openURL:url];
   

   替换为：

   if (@available(iOS 10.0, *)) {
       [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:nil];
   } else {
       [[UIApplication sharedApplication] openURL:url];
   }
   

3. 检查target="_system"的使用： 值得注意的是，target="_system"并不是Cordova官方支持的标准属性。更推荐的做法是使用cordova-plugin-inappbrowser插件提供的API来打开外部链接：

   cordova.InAppBrowser.open('https://example.com', '_system');
   

开发者建议

1. 及时更新开发环境： 保持Cordova工具链和所有插件的最新版本，可以避免很多兼容性问题。

2. 关注API变更： 苹果每年都会对iOS API进行调整，开发者应该关注WWDC的API变更说明，特别是标记为废弃的API。

3. 全面测试： 在iOS大版本更新后，应该进行全面测试，特别是涉及系统API调用的功能。

4. 使用标准API： 尽量使用Cordova官方提供的API和插件，而不是依赖非标准的HTML属性或自定义实现。

这个问题虽然表面上是iOS 18兼容性问题，但也提醒开发者需要持续关注平台API的变化，并及时更新代码以适应新的系统要求。通过采用正确的API调用方式和保持代码更新，可以确保应用在不同iOS版本上都能正常工作。