JetBrains Toolbox¶

Instala e configura o JetBrains Toolbox, gerenciador oficial para todas as IDEs da JetBrains.

O que é JetBrains Toolbox?¶

JetBrains Toolbox é um aplicativo que facilita o gerenciamento de todas as IDEs da JetBrains a partir de uma única interface. Permite instalar, atualizar e gerenciar múltiplas versões das IDEs, além de gerenciar projetos e configurações.

IDEs Suportadas¶

IntelliJ IDEA - Java, Kotlin, Scala, Groovy
PyCharm - Python
WebStorm - JavaScript, TypeScript
PhpStorm - PHP
RubyMine - Ruby
GoLand - Go
CLion - C, C++
Rider - .NET, Unity
DataGrip - Banco de dados
AppCode - iOS, macOS
RustRover - Rust
Aqua - Testes de automação

Características Principais¶

Instalação Simplificada: Instale qualquer IDE com um clique
Gerenciamento de Versões: Mantenha múltiplas versões lado a lado
Atualizações Automáticas: Mantenha suas IDEs sempre atualizadas
Rollback Fácil: Volte para versões anteriores quando necessário
Gerenciamento de Projetos: Acesso rápido aos seus projetos recentes
Configurações Compartilhadas: Sincronize configurações entre IDEs
Shell Scripts: Abra projetos pela linha de comando

Uso¶

susa setup jetbrains-toolbox [opções]

Opções¶

Opção	Descrição
`-h, --help`	Mostra mensagem de ajuda
`--uninstall`	Desinstala o JetBrains Toolbox
`-u, --upgrade`	Atualiza para a versão mais recente
`-v, --verbose`	Modo detalhado com logs de debug
`-q, --quiet`	Modo silencioso

Guia Rápido¶

Instalação¶

# Instalar JetBrains Toolbox
susa setup jetbrains-toolbox

# Instalar com logs detalhados
susa setup jetbrains-toolbox -v

O Toolbox será iniciado automaticamente após a instalação.

Primeira Configuração¶

Faça Login: Use sua conta JetBrains para acessar licenças
Configure Preferências: Defina diretório de instalação das IDEs
Instale IDEs: Escolha as IDEs que deseja usar

Atualização¶

# Atualizar JetBrains Toolbox
susa setup jetbrains-toolbox --upgrade

# Atualizar com logs detalhados
susa setup jetbrains-toolbox --upgrade -v

Desinstalação¶

# Desinstalar JetBrains Toolbox
susa setup jetbrains-toolbox --uninstall

# A desinstalação irá perguntar se deseja:
# 1. Confirmar remoção do Toolbox
# 2. Remover IDEs instaladas e suas configurações

Usando o JetBrains Toolbox¶

Instalando IDEs¶

Abra o JetBrains Toolbox
Navegue até a IDE desejada
Clique em "Install" ou selecione uma versão específica
Aguarde a instalação completar

Gerenciando Versões¶

# O Toolbox permite:
- Instalar múltiplas versões da mesma IDE
- Usar versões EAP (Early Access Program)
- Fazer rollback para versões anteriores
- Atualizar automaticamente ou manualmente

Configurações¶

Diretório de Instalação¶

Por padrão, as IDEs são instaladas em:

Linux: ~/.local/share/JetBrains/Toolbox/apps/
macOS: ~/Library/Application Support/JetBrains/Toolbox/apps/

Você pode alterar nas configurações do Toolbox.

Shell Scripts¶

Habilite shell scripts para abrir projetos pela linha de comando:

# Após habilitar nas configurações
idea ~/meu-projeto      # IntelliJ IDEA
pycharm ~/meu-projeto   # PyCharm
webstorm ~/meu-projeto  # WebStorm

Atalhos do Teclado¶

Dentro do Toolbox:

Ctrl/Cmd + O - Abrir projeto
Ctrl/Cmd + , - Configurações
Ctrl/Cmd + R - Atualizar lista de IDEs

Recursos Avançados¶

Atualizações Automáticas¶

Configure atualizações automáticas:

Abra configurações do Toolbox
Vá para "Tools"
Configure "Update all tools automatically"
Escolha "Stable only" ou incluir "EAP versions"

Gerenciamento de Projetos¶

O Toolbox mantém histórico dos projetos recentes:

# Recursos:
- Busca rápida de projetos
- Abrir projeto com IDE específica
- Gerenciar múltiplos projetos simultaneamente
- Favoritar projetos importantes

