如何在UITest中点击SwiftUI Text视图内的Markdown链接

核心问题原因 #

SwiftUI拼接的Text视图（比如Text("前缀") + Text("[链接文本](url)") + Text("后缀")），默认不会将内部的Markdown链接单独暴露为UITest可识别的link元素，导致app.links找不到目标；而用HStack拆分视图会破坏文本排版的连贯性，尤其字体缩放后间距异常。

可行解决方案 #

方案1：给链接子Text添加可访问性标记

直接在拼接的链接Text上添加可访问性特征和标识符，让UITest能精准定位：

// 视图代码
Text("我同意") 
+ Text("[隐私政策](https://your-privacy-url.com)")
    .accessibilityAddTraits(.isLink)
    .accessibilityIdentifier("privacy_policy_link")
+ Text("和用户协议条款")

// UITest代码
app.staticTexts["privacy_policy_link"].tap()

这里用staticTexts是因为拼接的子Text会被识别为静态文本元素，加上.isLink trait后，也可以用app.links["privacy_policy_link"].tap()尝试定位。

方案2：用AttributedString构建统一文本

通过AttributedString创建带链接的完整文本，既能保证排版连贯，又能让UITest识别链接：

// 构建带链接的AttributedString
private var agreementText: AttributedString {
    var fullText = AttributedString("我同意隐私政策和用户协议条款")
    
    // 定位链接文本范围并设置属性
    if let linkRange = fullText.range(of: "隐私政策") {
        fullText[linkRange].link = URL(string: "https://your-privacy-url.com")
        fullText[linkRange].accessibilityTraits = .isLink
        fullText[linkRange].accessibilityIdentifier = "privacy_policy_link"
    }
    
    return fullText
}

// 视图中使用
Text(agreementText)

// UITest代码
// 方式1：通过标识符定位
app.links["privacy_policy_link"].tap()
// 方式2：通过链接文本定位
app.links["隐私政策"].tap()

这种方式下，整个文本是一个Text视图，排版完全连贯，同时链接会被正确暴露给可访问性框架，UITest能直接识别为link元素。

方案3：UIViewRepresentable包装UILabel（极端场景兜底）

如果上述SwiftUI原生方案仍不生效，可以用UIViewRepresentable包装UIKit的UILabel，利用UIKit成熟的链接识别能力：

struct LinkedAgreementLabel: UIViewRepresentable {
    let fullText: String
    let linkText: String
    let linkURL: URL
    
    func makeUIView(context: Context) -> UILabel {
        let label = UILabel()
        label.isUserInteractionEnabled = true
        label.numberOfLines = 0
        label.font = UIFont.systemFont(ofSize: 16) // 匹配SwiftUI字体
        
        // 构建富文本链接
        let attributedText = NSMutableAttributedString(string: fullText)
        let linkRange = (fullText as NSString).range(of: linkText)
        attributedText.addAttribute(.link, value: linkURL, range: linkRange)
        attributedText.addAttribute(.accessibilityIdentifier, value: "privacy_policy_link", range: linkRange)
        label.attributedText = attributedText
        
        // 添加点击手势处理跳转（若需自定义跳转逻辑）
        let tapGesture = UITapGestureRecognizer(target: context.coordinator, action: #selector(Coordinator.handleLinkTap))
        label.addGestureRecognizer(tapGesture)
        
        return label
    }
    
    func updateUIView(_ uiView: UILabel, context: Context) {}
    
    class Coordinator: NSObject {
        private let linkURL: URL
        
        init(linkURL: URL) {
            self.linkURL = linkURL
        }
        
        @objc func handleLinkTap(_ gesture: UITapGestureRecognizer) {
            guard let label = gesture.view as? UILabel, let attributedText = label.attributedText else { return }
            let tapLocation = gesture.location(in: label)
            
            // 计算点击位置对应的文本范围
            let layoutManager = NSLayoutManager()
            let textContainer = NSTextContainer(size: label.bounds.size)
            textContainer.lineFragmentPadding = 0
            layoutManager.addTextContainer(textContainer)
            let textStorage = NSTextStorage(attributedString: attributedText)
            textStorage.addLayoutManager(layoutManager)
            
            let charIndex = layoutManager.characterIndex(for: tapLocation, in: textContainer, fractionOfDistanceBetweenInsertionPoints: nil)
            if charIndex < textStorage.length,
               let url = textStorage.attribute(.link, at: charIndex, effectiveRange: nil) as? URL {
                UIApplication.shared.open(url)
            }
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(linkURL: linkURL)
    }
}

// 视图中使用
LinkedAgreementLabel(
    fullText: "我同意隐私政策和用户协议条款",
    linkText: "隐私政策",
    linkURL: URL(string: "https://your-privacy-url.com")!
)

// UITest代码
app.links["隐私政策"].tap()
// 或通过标识符
app.links["privacy_policy_link"].tap()

这种方式完全复用UIKit的链接识别逻辑，UITest能像处理原生UILabel链接一样正常定位点击。

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