Ir para o conteúdo

Ativar o registo no SMath Studio

Perante um problema ou um comportamento inesperado no SMath Studio, ativar o registo integrado ajuda a diagnosticá-lo. O ficheiro de registo recolhe informação de rastreio detalhada que o utilizador (ou o seu fornecedor de software) pode usar para identificar a causa do problema.

Pré-requisitos

Localize onde o SMath Studio está instalado:

  • Instalação por máquina: C:\Program Files (x86)\SMath\ (ou semelhante)
  • Instalação por utilizador: a pasta do seu perfil de utilizador (p. ex., C:\Users\<OSeuNome>...)

Ativar o registo

  1. Feche todas as instâncias do SMath Studio. Certifique-se de que todos os processos do SMath Studio estão fechados antes de editar o ficheiro de configuração.
  2. Navegue até à pasta de instalação do SMath Studio e abra o ficheiro Solver.exe.config num editor de texto (p. ex., o Bloco de Notas). Nota: se o SMath Studio foi instalado por máquina, poderão ser necessárias permissões de administrador para modificar este ficheiro. Clique com o botão direito do rato no editor de texto e escolha Run as administrator.

  3. Retire os comentários dos blocos de registo. O ficheiro contém dois blocos que estão comentados por predefinição. É necessário remover os marcadores de comentário XML (<!-- e -->) para que a configuração fique ativa.

    Segue-se o conteúdo predefinido (comentado) -- tanto os elementos <source> como o elemento de escuta <add> estão dentro de comentários:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.diagnostics>
    <sources>
      <!--
        The name attribute of <source> element is split by dot in order to build the hierarchy of sources for loggers.
        The source with name="root" defines the root in the hierarchy.
        Use attribute newSwitch="true" in order to redefine the switch for the related source and its descendants.
        Use attribute newListeners="true" in order to redefine the listeners for the related source and its descendants.
        Supported values of attribute switchValue in order of verbosity: "Off" (default), "Critical", "Error", "Warning", "Information", "Verbose"
      -->
      <!--
      <source name="root">
        <listeners>
          <add name="file" />
        </listeners>
      </source>
      <source name="SMath.Controls" newSwitch="true" switchValue="Error" />
      <source name="SMath.Environment" newSwitch="true" switchValue="Error" />
      <source name="SMath.Document" newSwitch="true" switchValue="Error" />
      <source name="SMath.Manager" newSwitch="true" switchValue="Error" />
      <source name="SMath.UI" newSwitch="true" switchValue="Error" />
      -->
    </sources>
    <sharedListeners>
      <!-- Writes trace to file -->
      <!--
      <add name="file"
           type="SMath.Manager.Logging.FileTraceListener, SMath.Manager"
           traceOutputOptions="DateTime,ProcessId,ThreadId"
           initializeData="%APPDATA%\SMath\Solver.log"/>
      -->
    </sharedListeners>
    <trace autoflush="true" indentsize="4" />
  </system.diagnostics>
</configuration>

    Retire os comentários dos dois blocos XML que contêm a configuração propriamente dita (os elementos <source> e o elemento de escuta <add>), mas mantenha o comentário descritivo (o primeiro bloco de comentário, que contém texto explicativo). Depois de retirar os comentários, o ficheiro deverá ficar assim:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.diagnostics>
    <sources>
      <!--
        The name attribute of <source> element is split by dot in order to build the hierarchy of sources for loggers.
        The source with name="root" defines the root in the hierarchy.
        Use attribute newSwitch="true" in order to redefine the switch for the related source and its descendants.
        Use attribute newListeners="true" in order to redefine the listeners for the related source and its descendants.
        Supported values of attribute switchValue in order of verbosity: "Off" (default), "Critical", "Error", "Warning", "Information", "Verbose"
      -->
      <source name="root">
        <listeners>
          <add name="file" />
        </listeners>
      </source>
      <source name="SMath.Controls" newSwitch="true" switchValue="Error" />
      <source name="SMath.Environment" newSwitch="true" switchValue="Error" />
      <source name="SMath.Document" newSwitch="true" switchValue="Error" />
      <source name="SMath.Manager" newSwitch="true" switchValue="Error" />
      <source name="SMath.UI" newSwitch="true" switchValue="Error" />
    </sources>
    <sharedListeners>
      <!-- Writes trace to file -->
      <add name="file"
           type="SMath.Manager.Logging.FileTraceListener, SMath.Manager"
           traceOutputOptions="DateTime,ProcessId,ThreadId"
           initializeData="%APPDATA%\SMath\Solver.log"/>
    </sharedListeners>
    <trace autoflush="true" indentsize="4" />
  </system.diagnostics>
</configuration>

    Sugestão: retire os comentários apenas dos elementos XML que contêm estruturas XML aninhadas (os elementos <source> e <add>). O texto puramente descritivo deve manter-se como comentário.

  4. Guarde o ficheiro Solver.exe.config modificado e feche o editor de texto.

  5. Abra o SMath Studio e repita os passos que provocaram o problema. A aplicação passa a escrever o rastreio no ficheiro de registo.
  6. Obtenha o ficheiro de registo. Navegue até à pasta de registos (não são necessárias permissões de administrador): %APPDATA%\SMath\ (prima Win+R, escreva o caminho e prima Enter para a abrir rapidamente). O ficheiro de registo é Solver.log.
  7. Analise o registo. Abra Solver.log num editor de texto e desloque-se até às últimas linhas -- as entradas mais recentes são, normalmente, onde o problema fica registado. Identifique a mensagem de erro ou exceção por si próprio, ou anexe o ficheiro de registo (ou a sua parte relevante) a um pedido de suporte ao seu fornecedor de software.

Desativar o registo

Depois de resolvido o problema ou de partilhado o registo, recomenda-se voltar a desativar o registo:

  1. Feche o SMath Studio.
  2. Volte a comentar os dois blocos XML em Solver.exe.config (reponha o estado original mostrado acima).
  3. Guarde o ficheiro.
  4. Opcionalmente, elimine %APPDATA%\SMath\Solver.log para fazer limpeza.

Nota: manter o registo ativo faz com que o ficheiro Solver.log cresça sem controlo ao longo do tempo, ocupando espaço em disco e podendo tornar mais lentas as operações com ficheiros. Repor o estado predefinido (comentado) depois de concluído o diagnóstico é uma boa prática.