Múltiplas Versões¶

Mantenha diferentes versões para diferentes projetos:

# Exemplo:
- IntelliJ IDEA 2024.1 - Projetos legados
- IntelliJ IDEA 2024.3 - Projetos novos
- IntelliJ IDEA EAP - Testes de novas features

Configurações Compartilhadas¶

Sincronize configurações entre IDEs:

Habilite "Settings Sync" em uma IDE
Faça login com conta JetBrains
Suas configurações serão sincronizadas automaticamente
Use em múltiplos computadores

Integração com Terminal¶

Comandos Shell¶

Após habilitar shell scripts:

# IntelliJ IDEA
idea .                    # Abre diretório atual
idea /path/to/project     # Abre projeto específico
idea diff file1 file2     # Comparar arquivos

# PyCharm
pycharm .
pycharm /path/to/project

# WebStorm
webstorm .
webstorm /path/to/project

# Outros
goland .
phpstorm .
rider .
clion .

Adicionar ao PATH¶

Se os comandos não funcionarem, adicione ao PATH:

Linux/macOS:

# Adicionar ao ~/.bashrc ou ~/.zshrc
export PATH="$HOME/.local/share/JetBrains/Toolbox/scripts:$PATH"

# macOS alternativo
export PATH="$HOME/Library/Application Support/JetBrains/Toolbox/scripts:$PATH"

Licenciamento¶

Tipos de Licença¶

Free Versions: Community editions (IntelliJ IDEA, PyCharm)
Trial: 30 dias de avaliação das versões Ultimate
Individual: Licença pessoal
Organization: Licença empresarial
Educational: Gratuita para estudantes e professores

Ativar Licença¶

Abra qualquer IDE
Vá para "Help → Register"
Escolha método de ativação:
JetBrains Account
Activation code
License server

Educational License¶

Estudantes e professores podem obter licenças gratuitas:

Acesse https://www.jetbrains.com/community/education/
Cadastre-se com email educacional
Confirme seu status de estudante/professor
Ative usando JetBrains Account

Plugins e Extensões¶

Instalar Plugins¶

Cada IDE tem seu próprio marketplace:

Abra a IDE
Vá para "Settings → Plugins"
Busque e instale plugins
Reinicie a IDE se necessário

Plugins Populares¶

GitHub Copilot - Assistente de código com IA
GitToolBox - Funcionalidades extras do Git
Rainbow Brackets - Colorir parênteses
Key Promoter X - Aprender atalhos
SonarLint - Análise de código
Docker - Integração com Docker
Database Tools - Gerenciamento de bancos

Troubleshooting¶

Toolbox não Inicia (Linux)¶

# Verificar se está em execução
ps aux | grep jetbrains-toolbox

# Verificar logs
cat ~/.local/share/JetBrains/Toolbox/logs/toolbox.log

# Reiniciar Toolbox
pkill jetbrains-toolbox
jetbrains-toolbox

Toolbox não Inicia (macOS)¶

# Verificar logs
cat ~/Library/Logs/JetBrains/Toolbox/toolbox.log

# Reiniciar Toolbox
osascript -e 'quit app "JetBrains Toolbox"'
open -a "JetBrains Toolbox"

IDE não Aparece¶

# Atualizar lista de ferramentas
1. Abra o Toolbox
2. Clique no ícone de engrenagem
3. Clique em "Reload tools list"

Problemas de Permissão (Linux)¶

# Corrigir permissões
chmod +x ~/.local/bin/jetbrains-toolbox

# Verificar PATH
echo $PATH | grep .local/bin

Erro ao Baixar IDE¶

# Verificar conexão
curl -I https://download.jetbrains.com/

# Limpar cache
rm -rf ~/.cache/JetBrains/Toolbox/

# Tentar novamente

IDE não Abre¶

# Verificar instalação
ls -la ~/.local/share/JetBrains/Toolbox/apps/

# Reinstalar IDE específica
1. No Toolbox, clique nos 3 pontos da IDE
2. Selecione "Uninstall"
3. Instale novamente

Consumo Excessivo de Memória¶

# Ajustar configurações de memória da IDE
1. Help → Edit Custom VM Options
2. Ajustar valores:
   -Xms512m          # Memória inicial
   -Xmx2048m         # Memória máxima
   -XX:ReservedCodeCacheSize=512m

Comparação com Outras Ferramentas¶