apple/swift-nio

O que é?

Recursos principais

• 01I/O não bloqueante baseado em event loops, usando kqueue ou epoll conforme a plataforma.
• 02Modelo de Channel e ChannelPipeline para compor handlers de protocolo reutilizáveis.
• 03Implementações de baixo nível dos protocolos HTTP/1.1 e WebSocket.
• 04ByteBuffer para manipulação eficiente de bytes com copy-on-write.
• 05EmbeddedChannel e EmbeddedEventLoop para testar código de protocolo sem usar uma rede real.
• 06Compatível com macOS e Linux, com suporte experimental a OpenBSD.

Casos de uso

• Criar um servidor ou cliente de protocolo personalizado em Swift que precise lidar com muitas conexões simultâneas.
• Desenvolver uma biblioteca de rede ou um framework web de nível mais alto sobre um núcleo não bloqueante.
• Escrever serviços sensíveis ao desempenho, nos quais o modelo de uma thread por conexão é caro demais.
• Testar handlers de protocolo isoladamente usando o canal incorporado.

Início rápido

1. 1

   Adicione SwiftNIO às dependências do Package.swift usando um intervalo de versões como from: "2.0.0"

2. 2

   Adicione o produto NIO ao target e importe NIO no seu código Swift

Antes de usar

• !É um kit de ferramentas de rede de baixo nível, não um framework web de alto nível, portanto exige um bom entendimento do modelo de event loop e canais.
• !As versões recentes exigem uma toolchain Swift mais nova; por exemplo, a versão 2.98.0 e posteriores exigem Swift 6.1.
• !O SwiftNIO 1 chegou ao fim da vida útil e não recebe novos recursos.

Tópicos

Perguntas frequentes

O que é swift-nio?

Framework de rede multiplataforma e não bloqueante, baseado em eventos e escrito em Swift, para criar servidores e clientes de protocolos de alto desempenho, semelhante ao Netty. O SwiftNIO é um framework de rede de baixo nível para Swift que usa I/O não bloqueante e event loops para criar servidores e clientes de protocolos. Em vez de dedicar uma thread a cada conexão, ele multiplexa muitas conexões em um pequeno número de event loops, o que é adequado para servidores que mantêm um grande número de conexões relativamente ociosas. É descrito como a contraparte do Netty em Swift.

swift-nio é gratuito? Qual é a licença?

swift-nio é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

swift-nio ainda é mantido?

Manutenção ativa. O último commit de swift-nio foi em 19 de out. de 2026.

Para que posso usar swift-nio?

Criar um servidor ou cliente de protocolo personalizado em Swift que precise lidar com muitas conexões simultâneas. Desenvolver uma biblioteca de rede ou um framework web de nível mais alto sobre um núcleo não bloqueante. Escrever serviços sensíveis ao desempenho, nos quais o modelo de uma thread por conexão é caro demais. Testar handlers de protocolo isoladamente usando o canal incorporado.

Como instalar swift-nio?

Adicione SwiftNIO às dependências do Package.swift usando um intervalo de versões como from: "2.0.0" Adicione o produto NIO ao target e importe NIO no seu código Swift

Onde consigo swift-nio?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/apple/swift-nio