ImageKit.io iOS SDK

iOS Pod for ImageKit.io which implements client-side upload and URL generation for use inside an iOS application.

ImageKit is a complete image optimization and transformation solution with an image CDN and media storage. It can be integrated with your existing infrastructure - storages like AWS S3, web servers, your CDN, and custom domain names, allowing you to deliver optimized images in minutes with minimal code changes.

Swift client for Imagekit Integration

Requirements

The library requires Swift 4.0 or above.

CocoaPods

You can use CocoaPods to install ImageKit by adding it to your Podfile:

use_frameworks!

target 'target_name' do
    pod 'ImageKitIO', '~> 1.1.0'
end

Initialization

You need to initialize the SDK by providing the publicKey and the urlEndpoint. You can do this either in your application or launcher activity. This needs to be called before any other function in the SDK, or else an exception would be thrown.

authenticationEndpoint is only required if you want to use the upload functionality.

Note: Do not include your Private Key in any client-side code, including this SDK or its initialization.

// AppDelegate.swift

ImageKit.init(
    clientPublicKey: "your_public_api_key=", 
    imageKitEndpoint: "https://ik.imagekit.io/your_imagekit_id", transformationPosition: "path", 
    authenticationEndpoint: "http://www.yourserver.com/auth")

Sample application

This project has a sample application under the Example folder. The sample application demonstrates the use of this SDK.

To run the sample application, add Public Key to Example/ImageKit/AppDelegate.swift and add Private Key to Server/.env

npm install
node index.js

Usage

URL construction

Using image path

//https://ik.imagekit.io/your_imagekit_id/default-image.jpg?tr=h-400.00,ar-3-2
ImageKit.shared.url(
            path: "default-image.jpg",
            transformationPosition: "query"
        )
        .height(height: 400)
        .aspectRatio(width: 3, height: 2)
        .create()

Using full image URL

// https://ik.imagekit.io/your_imagekit_id/medium_cafe_B1iTdD0C.jpg?tr=oi-logo-white_SJwqB4Nfe.png,ox-10,oy-20
ImageKit.shared.url(
            src: "https://ik.imagekit.io/your_imagekit_id/medium_cafe_B1iTdD0C.jpg",
            transformationPosition: "path"
        )
        .overlayImage("logo-white_SJwqB4Nfe.png")
        .overlayX(10)
        .overlayY(20)
        .create()

Using a custom parameter

// https://ik.imagekit.io/your_imagekit_id/plant.jpeg?tr=w-400,ot-Hand with a green plant,otc-264120,ots-30,ox-10,oy-10
ImageKit.shared.url(
    src : "https://ik.imagekit.io/your_imagekit_id/plant.jpeg?tr=oi-logo-white_SJwqB4Nfe.png,ox-10,oy-20"
    )
        .addCustomTransformation("w", "400")
        .overlayText("Hand with a green plant")
        .overlayTextColor("264120")
        .overlayTextSize(30)
        .overlayX(10)
        .overlayY(10)
        .create()

List of supported transformations

The complete list of transformations supported and their usage in ImageKit can be found here. The SDK provides a function for each transformation parameter, making the code simpler and readable. If a transformation is supported in ImageKit, but a name for it cannot be found in the table below, then use the addCustomTransformation function and pass the transformation code from ImageKit docs as the first parameter and value as the second parameter. For example - .addCustomTransformation("w", "400")

Supported Transformation Function	Translates to parameter
height	h
width	w
aspectRatio	ar
quality	q
crop	c
cropMode	cm
focus	fo
format	f
radius	r
background	bg
border	bo
rotation	rt
blur	bl
named	n
overlayImage	oi
overlayX	ox
overlayY	oy
overlayFocus	ofo
overlayHeight	oh
overlayWidth	ow
overlayText	ot
overlayTextFontSize	ots
overlayTextFontFamily	otf
overlayTextColor	otc
overlayAlpha	oa
overlayTextTypography	ott
overlayBackground	obg
progressive	pr
lossless	lo
trim	t
metadata	md
colorProfile	cp
defaultImage	di
dpr	dpr
effectSharpen	e-sharpen
effectUSM	e-usm
effectContrast	e-contrast
effectGray	e-grayscale

File Upload

The SDK provides a simple interface using the ImageKit.shared.uploader().upload method to upload files to the ImageKit Media Library. It accepts all the parameters supported by the ImageKit Upload API.

Make sure that you have specified authenticationEndpoint during SDK initialization. The SDK makes an HTTP GET request to this endpoint and expects a JSON response with three fields i.e. signature, token and expire.

Learn how to implement authenticationEndpoint on your server.

Upload file from UIImage

let image: UIImage
ImageKit.shared.uploader().upload(
  file: image,
  fileName: "sample-image.jpg",
  useUniqueFilename: true,
  tags: ["demo"],
  folder: "/",
  isPrivateFile: false,
  customCoordinates: "",
  responseFields: "",
  signatureHeaders: ["x-test-header":"Test"],
  progress: { progress in
  	// Handle Progress
  },
  completion: { result in 
  	// Handle Upload Response
  }
)

Upload file from a remote URL

ImageKit.shared.uploader().upload(
  file: "https://www.example.com/sample-image.jpg",
  fileName: "sample-image.jpg",
  useUniqueFilename: true,
  tags: ["demo"],
  folder: "/",
  isPrivateFile: false,
  customCoordinates: "",
  responseFields: "",
  signatureHeaders: ["x-test-header":"Test"],
  progress: { progress in
  	// Handle Progress
  },
  completion: { result in 
  	// Handle Upload Response
  }
)

Upload file using Data

let data : Data
ImageKit.shared.uploader().upload(
  file: data,
  fileName: "sample-image.jpg",
  useUniqueFilename: true,
  tags: ["demo"],
  folder: "/",
  isPrivateFile: false,
  customCoordinates: "",
  responseFields: "",
  signatureHeaders: ["x-test-header":"Test"],
  progress: { progress in
  	// Handle Progress
  },
  completion: { result in 
  	// Handle Upload Response
  }
)

Support

For any feedback or to report any issues or general implementation support, please reach out to support@imagekit.io

License

Released under the MIT license.

nikniv/imagekit-ios