URL Handler - Revision history

dneary at 14:20, 19 October 2010

2010-10-19T14:20:42Z

← Older revision		Revision as of 14:20, 19 October 2010
Line 8:		Line 8:

	Up to date revision:		Up to date revision:
-	: '''[[~~{{PAGENAME}}~~/API_rev2\|Hildon URI API, revision 2]]'''	+	: '''[[/API_rev2\|Hildon URI API, revision 2]]'''
	Revision 2 is based on:		Revision 2 is based on:
-	:'''[[~~{{PAGENAME}}~~/API_rev1\|Hildon URI API, revision 1]]'''	+	: '''[[/API_rev1\|Hildon URI API, revision 1]]'''

	This information might be needed to understand the following example.		This information might be needed to understand the following example.

amigadave: tidy, use

2010-06-24T13:56:52Z

tidy, use <source>

← Older revision		Revision as of 13:56, 24 June 2010
Line 4:		Line 4:

	== Hildon URI API ==		== Hildon URI API ==
		+
	The most updated revision of the API is revision 2, but it bases on the first revision. So please take both documents into account. The API descriptions, with some examples you will find here:		The most updated revision of the API is revision 2, but it bases on the first revision. So please take both documents into account. The API descriptions, with some examples you will find here:

Line 14:		Line 15:

	== Example ==		== Example ==
		+
	The example is based on a discussion in [http://talk.maemo.org/showthread.php?t=30772 talk.maemo.org] and gives an overview of the result of the discussion. Conboy is used as an example application, with the goal to create an URL handler for "conboy://". The following steps has to be taken:		The example is based on a discussion in [http://talk.maemo.org/showthread.php?t=30772 talk.maemo.org] and gives an overview of the result of the discussion. Conboy is used as an example application, with the goal to create an URL handler for "conboy://". The following steps has to be taken:

	* '''Modification of the .desktop file'''		* '''Modification of the .desktop file'''
	:Add a X-Osso-URI-Actions line to the Desktop Entry group and add a X-Osso-URI-Action Handler group. For example:		:Add a X-Osso-URI-Actions line to the Desktop Entry group and add a X-Osso-URI-Action Handler group. For example:
		+	<pre>
		+	[Desktop Entry]
		+	Encoding=UTF-8
		+	Version=1.0
		+	Type=Application
		+	Name=Conboy
		+	Exec=@prefix@/bin/conboy
		+	Icon=conboy
		+	X-Window-Icon=conboy
		+	X-Window-Icon-Dimmed=conboy
		+	X-Osso-Service=de.zwong.conboy
		+	X-Osso-Type=application/x-executable
		+	X-Osso-URI-Actions=conboy

-	~~[Desktop Entry]~~	+	[X-Osso-URI-Action Handler conboy]
-	~~Encoding=UTF-8~~	+	Method=load_url
-	~~Version=1.0~~	+	Name=some_name
-	~~Type=Application~~	+	TranslationDomain=conboy
-	~~Name=Conboy~~	+	</pre>
-	~~Exec=@prefix@/bin/conboy~~	+
-	~~Icon=conboy~~	+
-	~~X-Window-Icon=conboy~~	+
-	~~X-Window-Icon-Dimmed=conboy~~	+
-	~~X-Osso-Service=de.zwong.conboy~~	+
-	~~X-Osso-Type=application/x-executable~~	+
-	~~X-Osso-URI-Actions=conboy~~	+
-		+
-	[X-Osso-URI-Action Handler conboy]	+
-	Method=load_url	+
-	Name=some_name	+
-	TranslationDomain=conboy	+
-		+
	:'''Important:''' Set a value for all three keys ('Method', 'Name' and 'TranslationDomain') otherwise it won't work. Still, the only value of these that you get passed to your callback function is the value of 'Method'.		:'''Important:''' Set a value for all three keys ('Method', 'Name' and 'TranslationDomain') otherwise it won't work. Still, the only value of these that you get passed to your callback function is the value of 'Method'.

Line 44:		Line 46:

	* '''Implement a callback in your code:'''		* '''Implement a callback in your code:'''
-		+	<source lang="c">
-	gint dbus_handler(const gchar *interface,	+	gint dbus_handler(const gchar *interface,
-	const gchar *method,	+	const gchar *method,
-	GArray *arguments,	+	GArray *arguments,
-	gpointer data,	+	gpointer data,
-	osso_rpc_t *retval);	+	osso_rpc_t *retval);
-		+	</source>
	* '''Register the callback:'''		* '''Register the callback:'''
-		+	<source lang="c">
-	if (osso_rpc_set_cb_f(osso_context,	+	if (osso_rpc_set_cb_f(osso_context,
-	"de.zwong.conboy",	+	"de.zwong.conboy",
-	"/de/zwong/conboy",	+	"/de/zwong/conboy",
-	"de.zwong.conboy",	+	"de.zwong.conboy",
-	dbus_handler,	+	dbus_handler,
-	NULL) != OSSO_OK) {	+	NULL) != OSSO_OK) {
-	g_printerr("Failed to set callback\n");	+	g_printerr("Failed to set callback\n");
-	}	+	}
-		+	</source>
	* '''Call it from the browser:'''		* '''Call it from the browser:'''
	:Now lets assume in the browser we click on the following link:		:Now lets assume in the browser we click on the following link:

timeless: spelling

2009-11-21T17:11:14Z

spelling

← Older revision		Revision as of 17:11, 21 November 2009
Line 1:		Line 1:
	The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url: test://foo Therefore it provides:		The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url: test://foo Therefore it provides:
-	* ~~Descrition~~ of the Hildon URI API	+	* Description of the Hildon URI API
	* Step-by-step example based on the implementation of Cornelius Hald		* Step-by-step example based on the implementation of Cornelius Hald

danielwilms: /* URL Handler */

2009-08-31T13:54:09Z

URL Handler

← Older revision		Revision as of 13:54, 31 August 2009
Line 1:		Line 1:
-	~~= URL Handler =~~
	The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url: test://foo Therefore it provides:		The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url: test://foo Therefore it provides:
	* Descrition of the Hildon URI API		* Descrition of the Hildon URI API

danielwilms at 13:52, 31 August 2009

2009-08-31T13:52:09Z

← Older revision		Revision as of 13:52, 31 August 2009
Line 72:		Line 72:
	method = "load_url"		method = "load_url"
	first element of arguments = "conboy://1234567"		first element of arguments = "conboy://1234567"
		+
		+	[[Category:Development]]

danielwilms: New page: = URL Handler = The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url...

2009-08-31T13:50:54Z

New page: = URL Handler = The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url...

New page

= URL Handler =
The main purpose of the wiki page is to describe the way to register an application as URL handler. The idea is, that an application test would be launched by using the url: test://foo Therefore it provides:
* Descrition of the Hildon URI API
* Step-by-step example based on the implementation of Cornelius Hald

== Hildon URI API ==
The most updated revision of the API is revision 2, but it bases on the first revision. So please take both documents into account. The API descriptions, with some examples you will find here:

Up to date revision:
: '''[[{{PAGENAME}}/API_rev2|Hildon URI API, revision 2]]'''
Revision 2 is based on:
:'''[[{{PAGENAME}}/API_rev1|Hildon URI API, revision 1]]'''

This information might be needed to understand the following example.

== Example ==
The example is based on a discussion in [http://talk.maemo.org/showthread.php?t=30772 talk.maemo.org] and gives an overview of the result of the discussion. Conboy is used as an example application, with the goal to create an URL handler for "conboy://". The following steps has to be taken:

* '''Modification of the .desktop file'''
:Add a X-Osso-URI-Actions line to the Desktop Entry group and add a X-Osso-URI-Action Handler group. For example:

[Desktop Entry]
Encoding=UTF-8
Version=1.0
Type=Application
Name=Conboy
Exec=@prefix@/bin/conboy
Icon=conboy
X-Window-Icon=conboy
X-Window-Icon-Dimmed=conboy
X-Osso-Service=de.zwong.conboy
X-Osso-Type=application/x-executable
X-Osso-URI-Actions=conboy

[X-Osso-URI-Action Handler conboy]
Method=load_url
Name=some_name
TranslationDomain=conboy

:'''Important:''' Set a value for all three keys ('Method', 'Name' and 'TranslationDomain') otherwise it won't work. Still, the only value of these that you get passed to your callback function is the value of 'Method'.

* '''Update the changes in your .desktop file:'''

update-desktop-database

* '''Implement a callback in your code:'''

gint dbus_handler(const gchar *interface,
const gchar *method,
GArray *arguments,
gpointer data,
osso_rpc_t *retval);

* '''Register the callback:'''

if (osso_rpc_set_cb_f(osso_context,
"de.zwong.conboy",
"/de/zwong/conboy",
"de.zwong.conboy",
dbus_handler,
NULL) != OSSO_OK) {
g_printerr("Failed to set callback\n");
}

* '''Call it from the browser:'''
:Now lets assume in the browser we click on the following link:
conboy://1234567

:In this case the application is started and the provided callback is called with the following parameters.

interface = "de.zwong.conboy"
method = "load_url"
first element of arguments = "conboy://1234567"