IINA播放器在macOS Sonoma下的URL编码问题解析

在macOS 14 Sonoma系统中，IINA播放器(版本1.3.4)出现了一个与URL百分号编码相关的技术问题。这个问题导致通过iina://协议传递的URL链接在播放时被错误地进行了双重编码，从而产生无法正常播放的URL地址。

问题现象

当用户通过类似iina://weblink?url=https://example.com/%5Bfoo%20bar.mkv这样的URL调用IINA时，播放器会错误地将原始URL中的%5Bfoo%20bar.mkv部分转换为%5Bfoo%2520bar.mkv。这种双重编码行为使得最终生成的URL格式不正确，导致播放失败。

技术背景

这个问题源于Apple在Xcode 15中对URL解析机制的修改。根据Xcode 15的发布说明，从iOS 17及相应macOS版本开始，URL解析从过时的RFC 1738/1808标准更新为与URLComponents相同的RFC 3986解析方式。这一变化使得URL API会自动对无效字符进行百分号编码或IDNA编码，以帮助创建有效的URL。

问题分析

在macOS Ventura系统下，IINA能够正确处理包含特殊字符的URL。例如，对于URL https://example.com/%5Bfoo%20bar.mkv，播放器会保持原始编码不变。但在Sonoma系统下，同样的URL会被错误地双重编码。

更深入的分析发现，这个问题实际上包含两个层面的技术问题：

1. 在Sonoma系统下出现的URL双重编码问题
2. 在Ventura系统下存在的无法正确处理包含百分号字符的URL的问题

解决方案

开发团队通过以下方式解决了这个问题：

1. 移除了对URL字符串手动添加百分号编码的步骤，直接使用URL初始化器处理原始字符串
2. 针对不同Xcode版本实现了条件编译逻辑，确保向后兼容性
3. 在IINA 1.3.5版本中正式修复了这个问题

技术启示

这个案例展示了系统API变更对应用程序行为的影响，以及如何正确处理URL编码的重要性。对于开发者而言，需要注意以下几点：

1. 系统API的更新可能会改变应用程序的现有行为
2. URL编码处理需要遵循最新的RFC标准
3. 在跨版本支持时需要特别注意API行为的差异
4. 对于URL处理，使用URLComponents可能是更可靠的选择

这个问题的解决确保了IINA播放器在不同macOS版本下都能正确处理各种格式的媒体URL，为用户提供了更稳定的播放体验。