Eu descobri a utilidade de manter uma documentação dos passos que eu sigo sempre que eu configuro um novo computador para trabalho. Como tenho pelo menos duas estações de trabalho (a principal e a reserva), e de tempos em tempos me da a louca de formata-los quando acho que o sistema ficou muito bagunçado, a criação de um roteiro com tudo que eu preciso para deixar a máquina pronta para qualquer situação acelera muito as coisas, já que fazendo tudo de cabeça sempre sentia falta de alguma coisa no dia-a-dia.

Eu considero a preparação do ambiente como a manutenção da caixa de ferramentas. Um cozinheiro é sempre eficiente quando suas ferramentas de trabalho estão sempre afiadas e ao seu fácil alcance. O trabalho como desenvolvedor só se torna realmente produtivo quando estabelecemos um ambiente otimizado para nossas atividades diárias.

De tempos em tempos gosto de revisar esse roteiro, tanto para acrescentar descobertas como para rever ferramentas que talvez tenha esquecido. São tantos os recursos a nosso dispor que não é raro esquecermos que já temos facilitadores de uma tarefa.

Preparação do Ambiente macOS

A preparação do ambiente macOS segue os passos abaixo:

Formatar o computador e Instalar o Sistema Operacional

Para formatar o computador é necessário criar um disco de instalação. Primeiro é preciso baixar o macOS na App Store, depois inserir um pen-drive com pelo menos 8GB de espaço (que será limpado nesse processo). Basta executar o comando abaixo:

sudo /Applications/Install\ macOS\ Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolume

Referência: How to create a bootable installer for macOS

Configurar a Rede para usar o DNS do Cloudfare

Seguindo os passos deste link configurar a rede para usar o DNS do Cloudflare. Não é apenas uma questão de segurança, mas em algumas redes tive problemas de acesso usando o DNS padrão por estarem bem mal configurados.

Em resumo é incluir os seguintes endereços nos adaptadores de rede:

1.1.1.1
1.0.0.1
2606:4700:4700::1111
2606:4700:4700::1001

Isso deve ser feito para cada uma das interfaces de rede do computador (Wi-fi, ethernet, etc.).

Configurações e Extensões do Safari

No Safari há algumas coisas importantes para meu fluxo de trabalho:

  • Na aba General:
    • Marcar a opção Safari opens with: All windows from last session
  • Na aba Tabs:
    • Marcar a opção Show website icons in tabs (muito útil para uma identificação visual das abas)
  • Na aba Advanced (Avançado):
    • Marcar a opção Show full website address
    • Marcar a opção Show developer menu in menu bar - isso também habilita a opção Inspect no menu do botão direito

Eu também uso as seguintes extensões:

Configurações do Finder

O Finder por padrão é horrível. Faço algumas configurações que considero fundamentais:

  • Na aba General:
    • New Finder windows show: minha pasta home
  • Na aba Sidebar, deixo marcados apenas os seguintes favoritos:
    • Minha pasta Home
    • Downloads
    • Applications
  • Na aba Advanced, incluo os itens:
    • Marcar a opção Remove itens from Trash after 30 days
    • Marcar a opção Keep folders on top: In windows when sorting by name
    • When performing a search: Search the Current Folder, pois pra mim não faz sentido o Finder fazer uma busca geral, geralmente eu quero encontrar os itens da própria pasta

Além disso ajusto algumas opções de visualização no menu View:

  • Show Path Bar
  • Show Status Bar

Instalar os aplicativos da App Store

Com o sistema operacional recém instalado a primeira coisa que faço é instalar os aplicativos da app store. Sempre começo pelo Amphetamine, para deixar o computador ativo durante o download e instalação dos componentes que as vezes é demorado. Na sequência baixo o Xcode, esse mamute da Apple com seus mais de 6.5GB de download e um tempo incompreensível de instalação. Os demais podem vir sem ordem específica.

Instalar o SetApp

