Install iOS SDK
The Amity Social Cloud SDK for iOS is delivered as a binary .xcframework file

Manual Installation

  • Drag AmitySDK.xcframework and Realm.xcframework to your project.
  • Make sure that Copy items if needed is selected and click Finish.
  • Also switch the Embed section as Embed & Sign
The correct setup should look like this.
You need to turn Rosetta mode on when using AmitySDK with arm64 simulator. To force the application to use Apple Rosetta environment with an Apple silicon Mac, refer to this page for the instructions.

Using Dependency Manager

AmitySDK supports installation via dependency managers.
  • SwiftPM
  • Cocoapods
  • Carthage

SwiftPM Installation

To integrate AmitySDK into your project via SwiftPM, please follow the instruction below.
Enter the repository URL to search the package, and choose to install AmitySDK.
https://github.com/AmityCo/Amity-Social-Cloud-SDK-iOS-SwiftPM
If you selected "Up to Next Major Version" option for the Dependency Rule, you need to manually add the version.

Carthage Installation

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate the Amity Social Cloud SDK, add the following line of code to your Cartfile.
binary "https://raw.githubusercontent.com/AmityCo/Amity-Social-Cloud-SDK-iOS/master/AmitySDK.json" ~> 5.3.0

Cocoapods Installation:

To integrate the Amity Social Cloud SDK into your Xcode project using CocoaPods, specify the following lines of code in your Podfile:
platform :ios, '12.0'
use_frameworks!
pod 'AmitySDK'
This installs the latest version of SDK. To get more info about our latest release, please look into changelog section. We support cocoapod installation of our sdk above version 5.1.0. The minimum deployment target platform for iOS is 12.0. If there are any issues during installation steps, clean cocoapods cache and try again. To clear cache please go to ~/Library/Caches/Cocoapods and remove `AmitySDK` related folders/files.
If this doesn't work, please do visit the Cocoapods Github repo for further resolutions.
AmitySDK already includes our UIKit. Don’t install the UIKit separately if you have already installed the SDK.

Additional Steps for Amity Video

Amity Video requires the AmitySDK as dependencies. First, ensure you have installed the AmitySDK as per the instructions above.
To use live video broadcast:
  • Import AmityLiveVideoBroadcastKit.xcframework to your project.
To use live video player:
Switch each framework to Embed & Sign, except MobileVLCKit to Do Not Embed.
For the project that uses both live video broadcast and live video player, the correct setup should look like this.
To install Swift Packages for Amity Video, please follow the instructions below.

1. Install AmityVideoBroadcast

To use live video broadcast functionalities. Enter the repository URL to search the package, and choose to install AmityVideoBroadcast.
https://github.com/AmityCo/Amity-Social-Cloud-SDK-iOS-VideoBroadcast-SwiftPM
Try it in your code
import AmityLiveVideoBroadcastKit

2. Install AmityVideoPlayer

To use live video player functionalities. Enter the repository URL to search the package, and choose to install AmityVideoPlayer.
https://github.com/AmityCo/Amity-Social-Cloud-SDK-iOS-VideoPlayer-SwiftPM
Try it in your code
import AmityVideoPlayerKit
If you selected "Up to Next Major Version" option for the Dependency Rule, you need to manually add the version.
Export as PDF
Copy link
Outline
Manual Installation
Using Dependency Manager
SwiftPM Installation
Carthage Installation
Cocoapods Installation:
Additional Steps for Amity Video
1. Install AmityVideoBroadcast
2. Install AmityVideoPlayer