|
| 1 | +--- |
| 2 | +title: Começando |
| 3 | +mobile_menu_title: "Começando" |
| 4 | +toc: true |
| 5 | +--- |
| 6 | + |
| 7 | +{{% div class="box thin"%}} |
| 8 | +**<center>Nota para usuários do Apple Silicon</center>** |
| 9 | +Zig tem suporte experimental para a assinatura de códigos. Você poderá usar Zig com seu M1 Mac, |
| 10 | +mas a única maneira de conseguir Zig para macOS em ARM64 é compilá-lo você mesmo. |
| 11 | +Certifique-se de verificar a seção [Compilando da Fonte](#compilando-da-fonte). |
| 12 | +{{% /div %}} |
| 13 | + |
| 14 | + |
| 15 | +## Marcar (Tags) as versões de lançamento e nightly? |
| 16 | +Zig ainda não atingiu a v1.0 e o atual ciclo de liberação está ligado a novas liberações de LLVM, que têm uma cadência de ~6 meses. |
| 17 | +Em termos práticos, **As versões Zig tendem a ser muito distantes e eventualmente se tornam obsoletas, dada a velocidade atual de desenvolvimento**. |
| 18 | + |
| 19 | +É bom avaliar o Zig usando uma versão com tags, mas se você decidir que gosta do Zig e quer mergulhar mais fundo, **nós o encorajamos a atualizar para versão nightly**, principalmente porque dessa forma será mais fácil para você obter ajuda: a maioria da comunidade e sites como |
| 20 | +[ziglearn.org](https://ziglearn.org) se baseiam no *master branch* pelas razões acima expostas. |
| 21 | + |
| 22 | +A boa notícia é que é muito fácil mudar de uma versão Zig para outra, ou mesmo ter várias versões presentes no sistema ao mesmo tempo: As versões Zig são arquivos autocontidos que podem ser colocados em qualquer lugar em seu sistema. |
| 23 | + |
| 24 | + |
| 25 | +## Instalando Zig |
| 26 | +### Baixar diretamente |
| 27 | +Esta é a maneira mais direta de obter o Zig: pegue um pacote Zig para sua plataforma a partir da página [Baixar](../../download), |
| 28 | +extrair em um diretório qualquer e adicioná-lo ao seu `PATH` para poder utilizar o executável `zig` de qualquer lugar. |
| 29 | + |
| 30 | +#### Configurando PATH no Windows |
| 31 | +Para configurar seu caminho no Windows, execute **um** dos seguintes trechos de código em uma instância Powershell. |
| 32 | +Escolha se você deseja aplicar esta mudança em nível de sistema (requer a execução de Powershell com privilégios administrativos) ou apenas para seu usuário, e ** certifique-se de mudar o trecho para apontar para o local onde se encontra sua cópia do Zig***. |
| 33 | +O `;` antes do `C:` não é um erro de tipo. |
| 34 | + |
| 35 | +Modo privilegiado do sistema (**admin** no Powershell): |
| 36 | +``` |
| 37 | +[Environment]::SetEnvironmentVariable( |
| 38 | + "Path", |
| 39 | + [Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version", |
| 40 | + "Machine" |
| 41 | +) |
| 42 | +``` |
| 43 | + |
| 44 | +Modo usuário (**sem privilégio** no Powershell): |
| 45 | +``` |
| 46 | +[Environment]::SetEnvironmentVariable( |
| 47 | + "Path", |
| 48 | + [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version", |
| 49 | + "User" |
| 50 | +) |
| 51 | +``` |
| 52 | +Depois de terminar, reinicie sua instância do Powershell. |
| 53 | + |
| 54 | +#### Configurando PATH no Linux, macOS, BSD |
| 55 | +Adicione a localização de seu binário zig à sua variável de ambiente `PATH`. |
| 56 | + |
| 57 | +Isso geralmente é feito adicionando uma linha de exportação ao seu script de inicialização do shell. (`.profile`, `.zshrc`, ...) |
| 58 | +```bash |
| 59 | +export PATH=$PATH:~/path/to/zig |
| 60 | +``` |
| 61 | +Depois de feito, seu arquivo inicial ou `source`, reinicie o shell. |
| 62 | + |
| 63 | + |
| 64 | + |
| 65 | + |
| 66 | +### Gerenciadores de pacotes |
| 67 | +#### Windows |
| 68 | +Zig está disponível no [Chocolatey](https://chocolatey.org/packages/zig). |
| 69 | +``` |
| 70 | +choco install zig |
| 71 | +``` |
| 72 | + |
| 73 | +#### macOS |
| 74 | + |
| 75 | +**Homebrew** |
| 76 | +NOTA: Homebrew ainda não possui os pacotes para Apple Silicon. Se você tem um M1 Mac, você deve compilar o Zig a partir da fonte. |
| 77 | + |
| 78 | +Última versão de lançamento: |
| 79 | +``` |
| 80 | +brew install zig |
| 81 | +``` |
| 82 | + |
| 83 | +Última compilação do *master branch* de Git: |
| 84 | +``` |
| 85 | +brew install zig --HEAD |
| 86 | +``` |
| 87 | + |
| 88 | +**MacPorts** |
| 89 | +``` |
| 90 | +port install zig |
| 91 | +``` |
| 92 | +#### Linux |
| 93 | +Zig também está presente em muitos gerentes de pacotes para Linux. [Aqui](https://github.com/ziglang/zig/wiki/Install-Zig-from-a-Package-Manager) |
| 94 | +você pode encontrar uma lista atualizada, mas tenha em mente que alguns pacotes podem conter versões desatualizadas do Zig. |
| 95 | + |
| 96 | +### Compilando da Fonte |
| 97 | +[Aqui](https://github.com/ziglang/zig/wiki/Building-Zig-From-Source) |
| 98 | +você pode encontrar mais informações sobre como construir Zig a partir da fonte para Linux, MacOS e Windows. |
| 99 | + |
| 100 | +## Ferramentas recomendadas |
| 101 | +### Sintaxe dos Higlighters e LSP |
| 102 | +Todos os principais editores de texto têm suporte de destaque de sintaxe para Zig. |
| 103 | +Alguns o empacotam, outros requerem a instalação de um plugin. |
| 104 | + |
| 105 | +Se você estiver interessado em uma integração mais profunda entre o Zig e seu editor, confira [zigtools/zls](https://github.com/zigtools/zls). |
| 106 | + |
| 107 | +Se você estiver interessado no que mais está disponível, confira a seção [Tools](../tools/). |
| 108 | + |
| 109 | +## Executar Hello World |
| 110 | +Se você completou o processo de instalação corretamente, agora você deverá ser capaz de invocar o compilador Zig a partir do shell. |
| 111 | +Vamos testar isso criando seu primeiro programa Zig! |
| 112 | + |
| 113 | +Navegue até o diretório de seus projetos e execute: |
| 114 | +```bash |
| 115 | +mkdir hello-world |
| 116 | +cd hello-world |
| 117 | +zig init-exe |
| 118 | +``` |
| 119 | + |
| 120 | +Isto deve sair: |
| 121 | +``` |
| 122 | +info: Created build.zig |
| 123 | +info: Created src/main.zig |
| 124 | +info: Next, try `zig build --help` or `zig build run` |
| 125 | +``` |
| 126 | + |
| 127 | +Executando `zig build run` deve então compilar o executável e executá-lo, resultando em última instância: |
| 128 | +``` |
| 129 | +info: All your codebase are belong to us. |
| 130 | +``` |
| 131 | + |
| 132 | +Parabéns, você tem uma instalação Zig funcionando! |
| 133 | + |
| 134 | +## Próximos passos |
| 135 | +**Verifique outros recursos presentes na seção** [Aprender](../), certifique-se de encontrar a Documentação de sua versão do Zig (nota: as construções nightly devem utilizar documentação `master`) e considerar dar uma lida no [ziglearn.org](https://ziglearn.org) também. |
| 136 | + |
| 137 | +Zig é um projeto jovem e infelizmente ainda não temos a capacidade de produzir extensa documentação e materiais de aprendizagem para tudo, portanto, você deve considerar [juntando-se a uma das comunidades Zig existentes](https://github.com/ziglang/zig/wiki/Community) |
| 138 | +para obter ajuda quando você ficar confuso, bem como para verificar iniciativas como [Zig SHOWTIME](https://zig.show). |
| 139 | + |
| 140 | +Finalmente, se você gosta de Zig e quer ajudar a acelerar o desenvolvimento, [considere fazer uma doação para a Zig Software Foundation](../../zsf) |
| 141 | +<img src="/heart.svg" style="vertical-align:middle; margin-right: 5px">. |
0 commit comments