Sou um usuário antigo do Setapp, desde que ele ainda estava em Beta e tinha menos da metade dos apps que tem hoje em seu catálogo. A plataforma é muito bem construída, muito prática e tem uma boa oferta de software (apesar de alguns importantes como o iMazing terem saido da plataforma recentemente). A versão mais recente da plataforma sincroniza a lista dos seus apps favoritos, facilitando a instalação de tudo que eu já uso logo que a plataforma é instalada.

Eu removo o ícone do Setapp da barra de menu bem como o atalho de teclado padrão que ele sugere para buscar apps, já que considero atalhos inúteis.

Uma coisa que gosto do Setapp é que quando você faz login no site e vai no link de download, ele já baixa um instalador pre-configurado com seu login, então você não precisa se preocupar em fazer login novamente.

Os apps que uso do Setapp são:

  • iStat Menu: gosto de acessar rapidamente o estado do sistema, entender se algum processo esta comendo muito processamento. Além disso, descobri outras funções muito boas no iStatMenu, inclusive que ele é uma excelente substituição para o relógio nativo, incluindo data e previsão do tempo.
  • Bartender: Gerenciador dos ícones da barra de menu, bem completo e prático de usar. Gosto como ele inclui uma função que existe no tray do Windows a muito tempo, de esconder os ícones pouco usados.
  • BetterZip: um ótimo gerenciador de arquivos compactados, acrescenta algumas funções úteis e suporte para outros padrões que o macOS não trata por padrão.
  • CleanMyMac X: Esse aplicativo é indispensável para manutenção do macOS e o único que eu confio.
  • Expressions: Um utilitário para construção de Regular Expressions, uso de vez em quando.
  • SQLPro Studio: Esse tem sido meu client para acessar os sistemas de bancos de dados Postgree e SQL Azure. Funciona muito bem tendo até uma implementação básica de autocomplete. Salva as conexões no iCloud o que deixa bastante prático.
  • Proxyman: Um debugger HTTP bem organizado para macOS, melhor do que o Charles que eu usava anteriormente.

Instalar os aplicativos de outras fontes

