❌

阅读视图

发现新文章，点击刷新页面。

WKWebView的重定向（objective_c）

✇掘金 iOS
用户197295918891

背景

第三方支付回调时需要重定向到app的某个页面，比如支付完成后回到原生订单详情页，这个时间会有两种情况：

1、直接在web页面重定向到app的订单详情页，这个时候只需要实现 WKNavigationDelegate 中的一个核心方法webView:decidePolicyForNavigationAction:decisionHandler: 方法。

2、在支付中心跳转到第三方app然后支付完成后需要跳转回自己的app的订单详情页，这个时候可以采用Scheme方式或者是通用链接的方式解决

wkWebView重定向实现

实现这一目标，您需要让您的 WKWebView 所在的控制器遵循 WKNavigationDelegate 协议，并实现 webView:decidePolicyForNavigationAction:decisionHandler: 方法。

self.webView.navigationDelegate = self; // 设置代理

#pragma mark - WKNavigationDelegate 
- (**void**)webView:(WKWebView *)webView

decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction

decisionHandler:(**void** (^)(WKNavigationActionPolicy))decisionHandler {
    NSURL *url = navigationAction.request.URL;
    NSString *scheme = url.scheme;
    // 1. 检查 URL Scheme 是否是我们的自定义 Scheme
    if ([scheme isEqualToString:@"coolpet"]) {
        // 1.1. 阻止 WKWebView 加载这个 URL
        decisionHandler(WKNavigationActionPolicyCancel);
        // 1.2. 实现了 handleCoolPetURL: 方法
        [self handleCoolPetURL:url];
        // 1.3. 跳转后关闭当前的 WebView 页面
        [self.navigationController popViewControllerAnimated:YES];
        return;
    }
    // 2. 对于其他 HTTP/HTTPS 链接，允许正常加载
    // 特别检查 navigationType 是否是新的主框架加载，例如用户点击了链接
//    if (navigationAction.navigationType == WKNavigationTypeLinkActivated && ![scheme hasPrefix:@"http"]) {
//        // 如果是点击了非 HTTP/HTTPS 的链接（但不是我们自定义的 Scheme），可以根据需要处理，
//        // 比如打开 App Store 或其他应用。这里我们通常允许其他系统 Scheme
//        // 允许继续，但更安全的做法是只允许 http(s)
//        // decisionHandler(WKNavigationActionPolicyAllow);
//    }
    // 3. 默认允许其他所有导航行为（如页内跳转、HTTP/HTTPS 加载等）
    decisionHandler(WKNavigationActionPolicyAllow);
}

// 通过URL跳转对应页面
- (void)handleCoolPetURL:(NSURL *)url {
    NSString *host = url.host;
    NSString *path = url.path;      // 路径: /order/detail
    NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
    NSMutableDictionary *queryParams = [NSMutableDictionary dictionary];
    for (NSURLQueryItem *item in components.queryItems) {
        queryParams[item.name] = item.value;
    }
    // 根据路径判断是否是订单详情页
    if ([host isEqualToString:kAPPUniversalTypeOrderDetailsHost] && [path isEqualToString:kAPPUniversalTypeOrderDetailsPath]) {
        // 获取我们需要的订单号
        NSString *tradeNo = [queryParams[@"tradeNo"] stringValue];
        // 执行跳转

        if (tradeNo.length > 0) {
            dispatch_async(dispatch_get_main_queue(), ^{
                /// 做跳转
            });
        }
    }
}

Scheme方式

第三方支付平台完成支付后，是通过你App的 URL Scheme 来唤醒你的App并携带支付结果的。

  1. 配置 App URL Scheme

  • 操作： 在 Xcode 项目的 Info.plist 或项目设置的 Info 选项卡下的 URL Types 中添加你的 App 的 Scheme。

    • 例如，你可以设置一个 Scheme 叫 myscheme。
  1. 处理 App Delegate 中的回调

App 被第三方支付应用唤醒后，系统会调用 AppDelegate 中的特定方法。你需要在这里接收并处理回调 URL。

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, **id**> *)options {
    // 1. 检查是否是你的支付回调 Scheme
    if ([url.scheme isEqualToString:@"myappscheme"]) {
        [self handleCoolPetURL:url];
    }

    // 如果是其他URL（如通用链接），也在这里处理
    // ...
    return NO;
}

