iOS 18中UICollectionViewDelegate移动项方法未调用问题求助

问题描述 #

使用Xcode 16.0.0开发时，发现iOS 18系统下，UICollectionViewDelegate中处理项移动的collectionView(_:targetIndexPathForMoveOfItemFromOriginalIndexPath:atCurrentIndexPath:toProposedIndexPath:)方法完全不触发，但在iOS 17.5及更早版本中工作正常。

我的UICollectionView已启用拖拽功能，实现的相关代理方法如下：

func collectionView(_ collectionView: UICollectionView, targetIndexPathForMoveOfItemFromOriginalIndexPath originalIndexPath: IndexPath, atCurrentIndexPath currentIndexPath: IndexPath, toProposedIndexPath proposedIndexPath: IndexPath) -> IndexPath {
    print("🐸 Move")
    return proposedIndexPath
}

在iOS 17.5及之前版本，拖拽移动项时该方法会正常打印日志，但iOS 18中尝试移动项时，此方法从未被调用。

已尝试的排查操作 #

• 确认collectionView的代理已正确设置
• 验证其他代理方法（如collectionView(_:canMoveItemAt:)和collectionView(_:moveItemAt:to:)）仍可正常调用
• 拖拽功能本身可以工作，但不会触发上述特定方法

疑问 #

1. 是否有其他开发者在iOS 18中遇到同样的问题？
2. 这是iOS 18的已知Bug，还是该方法的行为发生了变更？
3. 在iOS 18中是否有替代方法或解决方案来实现相同的功能？

代码上下文 #

以下是实现UICollectionViewDelegate的简化版DragAndDropManager类：

class DragAndDropManager: NSObject, UICollectionViewDelegate {
    // ... 其他属性和方法 ...

    func collectionView(_ collectionView: UICollectionView, canMoveItemAt indexPath: IndexPath) -> Bool {
        return true
    }
    
    func collectionView(_ collectionView: UICollectionView, targetIndexPathForMoveOfItemFromOriginalIndexPath originalIndexPath: IndexPath, atCurrentIndexPath currentIndexPath: IndexPath, toProposedIndexPath proposedIndexPath: IndexPath) -> IndexPath {
        print("🐸 Move")
        return proposedIndexPath
    }
    
    func collectionView(_ collectionView: UICollectionView, moveItemAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
        // 处理移动操作
    }

    // ... 其他代理方法 ...
}

解答 #

1. 是否有其他开发者遇到此问题？
   是的，已有不少开发者在社区反馈iOS 18中该方法失效的问题，属于iOS 18初期版本的常见兼容性问题。

2. 是Bug还是行为变更？
   目前来看这是iOS 18的已知Bug，并非API行为变更。Apple官方文档仍保留该方法定义，未标注废弃或行为修改说明，推测是UICollectionView内部逻辑出现调用遗漏。

3. 替代方案/解决方案

临时 workaround：

如果需要在iOS 18中实现调整目标索引路径的逻辑，可以通过以下方式替代：

• 在collectionView(_:moveItemAt:to:)方法中，对传入的destinationIndexPath进行二次校验和调整，再执行数据更新操作

示例代码（在moveItem方法中修正路径）：

func collectionView(_ collectionView: UICollectionView, moveItemAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
    // 模拟原方法的逻辑，修正目标路径
    let adjustedDestination = adjustDestinationIndexPath(original: sourceIndexPath, proposed: destinationIndexPath)
    // 用修正后的路径处理数据移动
    yourDataSource.moveItem(from: sourceIndexPath, to: adjustedDestination)
}

private func adjustDestinationIndexPath(original: IndexPath, proposed: IndexPath) -> IndexPath {
    // 这里写入你原本在targetIndexPathForMove方法中的逻辑
    // 比如限制某些位置不可移动等
    return proposed
}

长期解决方案：

• 关注Apple的iOS 18后续版本更新，该Bug大概率会在后续beta版本或正式版中修复
• 通过Apple反馈助手提交Bug报告，帮助官方定位问题

内容的提问来源于stack exchange，提问作者0xymnds