Lista dos outros softwares que baixo diretamente de seus fabricantes, que não estão disponíveis na loja ou no Setapp, ou que adquiri diretamente.

  • 1Password: meu gerenciador de senhas, a primeira ferramenta que instalo.
  • Alfred: esse é o que o Spotlight deveria ser, e substitui ele devidamente.
  • Visual Studio for Mac: minha principal ferramenta de desenvolvimento.
  • Visual Studio Code: fora dos projetos específicos para o Visual Studio, o Code é meu editor padrão para arquivos texto.
  • Android Studio: O Flutter me trouxe de volta a necessidade de ter o Android Studio instalado.
  • Flutter SDK: SDK do Flutter para desenvolvimento na plataforma.
  • Fork: esse client Git é um achado e que já estou quase substituindo o GitKraken por ele graças a sua simplicidade e polidez.
  • Azure Data Studio: cliente multiplataforma de SQL Server da Microsoft. Acabo usando mais o SQLPro Studio, mas deixo essa ferramenta como um backup.
  • Azure Storage Explorer: cliente multiplataforma do Azure Storage. Utilizo em alguns projetos.
  • Postman: costumava ser minha principal ferramenta para manipular API’s. Hoje esta um pouco de lado, já que outros recursos como Swagger tornou essa interação mais fácil. Mas ainda tenho alguns projetos na nuvem deles.
  • Reflection 3: Geralmente uso esse utilitário para espelhar a tela do celular no meu computador durante uma aula ou demonstração de algum app.
  • Parallels Desktop: uso para virtualizar o Windows (desenvolver com Visual Studio ou fazer alguma coisa específica de Windows) e o Linux (desenvolver para Android). Hoje é a melhor ferramenta de virtualização para Mac, mas esta ficando muito cara.
  • Docker: uso o community edition para baixar imagens do SQL Server ou Postgree para desenvolvimento. Estou com livros para estudar mais.
  • Skype: a Microsoft estragou o Skype, é fato, mas os clientes ainda usam para comunicação.
  • Spectacle: utilitário para incluir atalhos para gerenciamento das janelas.
  • Itsycal: Esse utilitário me é indispensável. Sempre sinto falta de ter um calendário por perto. Além de mostrar a data atual da barra do menu ele da acesso fácil a um calendário para consulta.
  • Screenflow: Excelente programa para gravação da tela. Uso para montar algumas demonstrações dos meus trabalhos. Não há um link direto para download, tem que mandar o link para baixar o trial por e-mail.
  • iMazing: O melhor gerenciador de dispositivos iOS. Meu principal uso dele é gerenciar os backups locais do meu iPhone, já que o gerenciamento de backups nativo do iOS/iTunes é bem espartano.
  • Homebrew: Gerenciador de pacotes para macOS que facilita a instalação de aplicativos e utilitários. Sempre útil ter a mão.
  • Node.js: Mais pelo npm que usamos para baixar algumas ferramentas, mas também estou começando a experimentar com ele.
  • Python: as vezes faço algumas brincadeirinhas e scripts com Python, nada profissional.
  • Firefox: Sou usuário do Safari, acho o melhor browser disponível para macOS, e também gosto da maneira como se integra ao iOS. De qualquer forma preciso ter o Firefox disponível caso precise testar algo que estou desenvolvendo, ou até para acessar contas de serviços separadas. Depois do Safari o Firefox hoje é sem dúvida o melhor browser disponível.
  • Google Chrome: mantenho o Chrome instalado pelos mesmos motivos do Firefox. No meu ranking pessoal de melhores browsers ele fica em 3º lugar. Tanto por ser mais pesado que os outros como por estar na tutela do Google, que ainda não me inspira lá muita confiança.
  • Upwork Desktop App: Aplicativo Desktop do Upwork. Uso para fazer o controle de tempo dos meus trabalhos realizados através da plataforma.
  • Logitech Options: Os drivers da Logitech para meu Mouse (MX Anywhere 2S) permitem personalizar os botões de funções. Como esse mouse tem diversos botões eu uso para montar uma configuração que eu acho produtiva.
  • Zeplin
  • TuneIn Radio
  • VLC
  • SF Symbols

Instalar os plugins do QuickLook

O Quicklook é uma das funções mais úteis do macOS. Selecionando um arquivo no Finder basta apertar a barra de espaço e ele abrirá um modal mostrando um “Preview” desse arquivo. O problema é que poucos arquivos tem um visualizador por padrão, então há uma série de plugins para o Quicklook nesse site que deixam a ferramenta realmente completa. O melhor de tudo é que eles são bem simples de instalar usando o Homebrew Cask.

A lista nesse site é mais extensa, a seguir o script que uso para instalar só o que me interessa:

brew cask install qlcolorcode qlstephen qlmarkdown quicklook-json qlimagesize suspicious-package provisionql quicklookapk

Instalar e configurar as fontes

Com o tempo fui coletando algumas fontes que uso no sistema ou para construção de alguns documentos e apresentações. Elas ajudam a tornar o conteúdo mais legível ou menos cansativo de ler (como a Input por exemplo, desenhada para ser usada em editores de textos das IDE’s e telas de terminal). Abaixo a lista de fontes que sempre instalo em meu sistema:

  • Fira Code: essa fonte foi desenvolvida para programadores e tem um apelo especial pois ela transforma combinações de caracteres especiais (ligatures) em símbolos que facilitam a leitura do código. Tornou-se minha primeira opção nos meus ambientes de desenvolvimento.
  • Input: excelente para IDE’s como o Visual Studio e o Xcode.
  • San Francisco: as fontes que a Apple criou para substituir a Helvetica nas novas versões do macOS e iOS. Ironicamente não aparecem por padrão na lista de fontes do sistema e precisam ser instaladas em separado.
  • Josefins Sans: uso essa fonte em algumas apresentações e documentos.
  • Montserrat: uso essa fonte em algumas apresentações e documentos.
  • Open Sans: uso essa fonte em algumas apresentações e documentos.
  • Roboto: essa é a fonte padrão no sistema Android. As vezes preciso referenciá-lo nos projetos de alguns apps, motivo pelo qual preciso delas instaladas.

