The following documentation is built to help you with installing our iOS SDK into your project.

We provide 2 iOS SDKs:

• One is our core (Applozic SDK) SDK which is written in Objective-C. In this SDK, we provide pre-built UI as well as the APIs required to build your own UI from scratch.
• Another is a complete UI kit(ApplozicSwift SDK) written in Swift and it's built on top of Applozic SDK. This SDK cannot be used to build your own UI from scratch.

Let's see the difference between both these SDKs.

Check ApplozicSwift section to use Swift SDK and Applozic section to use Objective-C SDK.

Applozic SDK

Before we begin, please do make sure that

• Your application is built on iOS 10.0 or above. Since Applozic SDK as of now only supports Version 10.0 or higher
• You have Xcode 12.0 or later as your IDE to install and run Applozic SDK on iOS.

The Applozic SDK can be installed using the following method

Automated Installation using CocoaPods

In case you are already using Cocoapods, Jump to point 4 of the installation process mentioned below.

For the rest of us, please follow the instructions below

1. Open Terminal
2. Navigate to the root directory of your Project
3. Run command

pod init

4. Again go to your Project's root directory, click on the "Podfile" to open.

Copy-paste the following code anywhere in the file and Save

target 'MyTargetName' do
    use_frameworks!
    pod 'Applozic', "~> 8.1.0"
end

5. Once done, Run pod install or pod update to refresh the CocoaPods dependencies.
6. Your installation is now complete.

As a reference, you can download our sample project here ---> ApplozicCocoaPodDemo

This has the pod already installed, feel free to compare it with your project to confirm the same.

Add Framework Manually

📘

This step is needed only when you are not using CocoaPods

Download the latest Applozic Chat framework here and add it to your project.

Note: If you're testing out you can add the Debug xcframework from the above link
If your uploading to the app store something you should go with Release xcframework

Add XCFramework to your project:

i) Paste the Applozic.xcframework and ApplozicCore.xcframework to the root folder of your project and add an Applozic.xcframework and ApplozicCore.xcframework file in your project

ii) Go to General.

Frameworks, libraries, and embedded content and add the Applozic.xcframework and ApplozicCore.xcframework.

Note: Make sure the Applozic.xcframework and ApplozicCore.xcframework has embed and sign.

iii) Make sure Always Embed Swift Standard Libraries is YES in the build settings of your project.

Add Permissions

App Store requires any app which accesses camera, contacts, gallery, location, a microphone to add the description of why does your app need to access these features.

In the Info.plist file of your project. Please add the following permissions

<key>NSCameraUsageDescription</key>
<string>Allow Camera</string>
<key>NSContactsUsageDescription</key>
<string>Allow Contacts</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Allow location sharing!!</string>
<key>NSMicrophoneUsageDescription</key>
<string>Allow MicroPhone</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Allow Photos</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>Allow write access</string>

📘

This being a mandate from Apple, please do make sure that the following permissions are added to the info.plist file of your project.

Framework generating

These below steps will guild you to generate a xcframework manually for Applozic-iOS-SDK.

You can check out this link

Applozic Swift UIKit

Before we begin, please do make sure that

• Your application is built on iOS 10.0 or above. Since ApplozicSwift SDK as of now only supports Version 10.0 or higher
• You have Xcode 12.0+ or later as your IDE to install and run ApplozicSwift SDK on iOS.
• For Swift versions :: < 4.0 - Use SDK version below 1.1.0 and For Swift version >= 4.0 - Use framework version starting from 1.1.0

Installation using CocoaPods

1. Open Terminal
2. Navigate to the root directory of your Project
3. Run command

pod init

4. Again go to your Project's root directory, click on the "Podfile" to open.

Copy-paste the following code anywhere in the file and Save

target 'MyTargetName' do
    use_frameworks!
    pod 'ApplozicSwift'
end

5. Once done, Run pod install or pod update to refresh the CocoaPods dependencies.
6. Add these permissions in the Info.plist file.
7. Your installation is now complete.