您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS URL Scheme 完整教學:App 互相跳轉與參數傳遞

編輯:iOS 相關教學

iOS 的 App 各自運行在獨立沙盒中,預設情況下彼此是資訊孤島,無法直接通訊。URL Scheme 正是 Apple 為打破這道牆而設計的機制:App 可以註冊一組專屬的 URL 前綴,其他 App 或 Safari 只要開啟這個 URL,就能把對方喚起,同時帶入參數。

URL Scheme 能做什麼

最直觀的例子:在 Safari 網址列輸入 alipay://,若裝置已安裝支付寶,就會直接跳進該 App;若未安裝,則會導向預下載頁面或 App Store。

有兩個規則必須牢記:

第一,URL Scheme 必須能唯一標識一個 App。若你設定的 Scheme 與其他 App 衝突,你的 App 不一定能被啟動——通常系統會叫起先安裝的那一個。而 iOS 系統 App 的 Scheme 擁有最高優先級,因此自訂時請盡量避開系統已佔用的名稱。

第二,註冊的時機是安裝當下。系統會在 App 安裝時把它的 Scheme 登錄進來,之後才能被外部喚起。

註冊 URL Scheme

每個專案都有一個 info.plist 設定檔,註冊動作全在這裡完成。

步驟 1:加入 URL types

找到 info.plist,右鍵選擇 Add Row,然後選取 URL types:

步驟 2:加入 URL Schemes

展開 URL types,再次右鍵 Add Row,這次選 URL Schemes:

步驟 3:設定 Scheme 名稱

這裡我們把 Scheme 設為 iOSDevTip:

步驟 4:設定 URL Identifier

URL Identifier 是這組 Scheme 的自訂名稱,慣例是使用反向域名以確保唯一性,例如 com.iOSStrongDemo.www:

加上啟動提示,方便測試

為了確認 App 真的被喚起了,我們在 AppDelegate 中實作 handleOpenURL,被啟動時彈出一個提示:

- (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 驗證 Scheme 是否生效

配置完成後,打開 Safari,在網址列輸入:

iOSDevTip://

若一切正常,App 會被喚起並彈出提示:

輸入 iOSDevTip://com.iOSStrongDemo.www 同樣可以開啟。可見完整格式為 URL Scheme://URL identifier,其中 identifier 是可選的,直接呼叫 Scheme 即可。

從另一個 App 喚起

程式碼中則用 canOpenURL: 先確認對方是否安裝,再用 openURL: 執行跳轉:

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");
}

養成先用 canOpenURL: 判斷再跳的習慣很重要,否則目標 App 未安裝時會徒然失敗而毫無回饋。

透過 URL Scheme 傳遞參數

單純喚起很簡單,但實務上更常需要「叫起對方的同時把資料帶過去」。這只要自訂 URL 的 query 部分即可,寫法與 HTTP GET 請求如出一轍。假設要傳 name 與 phone 兩個參數:

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

有沒有似曾相識的感覺?沒錯,這就是標準的 query string 格式。

先來看 Apple 對舊方法的註解:

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

因此我們直接採用推薦的新方法。被喚起的 App 端實作如下:

- (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;
}

App 被啟動時,系統會呼叫這個代理方法。其中 url 就是啟動用的完整 URL,sourceApplication 則是來源 App 的 Bundle ID。

一樣用 Safari 測試,在網址列輸入 iOSDevTip://?name=ligang&phone=13888888888:

App 開啟後即可看到參數已成功傳入:

主控台輸出如下:

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

從 com.apple.mobilesafari 不難看出,這次是由 Safari 喚起我們的 App。

安全提醒:限制來源 App

這裡藏著一個資安上的盲點:自訂了 URL Scheme,並不代表你能阻止別人用它來開啟你的 App。任何 App 只要知道你的 Scheme,都能把你叫起來,甚至偽造參數。

解法是在回呼中檢查 sourceApplication,比對是否為你信任的 Bundle ID:

- (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;
    }
}

如此一來,就能依 Bundle ID 決定是否允許對方開啟自己的 App。要補充的是,Bundle ID 可被偽造,因此這道檢查只能過濾一般性的誤觸與雜訊,不能當成真正的安全邊界。若傳入的參數會驅動敏感操作(轉帳、變更設定等),仍應在伺服器端做二次驗證。

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