Preparando o ambiente de desenvolvimento do Visual Studio

Visual Studio for Mac

No meu repositório dev-toolbox eu mantenho um script para sincronizar os Snippets e algumas configurações do Visual Studio para Mac na pasta vs-utils.

Além disso gosto de fazer as seguintes configurações (que ainda não encontrei uma forma automatizada de salvar):

  • Fontes:
    • Editor de textos: Fira Code Regular, 14pt
    • General Pad Text: SF Pro Display, 14pt
    • Output Pad Constants: Input Mono Regular, 13pt
  • Intellisense:
    • Show import items
  • Source Analysis
    • Enable text editor unit test integration (habilita a integração de funções de testes unitários no editor de código, como por exemplo executar o teste direto a partir do editor)

E por fim instalo os seguintes plug-ins:

.NET Core SDK

Por algum motivo esquisito, a versão mais recente do Visual Studio não instala o SDK mais recente do .NET Core por padrão, dai a necessidade de instalar a parte que pode ser baixada nesse link.

Visual Studio Code

Usar a extensão Settings Sync para sincronizar as configurações e extensões do Visual Studio Code.

ID do Gist das minhas configurações: 1a0f3224c1d0379597b8acfd54db4a5b

Utilitário nuget.exe

O utilitário nuget.exe é usado para criar pacotes do Nuget e enviar para o feed público. A instalação no macOS depende do Mono (instalado junto com o Visual Studio for Mac).

# Download the latest stable `nuget.exe` to `/usr/local/bin`
sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

Isso instala o utilitário na /usr/local/bin.

Utilitários Globais do .NET Core

Instalar as ferramentas globais do .NET que eu mais uso: Entity Framework, Code Generator e git ignore:

dotnet tool install --global dotnet-ef
dotnet tool install -g dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-giio

Configurar o Terminal

Abaixo um trecho de script que acrescento ao arquivo .zshrc que uso para carregar as configurações padrões das minhas janelas de terminal. Basicamente coloco no PATH o caminho das ferramentas do Android, do Flutter, do Fastlane e um alias para o comando Nuget que roda via mono:

# Setting PATH for Android SDK
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_HOME/tools"
export PATH="$PATH:$ANDROID_HOME/tools/bin"
export PATH="$PATH:$ANDROID_HOME/platform-tools"

# Setting PATH for Flutter SDK
export PATH="$PATH:$HOME/Tools/flutter/bin"

# fastlane
export PATH="$PATH:$HOME/.fastlane/bin"

# Create as alias for nuget
alias nuget="mono /usr/local/bin/nuget.exe"

No macOS Catalina o terminal padrão virou o ZSH. Uma das coisas mais legais dele é a possibilidade de instalar extensões, sendo a mais popular a Oh My ZSH. A instalação é bem simples:

sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

Há uma comunidade gigante em torno dele criando plugins, temas e uma série de outras (embora esses sejam muito mal documentados). Ainda estou explorando as possibilidades.

Configurar os papéis de parede

Mantenho uma pasta com meus papéis de parede prediletos para rolar em meu desktop. Parece uma preocupação boba, mas é bom olhar imagens diferentes na tela que ficamos fitando o dia todo.

Configurar a Touch Bar

Desde que a primeira versão do MacBook Pro Touchbar eu migrei para esse tipo de Mac. Passada a empolgação inicial você percebe que esse é um recurso completamente dispensável, tanto que quando estou usando um computador que não tem isso não sinto a menor falta.

Mas já que o recurso esta ai, vamos tentar tirar o melhor proveito dele. Felizmente ele suporta algumas customizações interessantes, em especial nos botões de atalho que ficam fixos na parte direita.

Essa configuração é feita em System Preferences > Keyboard > Customize Touchbar. Há dois tipos de atalhos globais, os que ficam sempre visiveis e os que aparecem ao clicar na setinha ao lado desses.

