Originally Posted by conny

Hi everyone!

I already asked this on the devel-list, but got now answer. Maybe someone here knows an answer...

Is it possible to register my application as an URL handler?
What I would like to do is that whenever a user who is using the browser clicks on a link like myapp://abcdefg my application is launched.

Hints and tips would be very welcome

Thanks!
Conny

Originally Posted by qwerty12

some entries in its desktop file saying what protocols it supports, what method name it should call when opening the file etc.

Originally Posted by lma

I think you need to use libhildonmime (see /usr/share/applications/uri-action-defaults.list in particular) but it's undocumented (bug 3890)

Originally Posted by conny

Thanks again, it works just fine. Here's a small guide

First you should modify your .desktop file. Add a X-Osso-URI-Actions line to the Desktop Entry group and add a X-Osso-URI-Action Handler group to the same file.

Let's say we want to register an url handler for conboy:// urls, our .desktop file would looks somehow like that:

Code:

[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

Now in code you need a callback and you need to register it. The callback needs a signature like that:

Code:

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

Register the callback like this:

Code:

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");
}

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"

Oh and after changing the .desktop file, don't forget to call update-desktop-database

Originally Posted by lassileevi

Are these really the only steps that are required? I have tried this without success so far. Am I missing URI protocol prefix MIME-type registration or something?