<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2. Url handler</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.3.2" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="AppStream-AppStream-0.11-en-US-0.0-0" /><link rel="home" href="index.html" title="AppStream" /><link rel="up" href="chap-AppStream-Services.html" title="Chapter 5. Services" /><link rel="prev" href="chap-AppStream-Services.html" title="Chapter 5. Services" /><link rel="next" href="chap-AppStream-ManualPages.html" title="Chapter 6. Manual pages" /></head><body><p id="title"><a class="left" href="http://www.freedesktop.org/wiki/Distributions/AppStream/"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="http://www.freedesktop.org/software/appstream/docs/"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="chap-AppStream-Services.html"><strong>Prev</strong></a></li><li class="home">AppStream</li><li class="next"><a accesskey="n" href="chap-AppStream-ManualPages.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="sect-AppStream-Services-UrlHandler">
</a>5.2. Url handler</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="spec-asurl-introduction">
</a>5.2.1. Introduction</h3></div></div></div><div class="para">
In order to allow installation of AppStream components from websites, software-centers implementing AppStream may choose to also support the <code class="literal">appstream://</code> urls.
</div><div class="para">
This allows upstream projects to trigger an installation of their application from their homepage on any supporting distribution. It also is helpful for web-based software-centers.
</div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="spec-asurl-schema">
</a>5.2.2. URL schema</h3></div></div></div><div class="para">
Software-centers handling <code class="literal">appstream://</code> URLs must provide a handler for the <code class="literal">x-scheme-handler/appstream</code> mimetype. An AppStream URL follows the schema <code class="code">appstream:%{component-id}</code>.
</div><div class="para">
Example HTML code:
</div><pre class="programlisting"><span xmlns="" class="line"></span><span xmlns="" class="perl_Keyword"><a</span><span xmlns="" class="perl_Others"> href=</span><span xmlns="" class="perl_String">"appstream:org.kde.discover.desktop"</span><span xmlns="" class="perl_Keyword">></span>Install KDE Discover<span xmlns="" class="perl_Keyword"></a></span>
<span xmlns="" class="line"></span><span xmlns="" class="perl_Keyword"><a</span><span xmlns="" class="perl_Others"> href=</span><span xmlns="" class="perl_String">"appstream:org.gnome.Software.desktop"</span><span xmlns="" class="perl_Keyword">></span>Install GNOME-Software<span xmlns="" class="perl_Keyword"></a></span>
<span xmlns="" class="line"></span><span xmlns="" class="perl_Keyword"><a</span><span xmlns="" class="perl_Others"> href=</span><span xmlns="" class="perl_String">"appstream:org.freedesktop.AppStream"</span><span xmlns="" class="perl_Keyword">></span>Install libappstream<span xmlns="" class="perl_Keyword"></a></span></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="spec-asurl-button">
</a>5.2.3. AppStream Buttons</h3></div></div></div><div class="para">
If you want to allow users to open your software in their local software center from your website, you might want to use one of the easily recognizable AppStream buttons for your <code class="code">appstream:</code> link.
</div><div class="mediaobject"><object data="images/appstream-button1.svg" type="image/svg+xml"><img src="images/appstream-button1.png" alt="" /></object><div class="caption"><div class="para">
<a href="https://github.com/ximion/appstream/blob/master/docs/sources/images/appstream-button1.svg">SVG</a>
</div></div></div><div class="mediaobject"><object data="images/appstream-button2.svg" type="image/svg+xml"><img src="images/appstream-button2.png" alt="" /></object><div class="caption"><div class="para">
<a href="https://github.com/ximion/appstream/blob/master/docs/sources/images/appstream-button2.svg">SVG</a>
</div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="chap-AppStream-Services.html"><strong>Prev</strong>Chapter 5. Services</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="chap-AppStream-ManualPages.html"><strong>Next</strong>Chapter 6. Manual pages</a></li></ul></body></html>
