Installing UIKit (deprecated)

Installing managed UIKit through Cocoapods, Carthage & SPM.

This section is about installing managed UIKit through the dependency manager. If you have already installed our Open Source UIKit, you can skip this section.

To provide greater customization options, we have open-sourced our UIKit and deprecated the packaged UIKit version previously available. For the best quality and access to the latest features, we strongly recommend integrating our UIKit with the open-source version. For more details, please refer to the iOS UIKit Installation Guide section.

Create a project

Go to Xcode and create a project for iOS.

1. Enter a project name

2. Select Swift as your language option

Using Dependency Manager

Social Plus UIKit supports installation via dependency managers, we highly recommend SwiftPM installation as the best practice.

• SwiftPM

• Cocoapods

• Carthage

SwiftPM Installation

To integrate Social Plus UIKit into your project via SwiftPM, please follow the instructions below.

• Add a Package Dependency

Enter the repository URL to search the package, and choose to install Social Plus UIKit.

https://github.com/AmityCo/Amity-Social-Cloud-UIKit-iOS-SwiftPM

Carthage Installation

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate the Social Plus UIKit. First, add the following to your Cartfile.

binary "https://raw.githubusercontent.com/AmityCo/Amity-Social-Cloud-UIKit-iOS/main/AmityUIKit.json" ~> 2.0

Now you can install Social Plus UIKit into your project by running the following command.

$ carthage update

Cocoapods Installation

If you are using CocoaPods to integrate Social Plus UIKit into your Xcode project. First, open a terminal and run this command to create Podfile.

$ pod init

Then, add the following lines to the Podfile

source "https://github.com/AmityCo/Amity-Social-Cloud-UIKit-iOS.git"
target 'SampleApp' do
  use_frameworks!
  pod 'AmityUIKit'
end

Now you can install Social Plus UIKit into your project.

$ pod install

If problems happen during pod install step. Please try cleaning Cocoapods cache before running pod install again.

To clear the cache please go to ~/Library/Caches/Cocoapods and remove all folders.

If this doesn't work, please visit the Cocoapods Github repo for further resolutions.

Usage

After finished installing SDK. You will be able to import AmityUIKit.

import AmityUIKit

Social Plus UIKit already includes our SDK. Don’t install Social Plus SDK separately if you have already installed the UIKit.

From the version 3.x. please install the UIKit with the open source guideline here iOS UIKit Installation Guide.