iOS SDK: Working with URL Schemes

iOS SDKMobile DevelopmentCommunication between apps provides your application with an opportunity to take advantage of other application's functionality, send and receive data between apps, and provide a rich user experience that “just works".In this tutorial we are going to create two apps, one app that sends data, and another app that receives that data. Together, these apps will demonstrate URL schemes, a method for sending and receiving data between applications. This is a fairly advanced tutorial with regard to understanding Xcode, and I would highly recommend that before you begin this tutorial you feel comfortable using Xcode and Interface Builder.Please note: A physical device is required for testing this app.Step 1: Creating a Sender ProjectLet's go ahead and create a new Xcode project, select “View Based Application." Hit next. Name the project “Sender" and enter your Company Identifier. This project will house the app that sends information to the “Receiver" app which we will create shortly.Create a Sender ProjectStep 2: Setup the XIB and Interface Builder ConnectionsBefore we setup our XIB, we'll create a few declarations ahead of time.In the left Navigator Pane, open up SenderViewController.h and set it up like this:01020304050607080910111213#import@interface SenderViewController : UIViewController {    IBOutlet UITextField *textBox;} -(IBAction) openMaps:(id)sender;-(IBAction) openYoutube:(id)sender;-(IBAction) openReceiverApp:(id)sender; @property(nonatomic, retain) IBOutlet UITextField *textBox; @endBy doing this, we are declaring a few methods which will be called by UIButtons in the future and a variable that references a UITextField. These UI Elements will be added next.Now, in the left Navigator Pane, open up SenderViewController.xib and drag out one UITextField and three UIButtons from the right-hand side Utilities Pane. Stack them vertically on the view and rename the first button to “Send Text to Receiver App ", the second button to “Open Maps", and the third button to “Open YouTube". Your view should resemble something similar the image below.Sender View XIBNow, our last step is to finalize our IBConnections. Select File's Owner (the orange wireframe box) on the left and then, in the Utilities Pane on the right, choose the Connections Inspector (the arrow) tab. Connect textBox to the UITextField. Next, connect openMaps:, openYoutube:, and openReceiverApp: to their respective button's “Touch Up Inside" event by a connection line from the circle on the right to the buttons. The connections should resemble what is shown below.Sender XIB Interface Builder ConnectionsStep 3: Opening URLs for CommunicationTo begin, open the file SenderViewController.m from the Navigator Pane. Under @implementation add the following line to synthesize our property:1@synthesize textBox;Let's also make sure we follow correct memory management rules and cleanup the retain we had in our property, above [super dealloc]; add:1[textBox release];Lastly, in our viewDidUnload method below “[super viewDidUnload];" add:1self.textBox = nil;A brief rundown of URL schemes is that URL schemes allow apps to register their own protocol to allow the transfer of data. Some common examples of protocols you may use on a regular basis are, “http://", “https://", and “ftp://". For example a bookmarking app may want to register “bookmark://", so other apps could bookmark links using the URL scheme, “bookmark://www.envato.com". Apps cannot register to the “http://" protocol, although some Apple apps break this rule and are registered “http://" to open up apps like Maps, iTunes, and YouTube. Our Receiver app will register for “readtext://texthere". We can open these URL's by calling UIApplication's method openURL:. When we use openURL: it will launch the specified app and hand it the data you provided.Add the following methods to your SenderViewController.m file:010203040506070809101112131415161718192021222324252627282930313233-(IBAction) openMaps:(id)sender {    // Opens a map containing Envato's Headquarters    UIApplication *ourApplication = [UIApplication sharedApplication];    NSString *ourPath = @"http://maps.google.com/maps?ll=-37.812022,144.969277";    NSURL *ourURL = [NSURL URLWithString:ourPath];    [ourApplication openURL:ourURL];} -(IBAction) openYoutube:(id)sender {    // Opens a video of an iPad 2 Commercial    UIApplication *ourApplication = [UIApplication sharedApplication];    NSString *ourPath = @"http://www.youtube.com/watch?v=TFFkK2SmPg4";    NSURL *ourURL = [NSURL URLWithString:ourPath];    [ourApplication openURL:ourURL];} -(IBAction) openReceiverApp:(id)sender {    // Opens the Receiver app if installed, otherwise displays an error    UIApplication *ourApplication = [UIApplication sharedApplication];    NSString *URLEncodedText = [self.textBox.text stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];    NSString *ourPath = [@"readtext://" stringByAppendingString:URLEncodedText];    NSURL *ourURL = [NSURL URLWithString:ourPath];    if ([ourApplication canOpenURL:ourURL]) {        [ourApplication openURL:ourURL];    }    else {        //Display error        UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:@"Receiver Not Found" message:@"The Receiver App is not installed. It must be installed to send text." delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];        [alertView show];        [alertView release];    } }These methods are using the openURL method of the UIApplication to send data to other apps. Apple has registered the Maps application and YouTube application with “http://" essentially, so we simply call openURL on those URLs. To create our URL, we also used the stringByAddingPercentEscapesUsingEncoding: method to ensure the string is a valid URL by URL encoding the string (we will decode it in our Receiver app). For our custom URL “readtext://" we first check if the link can be opened with canOpenURL. This essentially checks whether the app that is registered to that particular URL scheme is installed, and if it is, we are able to open the URL with our text. If the app is not installed, we display an error message. Remember that when you release your app to the public, the URL scheme your app is dependent on might not work because the other app isn't installed. You should always perform the canOpenURL when opening non-http:// URL schemes.Go ahead and build and run the application. Notice the Maps and YouTube buttons open up their respective apps. Also, the “Sent Text" button returns an error message since we have yet to create our “Receiver" app.Step 4: Creating a Receiver AppCreate a new XCode project, and select “View Based Application." Hit next. Name the project “Receiver" and enter your Company Identifier. This project will house the app that reads information sent by the “Sender" app.Create a Receiver ProjectStep 5: Register the Custom URL SchemeIn the Project Navigator, expand the Supporting Files group and open the Receiver-Info.plist file.You can add a new row by going to the menu and clicking Editor > Add Item. Set up a URL Types item by adding a new item. Expand the URL Types key, expand Item 0, and add a new item, “URL schemes". Fill in “readtext" for Item 0 of “URL schemes" and your company identifier for the “URL Identifier". Your file should resemble the image below when done.Receiver-Info.plistStep 6 : Handle the URLOpen ReceiverAppDelegate.m and replace the application:applicationDidFinishLaunchingWithOptions: method with the following code:0102030405060708091011121314151617- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{    // Override point for customization after application launch.    self.window.rootViewController = self.viewController;    [self.window makeKeyAndVisible];    //Display error is there is no URL    if (![launchOptions objectForKey:UIApplicationLaunchOptionsURLKey]) {        UIAlertView *alertView;        alertView = [[UIAlertView alloc] initWithTitle:@"Error" message:@"This app was launched without any text. Open this app using the Sender app to send text." delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];        [alertView show];        [alertView release];    }    return YES;}This alerts an error if the application is opened without a URL. Generally, if this occurs you would load your app normally but for the sake of experimenting we will display an error.Add the following code beneath the application:applicationDidFinishLaunchingWithOptions: method.01020304050607080910- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {    // Display text    UIAlertView *alertView;    NSString *text = [[url host] stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];    alertView = [[UIAlertView alloc] initWithTitle:@"Text" message:text delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];    [alertView show];    [alertView release];    return YES;}This code alerts the user with the text that was sent by the Sender app when the application is opened with a URL. Generally, you should use this data to follow up with an appropriate action within your app. Notice that we used the hostname of the URL to get our text. We did this because the URL scheme we registered functions like any other URL “scheme://hostname/path/file.php?variable=x#section" (Recall that our URL was “readtext://text"). We also URL decoded the text using the stringByReplacingPercentEscapesUsingEncoding: method as previously we had URL encoded it.Step 7: Testing the ApplicationThe time has finally come to test these two applications. They must both be built and installed to a physical iOS device. Make sure you have disconnected the device from the computer when testing and you have closed the Receiver app after disconnecting to prevent any problems. Open up the Sender app, write up some text, and hit send. The receiver app should open prompting you with the text you typed.Final ResultAdvertisementConclusionIf successful, you should now be able to easily implement inter-app communications using URL schemes. If you have any questions or comments, feel free to leave them in the comments section below. Thanks for reading!Additional Information and ResourcesPros:Does not force the user to be connected to a network, or require additional resources for web server handling.A simple, fast, and easy method of implementing communication.Provide a public communication interface that ANY app can take advantage of.Open your application from your website using an anchor tag. Ex:Open Our iPhone ApplicationCons:Unlike other platforms such as Android, iPhone does not create a stack of actions (back stacking on Android). What this means is that if you do decide to launch another application, your application will not resume when the user exits from the application you opened.When not to use URL Schemes:Sending user-sensitive data such as username and password combinations. You should never do this; instead refer to the Keychain API.Avoid using URL Schemes when you can implement the other applications functionality internally and directly, to avoid having your application close. For example, should you use a URL scheme to launch the Maps application when you could implement Maps in-app? Depending on the situation, you may have to but in many cases opening Maps in-app is sufficient.No authentication that the data you have sent will reach the correct application or whether it has reached at all, namely why sensitive data should not be sent.Resources:Apple Developer Reference (provides information on URL Schemes, and how to launch Apple apps using them)2eb5e231c8f559e595bfc3783a7e15e2?s=200&d=https%3a%2f%2fassets.tutsplus.com%2fimages%2fhub%2favatar defaultAjay PatelI am passionate about web and mobile development. I love playing around with the latest technologies in our industry. I works mostly in PHP and CMS like WordPress, Joomla. I am Founder and Content writer of  WebDesignerGeek . Now working as Web & Mobile App Developer. You can follow him on @twitter and @facebookFree trial of 780 Envato Tuts+ coursesFree trial highlightStart your free 10 day trialAdvertisementDownload AttachmentAdvertisementTranslationsEnvato Tuts+ tutorials are translated into other languages by our community members—you can be involved too!Translate this postPowered byNative logo


http://code.tutsplus.com/tutorials/ios-sdk-working-with-url-schemes--mobile-6629

https://developer.apple.com/library/ios/featuredarticles/iPhoneURLScheme_Reference/Introduction/Introduction.html

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容