Gerando UUID no iOS em Swift: guia completo para iniciantes

O que é UUID e por que ele é necessário em um aplicativo iOS?

Imagine que você está criando um aplicativo de anotações. Cada anotação precisa de um "passaporte" único para se diferenciar das outras. Esse passaporte no mundo da programação é o UUID (Universally Unique Identifier) — um identificador universal único. No desenvolvimento iOS com Swift, a geração de UUID é uma tarefa básica, mas criticamente importante, que todo desenvolvedor resolve mais cedo ou mais tarde.

No Stack Overflow, a pergunta "Generate a UUID on iOS from Swift" acumulou milhares de visualizações. Por quê? Porque até programadores experientes às vezes se confundem: qual classe usar? É necessário importar bibliotecas adicionais? Qual UUID é considerado "correto"?

Neste artigo, vamos analisar tudo do zero. Você aprenderá como gerar UUID no iOS com Swift, entenderá a diferença entre as versões de UUID e aprenderá a aplicá-las na prática. Vamos lá!

Fundamentos: como gerar UUID em Swift em uma linha

A maneira mais simples de obter um UUID no iOS é usar a classe integrada UUID do framework Foundation. Ela está disponível "de fábrica" e não requer imports adicionais.

Exemplo básico

import Foundation\n\nlet myUUID = UUID()\nprint(myUUID.uuidString)\n// Saída: "E621E1F8-C36C-495A-93FC-0C247A3E6E5F"

Pronto! Você acabou de gerar um UUID versão 4 — um identificador aleatório que, com altíssima probabilidade, será único em todo o universo. Observe a propriedade uuidString: ela retorna uma string no formato padrão XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.

O que há dentro de um UUID?

O objeto UUID em Swift armazena um valor de 128 bits. Você pode obtê-lo em sua forma bruta:

let uuid = UUID()\nlet uuidBytes = uuid.uuid // (UInt8, UInt8, ..., UInt8) — tupla de 16 bytes\nprint(uuidBytes.0) // Primeiro byte

Mas, na prática, geralmente se trabalha com a representação em string.

UUID a partir de uma string: operação inversa

Às vezes você já tem uma string UUID (por exemplo, de um banco de dados ou API) e precisa criar um objeto UUID para trabalhar. O Swift permite isso através de um inicializador:

let uuidString = "550e8400-e29b-41d4-a716-446655440000"\nif let uuid = UUID(uuidString: uuidString) {\n    print("UUID criado com sucesso: \\(uuid)")\n} else {\n    print("Formato UUID inválido")\n}

Observe: o inicializador retorna um valor opcional. Se a string não corresponder ao formato UUID, você receberá nil. Isso protege seu código contra dados incorretos.

Comparação de UUID: como verificar identidade

Swift implementa o protocolo Equatable para UUID, portanto, você pode compará-los diretamente:

let uuid1 = UUID()\nlet uuid2 = UUID()\nlet uuid3 = uuid1\n\nprint(uuid1 == uuid2) // false (UUIDs diferentes)\nprint(uuid1 == uuid3) // true (mesmo objeto)

Isso é útil para encontrar duplicatas ou verificar a presença de um identificador em uma coleção.

UUID como chave em dicionários e conjuntos

A classe UUID também implementa o protocolo Hashable, o que permite usá-la como chave em dicionários e elemento de conjunto:

var userSessions: [UUID: String] = [:]\nlet sessionId = UUID()\nuserSessions[sessionId] = "Sessão de usuário ativa"\n\nlet allIds: Set<UUID> = [UUID(), UUID(), UUID()]\nprint(allIds.count) // 3

Esta é uma ótima maneira de organizar dados se você precisar de chaves garantidamente únicas.

Quais são as versões de UUID? (E por que isso é importante para você)

O padrão UUID define várias versões. No iOS com Swift, por padrão, é gerado um UUID versão 4 (aleatório). Mas e as outras versões?

\n
• UUID v1 — baseado em tempo