您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

URL Scheme 完整教學:App 跳轉、傳參與來源校驗

編輯:iOS 開發綜合

URL Scheme 能幹什麼

每個 iOS App 都住在自己的沙盒裡,預設情況下彼此是資訊孤島。但 App 可以註冊專屬的 URL Scheme,讓其他 App 或 Safari 透過系統的 openURL 把自己叫起來,同時帶一些參數進來。

最常見的例子:在 Safari 輸入 www.alipay.com 能直接跳到支付寶 App;若沒安裝,則會導向引導頁或 App Store。

關鍵規則是:URL Scheme 必須能唯一標識一個 App。如果和別人撞名,誰會被叫起來並不確定——一般會優先喚起先安裝的那個,而系統自帶 App 的 Scheme 優先權最高。所以自訂時請避開系統已用的名稱,並用反轉域名風格降低碰撞機率。

註冊 URL Scheme

1. 在 info.plist 中新增 URL types。

2. 展開 URL types,再 Add Row 加入 URL Schemes。

3. 把 URL Schemes 設為 iOSDevTip。

4. 設定 URL Identifier,建議用反轉域名確保唯一,例如 com.iOSStrongDemo.www。

加上啟動提示,方便測試

在 AppDelegate 中收到 URL 時彈一個提示:

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    // 接收傳過來的參數
    NSString *text = [[url host] stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
    UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"打開啦"
        message:text delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
    [alertView show];
    return YES;
}

用 Safari 驗證

設定好之後,在 Safari 網址列輸入:

iOSDevTip://

App 成功被喚起:

帶上 identifier 也可以:iOSDevTip://com.iOSStrongDemo.www。

從另一個 App 喚起

NSString *url = @"iOSDevTip://";
// NSString *url = @"iOSDevTip://com.iOSStrongDemo.www";

if ([[UIApplication sharedApplication] canOpenURL:[NSURL URLWithString:url]]) {
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:url]];
} else {
    NSLog(@"can not open URL scheme iOSDevTip");
}

完整格式是 URL Scheme://URL identifier,其中 identifier 可省略。實務上先用 canOpenURL: 探一下再 open,可以避免一堆無效的系統錯誤。

傳遞參數

Apple 已標記舊方法將被取代:

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url;
// Will be deprecated at some point, please replace with application:openURL:sourceApplication:annotation:

所以請直接用新版本。URL 傳參格式跟 GET 請求的 query string 一模一樣,假設要傳 name 與 phone:

iOSDevTip://?name=ligang&phone=13888888888

接收端:

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
    NSLog(@"sourceApplication: %@", sourceApplication);
    NSLog(@"URL scheme: %@", [url scheme]);
    NSLog(@"URL query: %@", [url query]);

    UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"打開啦"
        message:[url query] delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
    [alertView show];
    return YES;
}

參數中,url 是喚起用的完整 URL,sourceApplication 則是來源 App 的 Bundle ID。用 Safari 測試,輸入:

iOSDevTip://?name=ligang&phone=13888888888

控制台輸出:

sourceApplication: com.apple.mobilesafari
URL scheme: iosdevtip
URL query: name=ligang&phone=13888888888

安全提醒:別忘了驗證來源

自訂了 URL Scheme,並不代表只有你能喚起自己的 App——任何人都可以在網頁裡寫一段 iOSDevTip:// 把你的 App 叫起來。若要限制來源,就在 sourceApplication 上做判斷:

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
    NSLog(@"sourceApplication: %@", sourceApplication);
    NSLog(@"URL scheme: %@", [url scheme]);
    NSLog(@"URL query: %@", [url query]);

    if ([sourceApplication isEqualToString:@"com.3Sixty.CallCustomURL"]) {
        UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"打開啦"
            message:[url query] delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
        [alertView show];
        return YES;
    } else {
        return NO;
    }
}

最後補充兩點現代實務上的注意事項:一是 UIAlertView 與舊版 handleOpenURL 都已被淘汰,新專案請改用 UIAlertController 與 scene:openURLContexts:(或 AppDelegate 的 application:openURL:options:);二是若需要在 iOS 9 之後查詢對方是否安裝,記得先在 Info.plist 的 LSApplicationQueriesSchemes 白名單中登記,否則 canOpenURL: 一律回傳 NO。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved