Poking a Hole in the Sandbox: Using URLs on ios

Transcription

1 Poking a Hole in the Sandbox: Using URLs on ios Greg

2 Who am I? Greg Pierce President, Agile Indie app development, web consulting

3 What do I do? Drafts Terminology Phraseology

4 What am I talking about? Custom URLs schemes as tool for inter-app communication on ios. - Limited options in the sandbox. - Consume URLs in other apps. - Provide services with URLs.

5 Inter-app whaaa? Integrating with other apps can make your app... - More useful. - Offers great opportunities for cross-promotion.

6 Overview Part 1 - What? - Local and Lightweight Part 2 - Why? - Use Cases Part 3 - How? - Implementation Part 4 - X-Callback-URL Q & A

7 Part 1 - What? Local and Lightweight

8 Anatomy of a URL - URL = Uniform Resource Locator scheme://domain:port/path? query_string#fragment_id - scheme or protocol is registered with OS. - Safari registers http - Phone.app registers tel - Mail.app registers mailto

9 Custom URLs - ios provides means to register Custom URL schemes for apps. - Registering says you know what to do with scheme: URLs. - Simple entries in app s Info.plist. - One app can register many custom URL schemes.

10 URLs - Lightweight Messaging between apps. - No OAuth, Web Services, complex setup. - Local - No network require for locally installed apps. - Few options!

11 Custom URL structure - Beyond the scheme and the colon, custom URL can look like anything. scheme:* - Not tied to HTTP (host:port/path) structure, but... - reuse tools/code that already exist to parse. - easier to document/consume. - Must follow escaping/encoding guidelines - Can support 80k characters at least.

12 Using URLs - URLs can be triggered like any links - Link embedded on a webpage - Programmatically two important methods: [[UIApplication sharedapplication] canopenurl:(nsurl *)url]; [[UIApplication sharedapplication] openurl:(nsurl *)url];

13 What happens? When a custom URL is opened... - Source app is backgrounded. - Target app is launched (or foregrounded) - Target AppDelegate is notified with a URL, using... - (BOOL)application:(UIApplication *)application openurl:(nsurl *)url sourceapplication:(nsstring *)sourceapplication annotation:(id)annotation

14 Part 2 - Why? Use cases

15 Testing if app is installed If you register a unique URL scheme, you give other apps a way to test if your app is installed. This includes your own apps...great for crosspromoting apps, without annoying people who have already downloaded.

16 Launching Without any additional work, registering a URL scheme gives apps a way to launch your app. See Launch Center Pro from App Cubby...

17 Launching with Context Have the user arrive at a specific place in your app... Facebook: fb://profile fb://events Tweetbot: tweetbot://post

18 Launching with Content Send some bit of string data to the target app. Drafts OmniFocus

19 Executing an Action Dial a phone number tel: Open this URL, Phone.app will launch and dial the number.

20 Two-Way Interaction - All these examples are one-way. Source App > Target App - What about 2-way? Source App > Target App > Source App - Callback URLs

21 Instapaper > Terminology > Instapaper terminology://x-callback-url/lookup? text=ceremony &x-source=instapaper &x-success=instapaper://

22 Instapaper > Terminology > Instapaper Terminology does the lookup Tap and Terminology will trigger the url in the x-success param x-source param provides friendly name for source

23 Two-Way with Data - Terminology Replace terminology://x-callback-url/replace? text=select &x-success=drafts://x-callback-url/replaceselection &x-source=drafts &x-cancel=drafts:// drafts://x-callback-url/replaceselection &replacewith=choose drafts://

24 Other Two-Way - izettle - Credit Card Transactions - Scanner Go - Bar Code Scanning - Authorization - Dropbox SDK, Facebook SDK

25 What not to do with URLs - Destructive actions myapp://deleteeverything - If destructive, require user confirmation. - Think about HTTP GET RESTful actions.

26 Part 3 - How? Implementation

27 URLScheme Demo App Example app on Github

28 Consuming URLs

29 Building URLs #import "Scratchpad.h" #import "NSString+URLEncoding.h" // Category for Scratchpad - (void)examples { NSString *urlstring NSString *p1 World"; NSString *p2 re Awesome"; NSString *fullurlstring = [NSString stringwithformat:urlstring, [p1 urlencodeusingencoding:nsutf8stringencoding], [p2 urlencodeusingencoding:nsutf8stringencoding]]; NSURL *url = [NSURL URLWithString:fullURLString]; test://action? param1=hello%20world &param2=you%e2%80%99re%20awesome

30 Opening URLs if ([[UIApplication sharedapplication] canopenurl:url]) { [[UIApplication sharedapplication] openurl:url]; } - Use canopenurl to build UI, don t show things that can t be used. - canopenurl doesn t need full URLs, test with just scheme://

31 Providing URLs

32 Register scheme

33 Register in Info.plist

34 Valid URL Scheme Names - Sequence of characters beginning with a letter and followed by any combination of letters, digits, plus ("+"), period ("."), or hyphen ("-"). - NOT case sensitive.

35 Recommended URL Scheme Names - Your app name as it appears on the device, with hyphens in place of spaces. My App Name my-app-name://

36 Versioning If you provide actions that you need to version over time, register additional URLs x-app-api10:// x-app-api20:// Now you have a way to test for compatibility.

37 Reacting to URL On AppDelegate, define: - (BOOL)application:(UIApplication *)application openurl:(nsurl *)url sourceapplication:(nsstring *)sourceapplication annotation:(id)annotation; c - called after applicationwillenterforeground - called before applicationdidbecomeactive - return NO if you don t recognize the URL - (Nothing happens, just best practice)

38 ios 3 note... Prior to ios 4, you handled URLs in... - (BOOL)application:(UIApplication *)application handleopenurl:(nsurl *)url; If you need to support ios 3, implement this method and forward to your application: openurl: sourceapplication: annotation method.

39 Parsing Parameters myapp://actionname?test=param%20value&test2=paramvalue URLParser *parser = [[URLParser alloc] initwithurlstring:[url absolutestring]]; NSString *testparamvalue = [parser valueforvariable:@"test"]; // testparamvalue param value

40 Parsing Parameters If you parse using some other method, USE THIS METHOD TO DECODE!!! [str stringbyreplacingpercentescapesusingencoding:nsutf8stringencoding]

41 DEMO (unreheased, apologies in advance)

42 Part 4 X-Callback-URL

43 X-Callback-URL - Specification to standardize URL formats - Drafts, Terminology, Instapaper, Agenda, Due, icab Mobile, Poster, Phraseology, Notesy. - Collaboration of myself, Marco Arment with input from a few others.

44 X-Callback-URL format scheme://x-callback-url/[action]?[x-callback parameters]&[action parameters] - [action] is specific to your app/implementation and should typically be a verb. - [action parameters] are also specific to your app and show be in a URL query string...i.e.: subject=the%20subject&body=the%20body

45 X-Callback-URL Parameters x-source: Friendly name of source app. x-success: Base URL to fire if successful x-error: Base URL to fire if error occurs x-cancel: Base URL to fire if user cancels

46 Finally... - Why use URL schemes? Why not? - Why format them with X-Callback-URL? Why not? - Document what you implement!!!!!! - Use affiliate links to promote apps you integrate with!!!!! - UTF8 escape and decode parameters! - Test with Unicode chars and cold starts.

47 Resources Find URL schemes: Tutorial: - X-Callback-URL: - (sample apps/examples) URLSchemes Demo App: -

48 Q & Slides and Links: