diff options
Diffstat (limited to 'docusaurus/docs/installation.md')
| -rw-r--r-- | docusaurus/docs/installation.md | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/docusaurus/docs/installation.md b/docusaurus/docs/installation.md new file mode 100644 index 0000000..0ae22e8 --- /dev/null +++ b/docusaurus/docs/installation.md @@ -0,0 +1,76 @@ +--- +id: installation +title: Instalação +sidebar_label: Instalação +--- +## Download + +O download do PSP-UFU pode ser realizado pelo ["*last release*" do repositório do PSP-UFU no GitHub](https://github.com/Thales1330/PSP/releases/latest). + +Ao acessar ao link, role a página até encontrar os *Assets*: + +![Download][download] +[download]: /PSP/images/download.png 'Assets donwload' + +Como o PSP-UFU é um *software* multiplataforma, você deve baixar o arquivo correto: +- Para o sistema operacional [Windows](installation#windows) baixe os arquivos *.exe* (recomendado) ou *.zip*. +- Para os sistemas [Linux](installation#linux) baseados no Debian (por exemplo, Ubuntu, Mint) *64 bits* baixe o pacote de instalação *.deb*. + +:::tip Dica +Se você está interessado em contribuir com o PSP-UFU construindo-o para outros sistemas operacionais (principalmente macOS!) entre em contato pelo [GitHub](https://github.com/Thales1330/PSP/issues) ou [Twitter](https://twitter.com/PspUfu). +::: + +Na sequência são apresentados o passo-a-passo para instalação dos SOs [Windows](installation#windows) e [Linux](installation#linux). Também são apresentadas as soluções para os erros mais recorrentes. + +## Windows +Após baixar o arquivo *.exe* avance em cada passo do instalador. O executável irá solicitar automaticamente a instalação do **Microsoft Visual C++ Redistribuível** e, caso não esteja instalado no seu computador, realize os procedimentos do programa. + +Caso o executável falhe em abrir, baixe o arquivo *.zip* e descompacte em alguma pasta do seu sistema. Nesse caso é necessário baixar e instalar manualmente o [**Microsoft Visual C++ Redistribuível 32 bits**](https://aka.ms/vs/16/release/vc_redist.x86.exe). + +Após a conclusão da instalação abra o PSP-UFU para verificar a correta instalação. O executável está presente na pasta "*<local de instalação>/PSP-UFU/bin/PSP-UFU.exe*". + +### Problemas recorrentes no Windows +- Ao baixar o navegador pode **falsamente** sinalizar que é um arquivo perigoso, basta clicar em "Manter arquivo"; +- Ao abrir o instalador, novamente o Windows sinaliza que o arquivo é perigoso, basta clicar em "Executar assim mesmo"; +- Ao abrir o programa e alterar o seu idioma, uma mensagem de erro é exibida. Para resolver esse problema basta executar o PSP-UFU como administrador (clicar com botão direito no atalho do programa e posteriormente em executar como administrador). Altere novamente o idioma e reinicie o programa; +- Ao criar um novo projeto a tela de trabalho não é exibida ou é exibida uma tela preta. Vá nas opções gerais e altere o renderizador para "Device Context". Caso apareça uma mensagem de erro, execute o programa como administrador e repita o processo. Reinicie o programa. + + +## Linux +A instalação no sistema Linux é facilmente realizado pelo pacote de instalação automático *.deb*. +:::caution Atenção! +Note que essa versão para Linux está defasada e algumas funcionalidades do programa podem não estar presentes. + +Caso queira contribuir com o projeto e construir a versão atual no sistema Linux baseado em Debian ou em outras distribuições entre em contato pelo [GitHub](https://github.com/Thales1330/PSP/issues) ou [Twitter](https://twitter.com/PspUfu). +::: + +### Problemas recorrentes no Linux +Pode ser necessário adicionar o [diretório das bibliotecas do wxWidgets](https://wiki.wxwidgets.org/Compiling_and_getting_started#Running_wxWidgets_projects) nas variáveis de ambiente. +Para isso, siga **UM** dos métodos apresentados abaixo: + +#### *Método I (recomendado)* +Insira o seguinte comando no arquivo **~/.bashrc**: +```shell +echo "export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib" >> ~/.bashrc +``` + +#### *Método II (não recomendado)* +:::warning Cuidado! +Utilizando esse método, os passos abaixo devem ser executados todas as vezes que você quiser abir o PSP-UFU. +::: +1. Abra o terminal e acesse o diretório onde está instalado o PSP-UFU: +```shell +cd /usr/local/bin +``` +2. Insira as bibliotecas compartilhadas do wxWidgets nas variáveis de ambiente: +```shell +export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib +``` +3. Então, execute o PSP-UFU na **mesma seção** do terminal: +```shell +./PSP-UFU +``` + +:::caution Atenção! +Verifique se o computador possui as unidades de vídeo instaladas corretamente, caso contrário, o programa não exibirá a área de trabalho para criar e editar diagramas de linha única ou diagramas de blocos de controle. +::: |