<?xml version="1.0" encoding="utf-8"?>
<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>

  <p>Escreva e instale um arquivo desktop de forma que os usuários possam encontrar e iniciar seu aplicativo.</p>
  
  <p>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.</p>
  
  <p>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.</p>

  <p>Para um aplicativo hipotético <app>Meu aplicativo</app>, um arquivo desktop se pareceria com:</p>
  <example>
    <listing>
      <title><file>meuaplicativo.desktop</file></title>
<code>[Desktop Entry]
Name=Meu aplicativo
Exec=meuaplicativo
Type=Application
Icon=meuaplicativo
Comment=Faz o que o aplicativo faz
Categories=GTK;GNOME;Utility;</code>
    </listing>
  </example>

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

  <p>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 <code>Icon</code>. O <code>Comment</code> é uma breve descrição do aplicativo. Para ajudar usuários ao navegar por aplicativos, a chave <code>Categories</code> deve ser populada com uma lista de categorias, separada por um ponto-e-vírgula, da especificação de menu de Desktop.</p>

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