Uso de GraphQL en Swift: bibliotecas Apollo y Relay para iOS/macOS

Bibliotecas GraphQL para Swift (iOS/macOS): guía completa

GraphQL es un lenguaje de consulta moderno para API que permite a los clientes solicitar solo los datos que necesitan. Para los desarrolladores de Swift que crean aplicaciones para iOS y macOS, existen potentes bibliotecas que simplifican la integración con servidores GraphQL. En este artículo, analizaremos dos bibliotecas principales: Apollo iOS y Relay (a través de envoltorios de Swift), y proporcionaremos ejemplos prácticos de código.

¿Qué es GraphQL y por qué es importante para Swift?

GraphQL resuelve el problema de sobrecarga y subcarga de datos que a menudo ocurre al usar REST API. En Swift, esto es especialmente relevante para aplicaciones móviles, donde cada kilobyte adicional de datos puede afectar el rendimiento y el tiempo de carga. Las principales ventajas de GraphQL para iOS/macOS son:

• Consultas flexibles — el cliente decide qué campos obtener
• Tipado fuerte — los esquemas de GraphQL generan automáticamente tipos Swift
• Soporte de suscripciones — actualizaciones en tiempo real a través de WebSocket
• Punto de entrada único — un endpoint para todas las consultas

Biblioteca Apollo iOS

Apollo iOS es la biblioteca GraphQL más popular para Swift, desarrollada por Apollo GraphQL. Proporciona un conjunto completo de herramientas para trabajar con GraphQL: desde generación de código hasta almacenamiento en caché y manejo de errores.

Instalación de Apollo iOS

Para la instalación, use Swift Package Manager. Agregue la dependencia en su Package.swift:

// swift-tools-version:5.7import PackageDescription

let package = Package(    name: "MyApp",    dependencies: [        .package(url: "https://github.com/apollographql/apollo-ios.git", from: "1.0.0")    ],    targets: [        .target(name: "MyApp", dependencies: [            .product(name: "Apollo", package: "apollo-ios")        ])    ])

También se puede instalar a través de CocoaPods o Carthage, pero SPM es el método recomendado.

Configuración del cliente Apollo

Cree una instancia de ApolloClient con la URL de su servidor GraphQL:

import Apollo

class NetworkManager {    static let shared = NetworkManager()        private(set) lazy var apollo: ApolloClient = {        let url = URL(string: "https://api.example.com/graphql")!        return ApolloClient(url: url)    }()}

Ejemplo de consulta con Apollo iOS

Supongamos que tiene un esquema con el tipo User y los campos id, name, email. Creemos una consulta:

import Apollo

// Definimos la consulta GraphQL (generalmente en un archivo .graphql)let query = """    query GetUser($id: ID!) {        user(id: $id) {            id            name            email        }    }"""

// Ejecutamos la consultaNetworkManager.shared.apollo.fetch(query: query, variables: ["id": "123"]) { result in    switch result {    case .success(let graphQLResult):        if let user = graphQLResult.data?.user {            print("Usuario: \\(user.name), Email: \\(user.email)")        }    case .failure(let error):        print("Error: \\(error)")    }}

Tenga en cuenta: Apollo genera automáticamente tipos Swift para sus consultas (por ejemplo, GetUserQuery) si usa su herramienta de generación de código. Para ello, ejecute apollo-ios-cli con su esquema.

Mutaciones y suscripciones

Apollo admite mutaciones (cambio de datos) y suscripciones (tiempo real). Ejemplo de mutación:

let mutation = """    mutation UpdateUser($id: ID!, $name: String!) {        updateUser(id: $id, name: $name) {            id            name        }    }"""

NetworkManager.shared.apollo.pe