GraphQLAPIKit

Lightweight GraphQL API client based on Apollo iOS. Developed to simplify Futured in-house development of applications, that work with GraphQL APIs.

Currently there is no support for some Apollo's features:

• Apollo built-in cache
• GraphQL subscriptions
• Custom interceptors

Installation

Install or add following line to your dependencies:

.package(url: "https://github.com/futuredapp/GraphQLAPIKit.git", from: "1.0.0")

Setup Your Project

Make sure that GraphQLAPIKit is added as a package dependency to your project

1. Create GraphQLGenerated folder at your ProjectName.xcodeproj level

2. Add Apollo configuration file

Add apollo-codegen-config.json file and add it to GraphQLGenerated folder. Copy and paste json configuration to the newly created file:

{
  "schemaName" : "GraphQLGenerated",
  "input" : {
    "operationSearchPaths" : [
      "**/*.graphql"
    ],
    "schemaSearchPaths" : [
      "./schema.json"
    ]
  },
  "output" : {
    "schemaTypes" : {
      "path" : "./",
      "moduleType" : {
        "swiftPackageManager": {}
      }
    },
    "operations" : {
      "inSchemaModule" : {}
    },
    "testMocks" : {
      "swiftPackage": {
        "targetName": "GraphQLGeneratedMocks"
      }
    }
  }
}

3. Add schema file

Add GraphQL JSON schema to the GraphQLGenerated folder and name it schema.json.

4. Add Queries And Mutations Folders

Add Queries and Mutations folders to GraphQLGenerated folder.

5. Define Your first GraphQL Query Or Mutation

Add your first Query or Mutation and save it with .graphql extension to Queries or Mutations folders.

6. Add Xcode Biuld Phase Script

At your main app's target add a new build phase named Generate GraphQL Operations. Move your newly created build phase above the Compile Sources phase. Add script:

SDKROOT=$(/usr/bin/xcrun --sdk macosx --show-sdk-path)
SWIFT_PACKAGES="${BUILD_DIR%/Build/*}/SourcePackages/checkouts"

${SWIFT_PACKAGES}/GraphQLAPIKit/Resources/apollo-ios-cli generate --path ./GraphQLGenerated/apollo-codegen-config.json

7. Disable User Script Sandboxing

Go to your application main target's Build Settings and set User Script Sandboxing to NO

8. Build your main target

9. Add GraphQLGenerated local package

• Go to Xcode -> File -> Add Package Dependencies..
• Choose Add Local...
• Add GraphQLGenerated as local Swift Package. Make sure, that GraphQLGenerated library was added to your main's target Frameworks, Libraries, and Embedded Content list. For your project's test target add GraphQLGeneratedMocks library if necessary.

10. Update .gitignore file

Add *.graphql.swift to your repository's git ignore file to ignore Apollo generated code.

Content of generated Schema folder has to be commited to the repository

11. Exclude GraphQLGenerated folder from your linter's rule if necessary

Usage

Defining Query or Mutation

import GraphQLAPIKit
import GraphQLGenerated

let query = MyExampleQuery()
let mutation = MyExampleMutation()

Fetching the query/perform mutation

import GraphQLAPIKit
import GraphQLGenerated

let apiAdapter = GraphQLAPIAdapter(url: URL(string: "https://MyAPIUrl.com")!)
let queryResult = await apiAdapter.fetch(query: query)
let mutationResult = await apiAdapter.perform(mutation: mutation)

Contributors

• Ievgen Samoilyk, [email protected].

License

GraphQLAPIKit is available under the MIT license. See the LICENSE file for more information.