NSURL: Difference between revisions

Revision as of 16:11, 5 November 2009

NSURL is a class that holds an URL.

Pre-registered URL scheme

There are a bunch of URL schemes reserved within iPhoneOS. You cannot register these schemes in your app.

Scheme	Form	Handler	Public	Usage
ftp	-	MobileSafari	Yes	File transfer protocol.
http	-	MobileSafari	Yes	Hypertext transfer protocol.
https	-	MobileSafari	Yes	HTTP Secure.
feed	[1]	MobileSafari	Yes	Web Feed.
feeds	-	MobileSafari	Yes	Web Feed?
calshow	?	MobileCal	Unknown	?
calinvite	?	MobileCal	Unknown	?
calinvitelist	?	MobileCal	Unknown	?
mailto	[2]	MobileMail	Yes	Sending emails.
sms	`sms:`phoneNumber	MobileSMS	Yes	Sending SMS.
tel	`tel:`phoneNumber	MobilePhone	Yes	Telephone.
telprompt	?	MobilePhone	Yes	Telephone with prompt. (?)
callto	?	MobilePhone	Unknown	?
telshow	?	MobilePhone	Unknown	?
tellock	?	MobilePhone	Unknown	?
telanswer	?	MobilePhone	Unknown	?
telemergency	?	MobilePhone	Unknown	?
vmshow	?	MobilePhone	Unknown	?
maps	`maps:`params	Maps	Yes	Maps. URLs of this type can be interpreted as `http://maps.google.com/maps?`params.
prefs	`prefs:`params	Preferences	No	Preferences. params can be like `root=General&path=About`.
youtube	`youtube:`videoID	YouTube	Yes	YouTube video. URLs of this type can be interpreted as `http://www.youtube.com/v/`videoID.
itms	-	MobileStore	Yes	iTunes Music Store.
itmss	-	MobileStore	Yes	?
itms-apps	-	AppStore	Yes	?
itms-appss	-	AppStore	Yes	?
webcal	[3]	SpringBoard	Yes	WebCal
doubletap	`doubletap://`displayID	SpringBoard	No	The application will be launched when user double tapped the home button.
search	`search://`displayID`/`domain`/`identifier	SpringBoard	No	?
rdar	`rdar:`url	MobileSafari	Yes	Radars (bug reporter). URLs of this type can be interpreted as `https://bugreport.apple.com/cgi-bin/WebObjects/RadarWeb.woa/wa/openURL?url=`url.
radar	`radar:`url	MobileSafari	Yes	Radars (bug reporter). Equivalent to `rdar:`.
javascript	-	MobileSafari	No	Execute Javascript. Can only be used in MobileSafari.
ff	`ff:`param	FriendFinderApp	Unknown	Friend finder URL. Not usable yet.
springboard	`springboard:/`command	SpringBoard	No	SpringBoard command. Only referred in `-[UIApplication _runSpringboardCommand:]`.

References

Official reference: NSURL
Apple URL Scheme Reference: http://developer.apple.com/safari/library/featuredarticles/iPhoneURLScheme_Reference/Introduction/Introduction.html
UIKit additions: http://github.com/kennytm/iphone-private-frameworks/blob/master/UIKit/NSURL.h

@@ Line 48: / Line 48: @@
 |-
 | maps || <tt>maps:</tt>''params'' || {{applink|Maps}} || {{yes}}
-| Maps. URLs of this type can be interpreted as <tt>http://maps.google.com/maps?</tt>''params''.
+| Maps. URLs of this type can be interpreted as <tt><nowiki>http://maps.google.com/maps?</nowiki></tt>''params''.
 |-
 | prefs || <tt>prefs:</tt>''params'' || {{applink|Preferences}} || {{no}}
@@ Line 54: / Line 54: @@
 |-
 | youtube || <tt>youtube:</tt>''videoID'' || {{applink|YouTube}} || {{yes}}
-| YouTube video. URLs of this type can be interpreted as <tt>http://www.youtube.com/v/</tt>''videoID''.
+| YouTube video. URLs of this type can be interpreted as <tt><nowiki>http://www.youtube.com/v/</nowiki></tt>''videoID''.
 |-
 | itms || - || {{applink|MobileStore}} || {{yes}}
@@ Line 76: / Line 76: @@
 |-
 | rdar || <tt>rdar:</tt>''url'' || {{applink|MobileSafari}} || {{yes}}
-| Radars (bug reporter). URLs of this type can be interpreted as <tt>https://bugreport.apple.com/cgi-bin/WebObjects/RadarWeb.woa/wa/openURL?url=</tt>''url''.
+| Radars (bug reporter). URLs of this type can be interpreted as <tt><nowiki>https://bugreport.apple.com/cgi-bin/WebObjects/RadarWeb.woa/wa/openURL?url=</nowiki></tt>''url''.
 |-
 | radar || <tt>radar:</tt>''url'' || {{applink|MobileSafari}} || {{yes}}