<?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="gsettings-browse" xml:lang="pt-BR">

  <info>
    <link type="guide" xref="setup"/>
    <link type="seealso" xref="dconf"/>
    <link type="seealso" xref="overrides"/>
    <revision pkgversion="3.30" date="2019-02-08" status="draft"/>

    <credit type="author copyright">
      <name>Matthias Clasen</name>
      <email>matthias.clasen@gmail.com</email>
      <years>2012</years>
    </credit>
    <credit type="author copyright">
      <name>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
      <years>2012</years>
    </credit>
    <credit type="editor">
      <name>Petr Kovar</name>
      <email>pknbe@volny.cz</email>
      <years>2019</years>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Que ferramenta posso usar para explorar as configurações do sistema e do aplicativo?</desc>
  
    <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>2017-2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Leônidas Araújo</mal:name>
      <mal:email>leorusvellt@hotmail.com</mal:email>
      <mal:years>2023</mal:years>
    </mal:credit>
  </info>

  <title>Procurando valores de GSettings para seus aplicativos</title>

  <p>Existem duas ferramentas que você pode usar para procurar as preferências do sistema e do aplicativo armazenadas como valores de GSettings, o utilitário gráfico <app>dconf-editor</app> e o utilitário de linha de comando <cmd>gsettings</cmd>.</p>

  <p>Tanto o <app>dconf-editor</app> quanto o <cmd>gsettings</cmd> também permite que você altere as preferências para o usuário atual.</p>

  <note style="warning"><p>Observe que essas ferramentas sempre operam usando o banco de dados GSettings do usuário atual, portanto, você não deve executar esses aplicativos como root.</p>
  
  <p>Tanto o <app>dconf-editor</app> quanto o <cmd>gsettings</cmd> precisam de um barramento de sessão D-Bus para fazer alterações. Isso ocorre porque o daemon <sys>dconf</sys> deve ser ativado usando o D-Bus.</p>

  <p>Você pode obter o barramento de sessão necessário executando <cmd>gsettings</cmd> no utilitário <sys>dbus-launch</sys>, desta forma:</p>

  <screen><output>$ </output><input>dbus-launch gsettings set org.gnome.desktop.background draw-background true</input></screen>
  </note>

  <p><app>dconf-editor</app> pode ser melhor de usar se você não estiver familiarizado com as opções disponíveis em um aplicativo. Ele mostra a hierarquia de configurações em uma exibição em árvore e também exibe informações adicionais sobre cada configuração, incluindo a descrição, o tipo e o valor padrão.</p>

  <p><cmd>gsettings</cmd> é mais poderoso que o <app>dconf-editor</app>. A completação do bash é fornecida para <cmd>gsettings</cmd> e você pode escrever scripts que incluam comandos <cmd>gsettings</cmd> para configuração automatizada.</p>

  <p>Para uma lista completa das opções <cmd>gsettings</cmd>, veja a página man <link its:translate="no" href="man:gsettings"><cmd>gsettings</cmd>(1)</link>.</p>

</page>
