{"id":126,"date":"2017-05-05T19:40:03","date_gmt":"2017-05-05T22:40:03","guid":{"rendered":"https:\/\/www.linuxpro.com.br\/2017\/05\/instalando-swift-no-linux\/"},"modified":"2026-09-12T09:48:39","modified_gmt":"2026-09-12T12:48:39","slug":"instalando-swift-no-linux","status":"publish","type":"post","link":"https:\/\/www.linuxpro.com.br\/es\/2017\/05\/instalando-swift-no-linux\/","title":{"rendered":"Swift en Linux: instalaci\u00f3n, Hola Mundo y primer proyecto"},"content":{"rendered":"

\"Mascote<\/p>\n

Nota (2026):<\/strong> Publicado originalmente em maio de 2017 para Swift 3.1 no Ubuntu; este guia foi revisado em 12 de setembro de 2026 para o fluxo atual com Swiftly, mantendo a URL e a data hist\u00f3rica.<\/div>\n

Quer experimentar Swift no Linux sem come\u00e7ar por um projeto enorme? Vamos instalar a linguagem, executar um Hello World, gerar um bin\u00e1rio e montar uma pequena ferramenta de terminal com argumentos. O objetivo \u00e9 sair deste artigo com c\u00f3digo funcionando e entender a diferen\u00e7a entre swift<\/code>, swiftc<\/code> e Swift Package Manager.<\/p>\n

<\/p>\n

Antes de instalar: linguagem Swift n\u00e3o \u00e9 OpenStack Swift<\/h2>\n

Este tutorial trata da linguagem de programa\u00e7\u00e3o. O pacote chamado swift no Debian<\/a> pertence ao OpenStack, um sistema de armazenamento de objetos. N\u00e3o use apt install swift<\/code> como atalho para instalar o compilador deste artigo: confira sempre a descri\u00e7\u00e3o do pacote.<\/p>\n

Use uma distribui\u00e7\u00e3o e arquitetura presentes nas op\u00e7\u00f5es oficiais de instala\u00e7\u00e3o do Swift no Linux<\/a>. Os exemplos de prepara\u00e7\u00e3o abaixo usam Ubuntu\/Debian e Bash. Veja a distribui\u00e7\u00e3o e a arquitetura antes de escolher qualquer download:<\/p>\n

cat \/etc\/os-release\nuname -m<\/code><\/pre>\n
Para come\u00e7ar, reserve uma pasta no seu usu\u00e1rio e tenha acesso \u00e0 internet. Depend\u00eancias do sistema podem exigir sudo; o projeto e os comandos de compila\u00e7\u00e3o n\u00e3o precisam ser executados como root.<\/p>\n
Instale com Swiftly e confira a assinatura<\/h2>\n
O Swiftly gerencia as toolchains da linguagem. Na consulta de 12\/09\/2026, a p\u00e1gina oficial indicava Swift 6.3.3 e Swiftly 1.1.2. As vers\u00f5es podem mudar: confira a instru\u00e7\u00e3o oficial do Swiftly<\/a> antes de repetir o procedimento no futuro.<\/p>\n
sudo apt update && sudo apt install -y ca-certificates curl gnupg tar<\/code><\/pre>\n
Baixe o instalador, as chaves publicadas pelo projeto e a assinatura. A vari\u00e1vel ARCH<\/code> deve corresponder a uma arquitetura oferecida pelo site, como x86_64<\/code> o aarch64<\/code>:<\/p>\n
mkdir -p \"$HOME\/Downloads\/swiftly-linuxpro\"\ncd \"$HOME\/Downloads\/swiftly-linuxpro\"\nARCH=\"$(uname -m)\"\nARQUIVO=\"swiftly-1.1.2-${ARCH}.tar.gz\"\nBASE=\"https:\/\/download.swift.org\/swiftly\/linux\"\n\ncurl -fLO \"$BASE\/$ARQUIVO\" &&\ncurl -fLO \"$BASE\/$ARQUIVO.sig\" &&\ncurl -fL https:\/\/www.swift.org\/keys\/all-keys.asc -o swift-keys.asc &&\ngpg --import swift-keys.asc &&\ngpg --verify \"$ARQUIVO.sig\" \"$ARQUIVO\"<\/code><\/pre>\n
Se a verifica\u00e7\u00e3o falhar, pare: n\u00e3o extraia nem execute aquele arquivo. Depois de confirmar a assinatura, inicialize o Swiftly:<\/p>\n
tar -xzf \"$ARQUIVO\" &&\n.\/swiftly init --quiet-shell-followup &&\n. \"${SWIFTLY_HOME_DIR:-$HOME\/.local\/share\/swiftly}\/env.sh\" &&\nhash -r\n\nswift --version\nswiftc --version<\/code><\/pre>\n
A inicializa\u00e7\u00e3o baixa a toolchain e informa os pacotes necess\u00e1rios que estiverem faltando. Siga essas orienta\u00e7\u00f5es para a sua distribui\u00e7\u00e3o. O arquivo de ambiente ajusta a sess\u00e3o atual; em outro terminal, confira novamente swift --version<\/code>. N\u00e3o reutilize listas antigas de bibliotecas do Ubuntu 16.04.<\/p>\n
Hello World b\u00e1sico: um arquivo e uma linha<\/h2>\n
Comece fora da pasta do instalador. Crie um diret\u00f3rio de estudos e um arquivo chamado hello.swift<\/code>:<\/p>\n
mkdir -p \"$HOME\/projetos\/swift-linuxpro\"\ncd \"$HOME\/projetos\/swift-linuxpro\"\ncat > hello.swift <<'SWIFT'\nprint(\"Hello, world!\")\nSWIFT\n\nswift hello.swift<\/code><\/pre>\n
A sa\u00edda esperada \u00e9:<\/p>\n
Hello, world!<\/code><\/pre>\n
Aqui, print<\/code> escreve uma mensagem na sa\u00edda padr\u00e3o. A chamada swift hello.swift<\/code> executa o arquivo sem voc\u00ea administrar manualmente um execut\u00e1vel. \u00c9 um bom caminho para pequenos experimentos; n\u00e3o \u00e9 necess\u00e1rio criar um pacote para cada teste.<\/p>\n
Compile o mesmo programa com swiftc<\/h2>\n
Agora gere um execut\u00e1vel com nome definido:<\/p>\n
swiftc hello.swift -o hello\n.\/hello<\/code><\/pre>\n
A mensagem \u00e9 a mesma, mas o fluxo mudou: primeiro voc\u00ea compilou; depois executou .\/hello<\/code>. Quando alterar o c\u00f3digo, rode o compilador novamente para atualizar o bin\u00e1rio. O prefixo .\/<\/code> indica que o arquivo est\u00e1 no diret\u00f3rio atual.<\/p>\n
Um bin\u00e1rio compilado no seu computador n\u00e3o \u00e9 automaticamente compat\u00edvel com todo Linux. Arquitetura, bibliotecas e runtime do ambiente de destino importam. Para distribui\u00e7\u00e3o mais controlada, estude o Swift SDK for Static Linux<\/a>; isso \u00e9 uma etapa posterior ao Hello World.<\/p>\n
Crie uma ferramenta com Swift Package Manager<\/h2>\n
Quando o c\u00f3digo ganha mais arquivos e depend\u00eancias, use o Swift Package Manager, que acompanha a toolchain. Em vez de gerenciar tudo manualmente, ele organiza o manifesto e a compila\u00e7\u00e3o. Crie um projeto novo dentro do diret\u00f3rio de estudos:<\/p>\n
mkdir OlaLinux\ncd OlaLinux\nswift package init --name OlaLinux --type executable\nswift run OlaLinux<\/code><\/pre>\n
O modelo inicial j\u00e1 imprime uma sauda\u00e7\u00e3o. Na toolchain Swift 6.3.3 testada nesta revis\u00e3o, Package.swift<\/code> \u00e9 o manifesto e Sources\/OlaLinux\/OlaLinux.swift<\/code> \u00e9 o ponto de entrada. Confira a estrutura criada pela sua vers\u00e3o antes de editar arquivos. O guia oficial de ferramentas de linha de comando<\/a> explica esse fluxo.<\/p>\n
Substitua o conte\u00fado de Sources\/OlaLinux\/OlaLinux.swift<\/code> pelo exemplo abaixo. Ele aceita um nome no terminal e usa LinuxPro quando nenhum argumento \u00e9 informado:<\/p>\n
@main\nstruct OlaLinux {\n    static func saudacao(para pessoa: String) -> String {\n        return \"Ol\u00e1, \\(pessoa)! Swift est\u00e1 rodando no Linux.\"\n    }\n\n    static func main() {\n        let nome = CommandLine.arguments.dropFirst().first ?? \"LinuxPro\"\n        print(saudacao(para: nome))\n    }\n}<\/code><\/pre>\n
swift run OlaLinux\nswift run OlaLinux Nilton<\/code><\/pre>\n
As mensagens esperadas s\u00e3o, respectivamente:<\/p>\n
Ol\u00e1, LinuxPro! Swift est\u00e1 rodando no Linux.\nOl\u00e1, Nilton! Swift est\u00e1 rodando no Linux.<\/code><\/pre>\n
O marcador @main<\/code> define o ponto de entrada, que chama main()<\/code>. Neste c\u00f3digo, let<\/code> declara um valor que n\u00e3o ser\u00e1 reatribu\u00eddo. CommandLine.arguments<\/code> cont\u00e9m os argumentos do processo; dropFirst()<\/code> pula o nome do execut\u00e1vel e first<\/code> obt\u00e9m o pr\u00f3ximo item, se existir. O operador ??<\/code> fornece o valor padr\u00e3o. A fun\u00e7\u00e3o recebe um nome e devolve a mensagem usando interpola\u00e7\u00e3o de strings.<\/p>\n
Para estudar a sintaxe com mais calma, siga o tour oficial da linguagem Swift<\/a>. Para uma CLI com op\u00e7\u00f5es, ajuda e valida\u00e7\u00e3o de entradas, o pr\u00f3ximo passo \u00e9 o Swift Argument Parser<\/a>; n\u00e3o precisamos adicionar depend\u00eancias para esta primeira sauda\u00e7\u00e3o.<\/p>\n
Adicione um teste automatizado<\/h2>\n
O modelo testado tamb\u00e9m criou uma pasta de testes. Substitua Tests\/OlaLinuxTests\/OlaLinuxTests.swift<\/code> pelo exemplo abaixo, que verifica a mensagem produzida pela fun\u00e7\u00e3o sem depender da sa\u00edda do terminal:<\/p>\n
import Testing\n@testable import OlaLinux\n\n@Test func saudacaoIncluiNome() {\n    #expect(OlaLinux.saudacao(para: \"Nilton\") ==\n        \"Ol\u00e1, Nilton! Swift est\u00e1 rodando no Linux.\")\n}<\/code><\/pre>\n
swift test<\/code><\/pre>\n
A anota\u00e7\u00e3o @Test<\/code> identifica o teste e #expect<\/code> confere o resultado. Se voc\u00ea mudar a sauda\u00e7\u00e3o, atualize a expectativa conscientemente; uma falha deve provocar investiga\u00e7\u00e3o, n\u00e3o ser escondida. O @testable import<\/code> permite testar a l\u00f3gica interna deste m\u00f3dulo.<\/p>\n
Gere a vers\u00e3o release e fa\u00e7a um teste r\u00e1pido<\/h2>\n
Dentro da pasta que cont\u00e9m Package.swift<\/code>, compile a configura\u00e7\u00e3o release e execute o resultado:<\/p>\n
swift build -c release\n.build\/release\/OlaLinux Nilton<\/code><\/pre>\n
Um teste simples de sa\u00edda ajuda a detectar regress\u00f5es ao modificar esse exemplo:<\/p>\n
test \"$(.build\/release\/OlaLinux Nilton)\" =   \"Ol\u00e1, Nilton! Swift est\u00e1 rodando no Linux.\" && echo \"OK\"<\/code><\/pre>\n
Isso \u00e9 apenas uma verifica\u00e7\u00e3o b\u00e1sica do programa, n\u00e3o uma su\u00edte completa de testes. Em um projeto maior, separe a l\u00f3gica em m\u00f3dulos test\u00e1veis. Para publicar o projeto no Git, mantenha o c\u00f3digo e o manifesto; a pasta de resultados .build\/<\/code> n\u00e3o precisa entrar no reposit\u00f3rio.<\/p>\n
Alternativa: experimente usando Docker<\/h2>\n
Se o Docker j\u00e1 est\u00e1 instalado, a imagem oficial do Swift<\/a> permite testar sem instalar a toolchain no host. Este exemplo fixa a vers\u00e3o usada na revis\u00e3o e n\u00e3o precisa de modo privilegiado:<\/p>\n
docker run --rm swift:6.3.3 swift --version\n\ncd \"$HOME\/projetos\/swift-linuxpro\"\ndocker run --rm   --mount \"type=bind,source=$PWD,target=\/work,readonly\"   -w \/work swift:6.3.3 swift hello.swift<\/code><\/pre>\n
A montagem \u00e9 somente leitura porque esse comando apenas executa o script. A primeira chamada pode baixar a imagem. Para aprender o b\u00e1sico de containers, veja tamb\u00e9m o curso de Docker<\/a>. N\u00e3o misture sem cuidado arquivos de build gerados em containers com os do seu host.<\/p>\n
Editor e problemas comuns<\/h2>\n
No VS Code, instale a extens\u00e3o Swift e abra a pasta do projeto, n\u00e3o apenas um arquivo avulso. Ela integra navega\u00e7\u00e3o de c\u00f3digo, depura\u00e7\u00e3o e recursos de testes; o guia oficial de configura\u00e7\u00e3o<\/a> detalha o ambiente. O blog tamb\u00e9m tem um guia de VS Code no Ubuntu<\/a>.<\/p>\n