通用链接方式

当用户点击一个配置了通用链接的 HTTPS 链接时：

  1. 如果 App 已经安装，系统会直接调用 AppDelegate 中的这个方法。
  2. 如果 App 未安装，该链接会直接在 Safari 中打开。

这个机制的主要优点是安全（基于 HTTPS）和用户体验更好（避免了 URL Scheme 引起的跳转确认和安全问题）。

🔗 通用链接（Universal Links）实现指南

步骤 1: 服务器端配置（Association File）

这是通用链接能够工作的基础。您需要在您的 Web 服务器上创建一个特殊的 JSON 文件，告诉 iOS 系统哪些路径应该由您的 App 处理。

1. 创建 apple-app-site-association 文件

  • 文件名： 必须是 apple-app-site-association（注意，没有 .json 扩展名）。

  • 内容格式（JSON）：

    {
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "TeamID.BundleID",
                "paths": [
                    "/orders/*",    // 匹配所有 /orders/ 下的路径
                    "/products/*",  // 匹配所有 /products/ 下的路径
                    "NOT /account/login/*" // 排除某些路径
                ]
            }
        ]
    }
}
    • TeamID： 您的 Apple Developer Team ID。
    • BundleID： 您的 App 的 Bundle Identifier。
    • paths： 定义您希望 App 能够处理的 URL 路径。
2. 部署文件

  • 部署位置： 将此文件上传到您的域名根目录或 .well-known/ 目录下。

    • 例如：https://yourdomain.com/apple-app-site-association
    • 或者：https://yourdomain.com/.well-known/apple-app-site-association

  • 内容类型： 确保服务器以正确的 MIME 类型提供此文件：application/json 或 text/plain。

  • HTTPS： 您的整个网站必须使用 HTTPS。

步骤 2: App 端配置（Xcode & Objective-C）

1. 开启 Associated Domains Capability

在 Xcode 中为您的 App 开启 Associated Domains 功能。

  • 路径： Xcode -> 项目设置 -> 目标 (Target) -> Signing & Capabilities 选项卡

  • 操作： 点击 + Capability，添加 Associated Domains。

  • 添加域名： 在列表中添加您的域名，格式为：

    applinks:yourdomain.com

    注意： 不带 https:// 或 http://。

2. 在 AppDelegate 中接收回调

当用户点击一个通用链接并唤醒 App 时，系统会调用 AppDelegate 中的 continueUserActivity 方法。您需要在此方法中解析 URL 并进行页面跳转。

// AppDelegate.m

#import "OrderViewController.h" // 假设您的订单处理页面

// ...

- (BOOL)application:(UIApplication *)application 
continueUserActivity:(NSUserActivity *)userActivity 
  restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
    
    // 1. 检查活动类型是否为 Universal Link
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
        
        // 2. 获取用户点击的 HTTPS URL
        NSURL *webpageURL = userActivity.webpageURL;
        
        if (webpageURL) {
            NSLog(@"Received Universal Link: %@", webpageURL.absoluteString);
            
            // 3. 将 URL 转发给路由处理方法
            [self handleUniversalLinkURL:webpageURL];
            
            return YES;
        }
    }
    
    return NO;
}

// 通用链接路由处理方法
- (void)handleUniversalLinkURL:(NSURL *)url {
    
    // 示例：解析路径并跳转到订单详情
    if ([url.path hasPrefix:@"/orders/detail"]) {
        
        // 解析查询参数，例如 order_id=12345
        NSString *orderID = [self extractParameter:@"order_id" fromURL:url];
        
        if (orderID.length > 0) {
            dispatch_async(dispatch_get_main_queue(), ^{
                // 执行跳转逻辑
                UINavigationController *nav = (UINavigationController *)self.window.rootViewController;
                OrderViewController *orderVC = [[OrderViewController alloc] init];
                orderVC.orderID = orderID;
                [nav pushViewController:orderVC animated:YES];
            });
        }
    }
}

// 辅助方法 (需要您自行实现，或使用前文提到的 dictionaryWithQueryString: 方法)
- (NSString *)extractParameter:(NSString *)paramName fromURL:(NSURL *)url {
    // ... 解析 url.query 字符串，提取指定参数 ...
    return nil; 
}
❌