Handling URL Schemes
Syntax#
-
// canOpenURL method verifies if there is any app which can handle indicated URL scheme.
-
// Swift
UIApplication.sharedApplication().canOpenURL(_ aUrl: NSURL)
-
// Objective-C
[[UIApplication sharedApplication] canOpenURL:(NSURL *)aUrl];
-
// openURL method tries to open a resource located by URL. YES/true if it was opened otherwise NO/false.
-
// Swift
UIApplication.sharedApplication().openURL(_ aUrl: NSURL)
-
// Objective-C
[[UIApplication sharedApplication] openURL:(NSURL *)aUrl];
Parameters#
Parameter | Meaning |
---|---|
aUrl | a NSURL instance which stores a built-in or custom scheme string |
Remarks#
In iOS9 and above your app must list any URL schemes it will want to query. This is done by adding LSApplicationQueriesSchemes
to Info.plist
iOS has built-in support for the tel
, http
/https
,sms
, mailto
, facetime
schemes. It also supports http–based URLs for Youtube
, Maps
and iTunes
apps.
Examples of built-in URL schemes:
tel: tel://123456890
or tel:123456890
http: https://www.google.com
facetime: facetime://azimov@demo.com
mailto: mailto://azimov@demo.com
sms: sms://123456890
or sms:123456890
Youtube: https://www.youtube.com/watch?v=-eCaif2QKfA
Maps:
-
Using address:
https://maps.apple.com/?address=1,Infinite+Loop,Cupertino,California
-
Using coordinates:
https://maps.apple.com/?ll=46.683155557,6.683155557
iTunes: https://itunes.apple.com/us/artist/randy-newman/id200900
Note: Not all special characters are supported in tel
scheme (for example *
or #
). This is done because of security concerns to prevent users from unauthorized redirect of calls, so in this case Phone
app won’t be opened.
Using built-in URL scheme to open Mail app
Swift:
if let url = URL(string: "mailto://azimov@demo.com") {
if UIApplication.shared.canOpenURL(url) {
UIApplication.shared.openURL(url)
} else {
print("Cannot open URL")
}
}
Objective-C:
NSURL *url = [NSURL URLWithString:@"mailto://azimov@demo.com"];
if ([[UIApplication sharedApplication] canOpenURL:url]) {
[[UIApplication sharedApplication] openURL:url];
} else {
NSLog(@"Cannot open URL");
}
Apple URL Schemes
These are URL schemes supported by native apps on iOS, OS X, and watchOS 2 and later.
Opening link in Safari:
Objective-C
NSString *stringURL = @"https://stackoverflow.com/";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];
Swift:
let stringURL = "https://stackoverflow.com/"
if let url = URL(string: stringURL) {
UIApplication.shared.openURL(url)
}
Starting a phone conversation
Objective-C
NSString *stringURL = @"tel:1-408-555-5555";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];
Swift:
let stringURL = "tel:1-408-555-5555"
if let url = URL(string: stringURL) {
UIApplication.shared.openURL(url)
}
HTML
<a href="tel:1-408-555-5555">1-408-555-5555</a>
Starting a FaceTime conversation
Objective-C
NSString *stringURL = @"facetime:14085551234";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];
Swift:
let stringURL = "facetime:14085551234"
if let url = URL(string: stringURL) {
UIApplication.shared.openURL(url)
}
HTML
<a href="facetime:14085551234">Connect using FaceTime</a>
<a href="facetime:user@example.com">Connect using FaceTime</a>
Opening Messages App to compose an sms to recipient:
Objective-C
NSString *stringURL = @"sms:1-408-555-1212";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];
Swift:
let stringURL = "sms:1-408-555-1212"
if let url = URL(string: stringURL) {
UIApplication.shared.openURL(url)
}
HTML
<a href="sms:">Launch Messages App</a>
<a href="sms:1-408-555-1212">New SMS Message</a>
Opening Mail app to compose an email to recipient:
Objective-C
NSString *stringURL = @"mailto:foo@example.com";
NSURL *url = [NSURL URLWithString:stringURL];
[[UIApplication sharedApplication] openURL:url];
Swift:
let stringURL = "mailto:foo@example.com"
if let url = URL(string: stringURL) {
UIApplication.shared.openURL(url)
}
HTML
<a href="mailto:frank@wwdcdemo.example.com">John Frank</a>
You can also include a subject field, a message, and multiple recipients in the To, Cc, and Bcc fields. (In iOS, the from attribute is ignored.) The following example shows a mailto URL that includes several different attributes:
mailto:foo@example.com?cc=bar@example.com&subject=Greetings%20from%20Cupertino!&body=Wish%20you%20were%20here!
Note: Compose email dialog can also be presented within app using MFMailComposeViewController
.