Esses são os atalhos padrões que uso:

E esses são os atalhos expandidos:

O Touchbar tem muitas opções interessantes, mas eu procuro colocar aquelas que não são diretamente acessíveis por um atalho de teclado, como a função Sleep ou os atalhos para o AirPlay.

Quando você usa o iCloud Drive, as pastas locais ficam em um caminho escondido na Library do seu usuário. O Finder tem uma série de atalhos para acessar facilmente essas pastas, mas as vezes você quer acessá-la através do Terminal ou até montar scripts com os arquivos dela.

Para isso gosto de criar um link simbólico escondido na minha pasta Home:

ln -s ~/Library/Mobile\ Documents/com~apple~CloudDocs/ .icloud

Esse comando cria uma pasta escondida .icloud, dai você pode manipular ela no Terminal como se fosse uma pasta comum.

Criar os atalhos de teclado para VM’s do Parallels

Depois que você se torna um usuário de Mac, se acostuma com o seu teclado e com seus atalhos, fica dificil operar o Windows. O Parallels já tem pré-mapeados alguns dos atalhos mais comuns, mas acrescento mais alguns que eu considero fundamentais para conseguir usar o Windows, especialmente para edição de textos.

Atalho macOS Windows
Mover o cursor para o início da linha ⌘ + ← Home
Mover o cursor para o final da linha ⌘ + → End
Selecionar o texto até o começo da linha ⌘ + ⇧ + ← Shift + Home
Selecionar o texto até o final da linha ⌘ + ⇧ + → Shift + End
Refazer ⌘ + ⇧ + z Ctrl + Y
Mover para o topo da página ⌘ + ↑ Ctrl + Home
Mover para o final da página ⌘ + ↓ Ctrl + End

Além disso, no Parallels 15, é preciso corrigir o atalho ⌘ + W que estava incorretamente mapeado para Alt + F4 ao invés do Ctrl + F4, o que me fez fechar algumas vezes o Visual Studio ao invés de fechar só a aba ativa.

Infelizmente o Parallels ainda não fornece um mecanismo para exportar esses atalhos, e também não encontrei os arquivos de configuração de onde poderia copiá-los, então é necessário configurar isso manualmente.

Desligar Notificações na Tela Bloqueada

O macOS tem uma função completamente inútil de ficar mostrar notificações na tela bloqueada, o que fica acendendo a tela inutilmente de tempos em tempos. O jeito mais simples de desligar todas de uma vez e ir na opção de Notifications em System Preferences e marcar o Do Not disturb quando o computador estiver dormindo, conforme ilustrado abaixo:

Ajustar as opções de Áudio

Gosto de ter o ícone de áudio na barra de menus, isso facilita trocar o dispositivo de entrada ou saída, já que as opções aparecem quando você clica nesse ícone. Também gosto de ter o retorno de áudio quando aumento ou diminuo o volume (opção Play feedback when volume is changed).

Instalar e configurar o Backblaze

O Backblaze é minha solução para backups na nuvem. Embora ele funcione muito bem, a sua instalação padrão exclui alguns arquivos fundamentais do backup (o que sinceramente é uma grande malandragem da parte deles para não ter que lidar com alguns backups bem grandes). Para corrigir, vá em settings e na aba Exclusions substitui em The following file types will not be backed up por:

wab~,vmc,vhd,vhdx,vdi,vo1,vo2,vsv,vud,sparseimage,sys,cab,exe,msi,dll,dl_,wim,ost,o,qtch,ithmb,vmdk,vmem,vmsd,vmsn,vmss,vmx,vmxf,menudata,appicon,appinfo,pva,fdd,hds,drk,nvram

Isso corrige a safadeza do Backblaze de excluir os arquivos importantes do Parallels Desktop. Verifique se nessas exclusões ele não esta removendo mais nada que lhe seja importante pois eu só fui descobrir que ele não estava fazendo corretamente os backups das minhas VM’s depois que precisei restaurar.