<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="dev-launching-desktop" xml:lang="pt-BR">

  <info>

    <link type="next" xref="dev-launching-icons"/>

    <revision version="0.1" date="2014-01-28" status="draft"/>

    <credit type="author">

      <name>David King</name>

      <email its:translate="no">davidk@gnome.org</email>

      <years>2014</years>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="cc-by-sa-3-0.xml"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Enrico Nicoletto</mal:name>

      <mal:email>liverig@gmail.com</mal:email>

      <mal:years>2009</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Rafael Fontenelle</mal:name>

      <mal:email>rafaelff@gnome.org</mal:email>

      <mal:years>2013, 2014, 2016, 2017</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Isaac Ferreira Filho</mal:name>

      <mal:email>isaacmob@riseup.net</mal:email>

      <mal:years>2018</mal:years>

    </mal:credit>

  </info>

  <title>Instalando um arquivo desktop</title>

  <links type="series" style="floatend">

    <title>Inicie seu aplicativo</title>

  </links>

  
Escreva e instale um arquivo desktop de forma que os usuários possam encontrar e iniciar seu aplicativo.

  
O GNOME usa a <link href="http://standards.freedesktop.org/desktop-entry-spec/latest/index.html">entrada de Desktop do freedesktop.org</link> e <link href="http://standards.freedesktop.org/menu-spec/latest/">a especificação do menu de Desktop</link> para descrever inicializadores de aplicativo. Instalar um arquivo desktop é a forma padrão para registrar seu aplicativo com GNOME e outras ambientes.

  
Um arquivo destkop lista o executável, nome e tipo do seu aplicativo, e também pode listar um ícone, descrição e várias outras informações sobre a execução de um aplicativo.

  
Para um aplicativo hipotético <app>Meu aplicativo</app>, um arquivo desktop se pareceria com:

  <example>

    <listing>

      <title><file>meuaplicativo.desktop</file></title>

[Desktop Entry]

Name=Meu aplicativo

Exec=meuaplicativo

Type=Application

Icon=meuaplicativo

Comment=Faz o que o aplicativo faz

Categories=GTK;GNOME;Utility;

    </listing>

  </example>

  
A linha [Desktop Entry] indica que esse é um arquivo desktop. Ela é seguida por chaves, que descrevem o inicializador do aplicativo. A chave Name é um nome legível do aplicativo, a ser mostrado na interface do usuário. O executável do aplicativo está listado na chave Exec, que pode estar com caminho completo ou um executável que pdoe ser encontrado no PATH. A última chave obrigatória é o Type, o que para aplicativos é sempre Application. Tipos alternativos são listados na especificação de entrada de desktop.

  
Outros campos no arquivo desktop são opcionais, mas recomendados. Aplicativos devem instalar um ícone e listar o nome do ícone (excluindo a extensão) na chave Icon. O Comment é uma breve descrição do aplicativo. Para ajudar usuários ao navegar por aplicativos, a chave Categories deve ser populada com uma lista de categorias, separada por um ponto-e-vírgula, da especificação de menu de Desktop.

  
Há diversas outras chaves que podem ser adicionadas aos arquivos destktop, os quais são listados e descritos na especificação de entrada Desktop.

</page>