基于x-callback-url的iOS应用间双向通信实现技术问询

看起来你已经在搭建基于x-callback-url的iOS应用双向通信方案了，我来帮你梳理现有代码的问题，并给出完整的实现方案。

一、修正SourceApp的URL构造与打开逻辑 #

你提供的代码里有几个明显的问题：

1. URL字符串里的&是HTML转义字符，iOS URL构造中应该直接用&分隔参数
2. 代码末尾的&a...是截断的无效参数，需要移除或补全
3. 缺少URL有效性检查与系统权限校验

下面是修正后的完整代码：

@IBAction func btnOpenAppPressed(_ sender: UIButton) {
    // 对传递的参数做URL编码，避免特殊字符破坏URL结构
    guard let encodedWord = "Hello".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
          let targetURL = URL(string: "targetapp://x-callback-url/translate?x-success=sourceapp://x-callback-url/acceptTranslation&x-source=SourceApp&x-error=sourceapp://x-callback-url/translationError&word=\(encodedWord)") else {
        print("构造URL失败：参数无效或格式错误")
        return
    }
    
    // iOS9+需要在Info.plist配置LSApplicationQueriesSchemes，否则canOpenURL会返回false
    if UIApplication.shared.canOpenURL(targetURL) {
        // iOS10+推荐使用带回调的open方法，便于确认打开结果
        UIApplication.shared.open(targetURL, options: [:]) { isSuccess in
            if !isSuccess {
                print("打开TargetApp失败：应用未安装或URL Scheme配置错误")
            }
        }
    } else {
        print("无法打开TargetApp：请检查应用是否安装或LSApplicationQueriesSchemes配置")
    }
}

二、SourceApp的回调接收配置 #

要接收TargetApp的回调，你需要完成两个核心配置：

1. 配置URL Scheme #

在SourceApp的Info.plist中添加CFBundleURLTypes数组，声明自己的URL Scheme：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>sourceapp</string>
        </array>
        <key>CFBundleURLName</key>
        <string>SourceApp Callback</string>
    </dict>
</array>
<!-- iOS9+需要添加允许查询的TargetApp Scheme -->
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>targetapp</string>
</array>

2. 实现回调处理逻辑 #

根据iOS版本，选择在SceneDelegate（iOS13+）或AppDelegate中处理回调URL：

SceneDelegate示例（iOS13+）

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let callbackURL = URLContexts.first?.url else { return }
    handleCallback(from: callbackURL)
}

private func handleCallback(from url: URL) {
    guard url.scheme == "sourceapp", url.host == "x-callback-url" else {
        print("无效的回调URL：Scheme或Host不匹配")
        return
    }
    
    switch url.path {
    case "/acceptTranslation":
        // 解析TargetApp返回的翻译结果
        if let translatedWord = url.queryParameters?["translatedWord"] {
            print("收到翻译结果：\(translatedWord)")
            // 这里可以更新UI或执行业务逻辑
        }
    case "/translationError":
        // 解析错误信息
        if let errorMsg = url.queryParameters?["errorMessage"] {
            print("翻译失败：\(errorMsg)")
        }
    default:
        print("未知的回调路径")
    }
}

// 扩展URL，方便快速解析查询参数
extension URL {
    var queryParameters: [String: String]? {
        guard let components = URLComponents(url: self, resolvingAgainstBaseURL: true),
              let queryItems = components.queryItems else { return nil }
        return queryItems.reduce(into: [String: String]()) { result, item in
            result[item.name] = item.value
        }
    }
}

AppDelegate示例（iOS12及以下）

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    handleCallback(from: url)
    return true
}

// handleCallback方法同上面的实现

三、TargetApp的请求响应与回调实现 #

TargetApp需要完成以下步骤来响应SourceApp的请求并回调：

1. 配置URL Scheme #

在TargetApp的Info.plist中添加URL Scheme：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>targetapp</string>
        </array>
        <key>CFBundleURLName</key>
        <string>TargetApp Callback</string>
    </dict>
</array>

2. 解析请求并回调SourceApp #

同样在SceneDelegate或AppDelegate中处理SourceApp的请求：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let requestURL = URLContexts.first?.url else { return }
    handleSourceRequest(from: requestURL)
}

private func handleSourceRequest(from url: URL) {
    guard url.scheme == "targetapp", url.host == "x-callback-url", url.path == "/translate" else {
        print("无效的请求URL：Scheme/Host/Path不匹配")
        return
    }
    
    let params = url.queryParameters
    // 解析请求参数与回调地址
    guard let word = params?["word"],
          let successURLStr = params?["x-success"],
          let successURL = URL(string: successURLStr) else {
        // 参数错误时回调错误地址
        if let errorURLStr = params?["x-error"], let errorURL = URL(string: "\(errorURLStr)?errorMessage=参数无效") {
            UIApplication.shared.open(errorURL)
        }
        return
    }
    
    // 模拟翻译逻辑（替换为你的实际业务代码）
    let translatedWord = "你好"
    
    // 构造回调URL，添加翻译结果参数
    guard let encodedResult = translatedWord.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
          let callbackURL = URL(string: "\(successURLStr)&translatedWord=\(encodedResult)") else {
        if let errorURLStr = params?["x-error"], let errorURL = URL(string: "\(errorURLStr)?errorMessage=构造回调URL失败") {
            UIApplication.shared.open(errorURL)
        }
        return
    }
    
    // 回调SourceApp
    UIApplication.shared.open(callbackURL)
}

// 同样需要添加URL的queryParameters扩展

四、常见问题排查清单 #

• URL Scheme配置错误：确保两个App的CFBundleURLSchemes分别为sourceapp和targetapp，无重复冲突
• iOS权限问题：iOS9+必须在SourceApp的Info.plist中添加LSApplicationQueriesSchemes并包含targetapp
• 参数编码问题：所有传递的动态参数必须做URL编码，避免空格、中文等特殊字符破坏URL结构
• 回调URL无效：检查x-success/x-error中的URL是否正确，SourceApp的Scheme是否配置正确
• 版本适配问题：iOS13+使用SceneDelegate处理URL，iOS12及以下使用AppDelegate

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