EventKit para Swift: Guia Completo para Trabalhar com Calendário e Lembretes

EventKit é um poderoso framework da Apple que oferece aos desenvolvedores Swift uma interface unificada para interagir com bancos de dados de calendário e lembretes em dispositivos iOS, iPadOS, macOS e watchOS. Ele permite não apenas ler eventos e tarefas, mas também criar, editar e excluí-los, além de assinar notificações sobre alterações. Esta biblioteca é a ferramenta essencial para criar aplicativos de planejamento, rastreadores de tarefas, calendários corporativos e qualquer outro programa que exija gerenciamento de tempo do usuário.

Por que usar o EventKit? No mundo moderno, gerenciar o tempo é uma tarefa crítica. O EventKit permite que você integre seu aplicativo aos calendários e lembretes nativos do iOS/macOS, eliminando a necessidade do usuário alternar entre diferentes programas. Você pode adicionar automaticamente reuniões do seu serviço ao calendário do usuário, sincronizar prazos de tarefas com lembretes ou analisar a disponibilidade. Sem o EventKit, cada aplicativo seria uma "ilha" isolada de dados; com ele, torna-se parte do ecossistema unificado da Apple.

É importante entender que o EventKit não é uma biblioteca de terceiros, mas sim um framework do sistema. Ele está embutido no SDK da Apple e não requer instalação via gerenciadores de pacotes para uso básico. No entanto, para facilitar o trabalho e adicionar funcionalidades extras (como atualizações reativas), os desenvolvedores costumam usar wrappers como RxEventKit ou EventKitUI. Neste artigo, focaremos no EventKit puro, pois é a base de tudo.

Instalação (Vinculação ao Projeto)

Como o EventKit faz parte do framework do sistema Apple, sua "instalação" se resume a importar o módulo no seu código. Comandos como pip ou npm não se aplicam aqui. Para vincular, siga estas etapas:

1. Importação no arquivo Swift: No início do seu arquivo, adicione import EventKit.
2. Adicionar o framework ao projeto (se necessário): Normalmente, o Xcode vincula automaticamente os frameworks do sistema. Caso contrário, vá em Target > General > Frameworks, Libraries, and Embedded Content, clique em "+" e adicione EventKit.framework.
3. Configuração do Info.plist: Para acessar o calendário e os lembretes, você precisa adicionar strings de privacidade:
   • NSCalendarsUsageDescription — texto explicando por que o aplicativo precisa de acesso ao calendário (ex: "Para adicionar compromissos").
   • NSRemindersUsageDescription — texto para acesso aos lembretes.
   Sem essas strings, o aplicativo irá travar ao tentar solicitar acesso.

// Instalação não é necessária, basta importar o framework
import EventKit
import UIKit

class ViewController: UIViewController {
    // Seu código
}

Início Rápido: Exemplo Mínimo Funcional

Vamos criar um aplicativo simples que solicita acesso ao calendário e cria um evento "Reunião de Teste" para amanhã.

import EventKit
import UIKit

class QuickStartViewController: UIViewController {

    let eventStore = EKEventStore()

    override func viewDidLoad() {
        super.viewDidLoad()
        requestAccessAndCreateEvent()
    }

    func requestAccessAndCreateEvent() {
        // 1. Solicita acesso ao calendário
        eventStore.requestAccess(to: .event) { [weak self] (granted, error) in
            guard let self = self else { return }
            
            if granted && error == nil {
                // 2. Cria o evento
                let event = EKEvent(eventStore: self.eventStore)
                event.title = "Reunião de Teste"
                event.startDa