1. O que são e por que usar

Actors são um conceito fundamental da linguagem Swift, introduzido no Swift 5.5, que resolve um dos problemas mais complexos da programação: o trabalho seguro com estado mutável compartilhado em ambientes multithread. Antes dos Actors, os desenvolvedores precisavam gerenciar manualmente locks, semáforos e filas de despacho (DispatchQueue), o que gerava erros difíceis de detectar, como condições de corrida (data races) e deadlocks. Os Actors fornecem um mecanismo de isolamento de estado integrado à linguagem, garantindo que o acesso aos dados dentro de um actor ocorra sempre de forma sequencial, mesmo quando acessado por várias threads simultaneamente.

A ideia principal dos Actors é que cada actor protege seu próprio estado. O código externo não pode acessar diretamente as propriedades armazenadas de um actor — apenas através de seus métodos. O compilador Swift verifica isso rigorosamente, gerando um erro se você tentar ler ou modificar uma propriedade de um actor de fora sem usar a palavra-chave await. Isso torna o modelo de Actors não apenas uma biblioteca, mas parte do sistema de tipos da linguagem, permitindo detectar problemas potenciais de concorrência em tempo de compilação, e não durante a execução.

Por que usar? No desenvolvimento moderno para iOS, macOS, watchOS e tvOS, praticamente qualquer aplicativo lida com rede, bancos de dados ou interface do usuário, exigindo operações assíncronas. Os Actors permitem escrever código concorrente que é fácil de ler, manter e depurar. Eles são especialmente úteis ao trabalhar com recursos compartilhados, como caches, gerenciadores de estado, pools de conexão e qualquer outro objeto que possa ser acessado simultaneamente por diferentes partes do aplicativo. Actors não são apenas "mais uma ferramenta", mas uma mudança fundamental na forma como desenvolvedores Swift pensam sobre concorrência.

2. Instalação

Actors são uma parte integrada da linguagem Swift desde a versão 5.5. Para usá-los, não é necessário instalar bibliotecas externas ou pacotes via gerenciadores de dependência (CocoaPods, Swift Package Manager, Carthage). Tudo o que você precisa é de um projeto configurado para usar Swift 5.5 ou superior.

Verificando a versão do Swift

Certifique-se de ter uma versão compatível do compilador. Para isso, execute no terminal:

swift --version

Você deve ver uma linha contendo Swift version 5.5 ou superior. Se a versão for inferior, atualize o Xcode (no macOS) ou instale o toolkit Swift mais recente do site oficial.

Configuração do projeto

Se você usa Xcode, verifique se nas configurações do projeto (Build Settings) o parâmetro Swift Language Version está definido como Swift 5.5 ou superior. Para projetos com Swift Package Manager (SPM), a versão mínima da plataforma deve ser .iOS(.v15), .macOS(.v12), .tvOS(.v15) ou .watchOS(.v8) — a partir dessas versões a Apple começou a oferecer suporte completo aos Actors em seus frameworks.

Exemplo de configuração do Package.swift:

// swift-tools-version:5.7
import PackageDescription

let package = Package(
    name: "MeuProjetoActor",
    platforms: [
        .iOS(.v15),
        .macOS(.v12)
    ],
    dependencies: [],
    targets: [
        .target(
            name: "MeuProjetoActor",
            dependencies: []),
        .testTarget(
            name: "MeuProjetoActorTests",
            dependencies: ["MeuProjetoActor"])
    ]
)

Pronto. Nenhum comando adicional como pip install é necessário.