XCUITest问题：视图重叠时无法点击ScrollView内元素

针对你遇到的ScrollView内按钮被顶部视图遮挡、无法通过默认tap()方法点击的问题，以下是对应问题的解答及可行实现方案：

1. XCUITest是否支持精准滚动？ #

XCUITest默认的自动滚动仅保证元素进入可见区域，但不会处理外部遮挡。不过我们可以通过自定义位置计算+滚动控制实现精准滚动：通过获取元素与滚动视图的位置信息，计算需要滚动的偏移量，确保元素滚动至避开顶部遮挡的区域。

2. 是否可设置ScrollView的contentOffset，使按钮相比tap()操作时更居中显示？ #

XCUITest没有直接修改contentOffset的公开API，但可以通过adjust(toNormalizedPosition:)方法间接实现类似效果。该方法接受归一化坐标（x/y范围0~1，对应滚动视图的顶部/底部），通过计算元素目标位置对应的归一化值，就能让按钮滚动至更居中（或完全避开遮挡）的位置。

3. 是否存在无动画快速滚动至底部，再按需向上滚动定位元素的方法？ #

可以使用adjust(toNormalizedPosition:)方法实现快速无动画滚动：传入CGPoint(x: 0, y: 1)可瞬间滚动至底部，传入CGPoint(x: 0, y: 0)可瞬间回到顶部。之后再计算元素位置，向上滚动至目标区域即可，这个操作的速度远快于swipe手势。

具体实现代码 #

以下是封装好的扩展方法，可直接用于滚动元素至避开顶部遮挡的可见区域：

import XCTest

extension XCUIElement {
    /// 将元素滚动至避开顶部遮挡的可见位置
    /// - Parameter overlayHeight: 顶部遮挡视图的高度
    func scrollToVisibleAvoidingTopOverlay(overlayHeight: CGFloat) {
        guard let scrollView = self.containingScrollView else { return }
        
        // 获取元素在屏幕坐标系中的位置
        let elementFrame = self.frame
        // 计算元素需要移动到的目标Y位置：顶部遮挡视图下方，预留20pt间距
        let targetMinY = overlayHeight + 20
        
        // 计算需要调整的滚动偏移量
        let currentElementTop = elementFrame.minY
        let offsetNeeded = targetMinY - currentElementTop
        
        // 转换为滚动视图的归一化位置（0=顶部，1=底部）
        let normalizedY = (scrollView.contentOffset.y + offsetNeeded) / scrollView.contentSize.height
        scrollView.adjust(toNormalizedPosition: CGPoint(x: 0, y: normalizedY))
    }
}

// 测试用例示例
class UITestsDemoTests: XCTestCase {
    let buttonLabel = "Tap Me!"
    let topOverlayHeight: CGFloat = 128
    
    func testTapButtonSuccessfully() {
        let app = XCUIApplication()
        app.launch()
        
        let targetButton = app.buttons[buttonLabel]
        // 滚动至避开顶部遮挡的位置
        targetButton.scrollToVisibleAvoidingTopOverlay(overlayHeight: topOverlayHeight)
        // 执行点击
        targetButton.tap()
    }
    
    // 快速滚到底部再定位元素的示例
    func testScrollToBottomThenLocateButton() {
        let app = XCUIApplication()
        app.launch()
        
        let scrollView = app.scrollViews.firstMatch
        // 快速滚到底部
        scrollView.adjust(toNormalizedPosition: CGPoint(x: 0, y: 1))
        
        let targetButton = app.buttons[buttonLabel]
        targetButton.scrollToVisibleAvoidingTopOverlay(overlayHeight: topOverlayHeight)
        targetButton.tap()
    }
}

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