Setup · Apollo iOS · apollographql/skills · Skills Docs

Setup · Apollo iOS · apollographql/skills · Skills Docs

Product	Link when the target…
`Apollo`	…creates or uses `ApolloClient` — executes operations, configures the interceptor chain, reads/writes the normalized cache directly. Depends on `ApolloAPI`, so linking `Apollo` gives you the generated types as well.
`ApolloAPI`	…only consumes generated response models (queries, mutations, fragments) without ever touching `ApolloClient`. Typical for UI / presentation modules in multi-module apps.
`ApolloSQLite`	…wires up `SQLiteNormalizedCache` (persistent on-disk cache). Usually the same target that constructs `ApolloClient`.
`ApolloWebSocket`	…uses `WebSocketTransport` — for subscription-only WebSocket setups, or when every operation flows over the WebSocket. See subscriptions.md.
`ApolloTestSupport`	…is a test target using generated `Mock<Type>` fixtures. See testing.md.

.target(
  name: "DataLayer",
  dependencies: [
    .product(name: "Apollo", package: "apollo-ios"),
    .product(name: "ApolloSQLite", package: "apollo-ios"),
    "MyAPI", // the generated schema package — see codegen.md
  ]
),
.target(
  name: "Feature",
  dependencies: [
    .product(name: "ApolloAPI", package: "apollo-ios"),
    "MyAPI",
  ]
),

{
  "schemaNamespace": "MyAPI",
  "input": {
    "schemaSearchPaths": ["**/*.graphqls"],
    "operationSearchPaths": ["**/*.graphql"]
  },
  "output": {
    "schemaTypes": {
      "path": "./MyAPI",
      "moduleType": { "swiftPackage": {} }
    },
    "operations": { "relative": {} },
    "testMocks": { "none": {} }
  }
}

{
  "schemaDownload": {
    "downloadMethod": {
      "introspection": {
        "endpointURL": "https://api.example.com/graphql"
      }
    },
    "outputPath": "./MyAPI/schema.graphqls"
  }
}

import Apollo
import ApolloSQLite

func makeApolloClient() throws -> ApolloClient {
  let cacheURL = try FileManager.default
    .url(for: .cachesDirectory, in: .userDomainMask, appropriateFor: nil, create: true)
    .appendingPathComponent("apollo_cache.sqlite")

  let cache = try SQLiteNormalizedCache(fileURL: cacheURL)
  let store = ApolloStore(cache: cache)

  let endpointURL = URL(string: "https://api.example.com/graphql")!
  let transport = RequestChainNetworkTransport(
    urlSession: URLSession(configuration: .default),
    interceptorProvider: DefaultInterceptorProvider(store: store),
    store: store,
    endpointURL: endpointURL
  )

  return ApolloClient(networkTransport: transport, store: store)
}

import SwiftUI
import Apollo

extension EnvironmentValues {
  @Entry var apolloClient: ApolloClient = {
    // Replace with your real client. Using a throwing factory from app startup
    // and guarding against failure is preferable to force-unwrap in production.
    try! makeApolloClient()
  }()
}

@main
struct MyApp: App {
  private let apolloClient: ApolloClient

  init() {
    self.apolloClient = try! makeApolloClient()
  }

  var body: some Scene {
    WindowGroup {
      RootView()
        .environment(\.apolloClient, apolloClient)
    }
  }
}