No GNOME e em outros ambientes de área de trabalho compatíveis com freedesktop.org , como KDE e Unity , os aplicativos são adicionados aos menus ou shell da área de trabalho por meio de entradas da área de trabalho , definidas em arquivos de texto com a .desktop
extensão (referidos como arquivos da área de trabalho ). Os ambientes da área de trabalho constroem menus para um usuário a partir das informações combinadas extraídas das entradas disponíveis na área de trabalho.
Os arquivos da área de trabalho podem ser criados em um dos dois locais:
/usr/share/applications/
para entradas da área de trabalho disponíveis para todos os usuários no sistema
~/.local/share/applications/
para entradas da área de trabalho disponíveis para um único usuário
Pode ser necessário reiniciar o GNOME para que os novos aplicativos adicionados funcionem.
Por convenção, os arquivos da área de trabalho não devem incluir espaços ou caracteres internacionais em seus nomes.
Cada arquivo da área de trabalho é dividido em grupos , cada um começando com o cabeçalho do grupo entre colchetes ( []
). Cada seção contém um número de pares de chave e valor , separados por um sinal de igual ( =
).
Abaixo está um exemplo de arquivo da área de trabalho:
[Desktop Entry]
Type=Application
Encoding=UTF-8
Name=Application Name
Comment=Application description
Icon=/path/to/icon.xpm
Exec=/path/to/application/executable
Terminal=false
Categories=Tags;Describing;Application
Explicação
[Desktop Entry]
o Desktop Entry
cabeçalho do grupo identifica o arquivo como uma entrada na área de trabalho
Type
o tipo de entrada, os valores válidos são Application
, Link
eDirectory
Encoding
a codificação de caracteres do arquivo da área de trabalho
Name
o nome do aplicativo visível em menus ou lançadores
Comment
uma descrição do aplicativo usado nas dicas de ferramentas
Icon
o ícone mostrado para o aplicativo em menus ou lançadores
Exec
o comando usado para iniciar o aplicativo a partir de um shell.
Terminal
se o aplicativo deve ser executado em um terminal, valores válidos são true
oufalse
Categories
;
lista separada por ponto e vírgula ( ) de categorias de menu nas quais a entrada deve ser exibida
Os argumentos da linha de comando na Exec
chave podem ser significados com as seguintes variáveis:
%f
um único nome de arquivo.
%F
vários nomes de arquivos.
%u
um único URL.
%U
vários URLs.
%d
um único diretório. Usado em conjunto com %f
para localizar um arquivo.
%D
vários diretórios. Usado em conjunto com %F
para localizar arquivos.
%n
um único nome de arquivo sem um caminho.
%N
vários nomes de arquivos sem caminhos.
%k
um URI ou nome de arquivo local do local do arquivo da área de trabalho.
%v
o nome da entrada do dispositivo.
Observe que ~
ou variáveis de ambiente como $HOME
não são expandidas nos arquivos da área de trabalho, portanto, qualquer executável referenciado deve estar no $PATH
ou referenciado por seu caminho absoluto.
Uma especificação completa de entrada da área de trabalho está disponível no GNOME Dev Center .
Scripts de lançamento
Se o aplicativo a ser iniciado exigir que determinadas etapas sejam executadas antes da chamada, você poderá criar um script de shell que inicie o aplicativo e aponte a entrada da área de trabalho para o script de shell. Suponha que um aplicativo precise ser executado a partir de um determinado diretório de trabalho atual. Crie um script de inicialização em um local adequado ( ~/bin/
por exemplo). O script pode se parecer com o seguinte:
#!/bin/bash
pushd "/path/to/application/directory"
./application "$@"
popd
Defina o bit executável para o script:
$ chmod +x ~/bin/launch-application
Aponte a Exec
chave na entrada da área de trabalho para o script de inicialização:
Exec=/home/user/bin/launch-application