Passos iniciais antes de submeter um relatório de erros (bug)

From The Document Foundation Wiki
< QA
Jump to navigation Jump to search
This page is a translated version of the page QA/FirstSteps and the translation is 30% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎dansk • ‎italiano • ‎português do Brasil

Passo primordial: reproduzir o erro com a versão nova ou versão estável mais recente

Os dois últimos releases, LibreOffice Novo e LibreOffice Estável (LibreOffice 7.3.3/LibreOffice 7.2.7) são ambos atualizados regularmente com consertos de erros. Se sua versão não é a última versão, o bug a reportar pode já ter sido consertado. Atualize primeiro sua instalação LibreOffice, e verifique se o problema continua.

Você também pode instalar uma versão nova sem romper com a instalação existente como descrito aqui: Installing in parallel.

NOTA: Se o problema não desaparecer, utilize o número da versão original no campo Versão do relatório de erro, que é para a versão mais recente.

Perfil de usuário corrompido

Sintomas:

  • Quase todo comportamento inesperado (especialmente se o LibreOffice tiver sido atualizado muitas vezes).

Passos a seguir:

  1. Localize seu perfil de usário.
  2. Renomeie ou exclua o perfil de usuário.

Para mais detalhes, veja Local do perfil do usuário and Resolver perfil de usuário corrompido (fazer uma cópia de segurança do perfil é fortemente recomendado).

NOTA: Problemas de corrupção do perfil são bastante difíceis de descobrir. A menos que o problema ocorra regularmente, ou você sabe os passos para reproduzir o problema, não vale a pena submeter um relatório de erro. Entretanto, se não estiver com certeza, não hesite eum submeter o relatório.

Problemas de placas gráficas (OpenGL)

Sintomas:

  • Erros na representação do LibreOffice.
  • Panes.

Verifique se o texto seguinte aparece no comando Ajuda ▸ Sobre o LibreOffice: "Realizador da interface: GL".

Se aparecer "Realizador da interface: padrão" , significa que os problemas não são decorrentes do OpenGL, e o que segue abaixo não se aplica.

Passos a seguir:

  1. Verifique se você tem o último driver estável para sua placa de vídeo, pois inclui a parte OpenGL.
  2. Desmarque Ferramentas ▸ Opções... ▸ LibreOffice ▸ Exibir ▸ Utilizar OpenGL em toda a aplicação (após reiniciar).
  3. Reinicie o LibreOffice.

Problemas de cálculos no Calc (OpenCL)

Sintomas:

  • Resultados incorretos em fórmulas.
  • Crash durante o cáculo.

Passos a tomar:

  1. Desmarque Ferramentas ▸ Opções... ▸ LibreOffice ▸ OpenCL ▸ Utilizar o OpenCL.
  2. Reinicie o LibreOffice, verifique se o problema continua.
  3. Se continuar, desmarque Ferramentas ▸ Opções... ▸ LibreOffice ▸ OpenCL ▸ Permitir utilização do interpretador de software (mesmo quando o OpenCL não estiver disponível).
  4. Reinicie o LibreOffice, verifique se o problema continua.

Se o problema desapareceu depois do passo 2, localize <perfil do usuário>/cache/opencl_devices.log e opencl_profile.xml, e anexe ao relatório de erros (este arquivos são criados desde a versão 5.1.4). Isso vai ajudar o time de desenvolvimento a avaliar se o problema é da implementação do OpenCL no seu sistema ou do LibreOffice.

Acrescente suas observações ao relatório.

NOTA: Se o numero de células usado nas fórmulas for pequeno, o OpenCL não é usado mesmo ativado (o OpenCL é usado para acelerar os cálculos em conjunto grandes de dados, e normalmente não é eficiente em pequenos conjuntosde dados). O limite mínimo padrão é 100, e pode ser ajustado em Ferramentas ▸ Opções... ▸ LibreOffice Calc ▸ Fórmula selecionando Personalizado (conversão de texto para números e mais), clicando em Detalhes, e ajustando Tamanho mínimo de dados para utilizar o OpenCL.

Graphics-related issues ( Skia )

Symptoms:

  • Graphical glitches.
  • Crash.

Check if the following string appears in Help ▸ About LibreOffice: "UI Render: Skia/Vulkan".

If there is other or even "UI Render: Skia/Raster" instead, it usually means the symptoms aren't caused by Skia, and the rest isn't applicable.

Steps to take:

  1. Check you've got last stable driver for your graphic card since it includes Skia part.
  2. You can also force the use of Skia/Raster:
    1. On Windows, you can use the adhoc checkbox on Tools ▸ Options ▸ LibreOffice ▸ View
    2. On Linux/MacOS: before launching LibreOffice from console, you can export the variable export SAL_SKIA=raster,
    3. On every environment you could force Skia: Tools ▸ Options ▸ LibreOffice ▸ Advanced ▸ Open Expert Configuration, put ForceSkiaRaster to true

However, there are known cases when using Skia/Raster still crashes LibreOffice when starting, and in those cases (when you will not be even able to look at Help ▸ About LibreOffice) you would need to try these manual steps.

  1. Locate your user profile (see details above).
  2. Open registrymodifications.xcu in a plain text editor, and search for UseSkia text string there.
    1. If found, replace true with false in that line.
    2. If not found, add this line to the file before the final </oor:items>:
   <item oor:path="/org.openoffice.Office.Common/VCL"><prop oor:name="UseSkia" oor:op="fuse"><value>false</value></prop></item>

If the issue is gone, locate <user profile>/cache/skia.log, and attach it to the bug report. This will help the development team assess whether the issue could be with the Skia/Vulkan implementation in your system, or within LibreOffice.

Fonts issues

Symptoms:

  • Graphical glitches.
  • Crash.

Some types of fonts or some old versions of a font are not well managed by LibreOffice and can cause these symptoms.

Steps to take:

  1. Close LibreOffice.
  2. Disable the fonts which have been installed after OS install.
  3. Restart LibreOffice and try to reproduce the problem.

If the issue is gone, try to find the font which caused the problem and check if there's a more recent version to install. Once it's done, if the problem can still be reproduced and if the font is the cause, indicate it (with version) on the bugtracker.

Rendering issues specific to Linux

Symptoms:

  • Graphical glitches.
  • Crash.

Sometimes gtk3 or kf5/qt VCL backends trigger bugs.

Steps to take:

  1. Close LibreOffice.
  2. Launch LibreOffice from a terminal/console with
    SAL_USE_VCLPLUGIN=gen libreoffice
  3. Try to reproduce the problem.

If the issue is gone, it means it's related to the rendering you use by default (gtk3 if Gnome, kf5 for qt/Plasma for example).