Quick Start¶
1. Create an AppFriends Application¶
Before start using AppFriends, you need to create an application on the dashboard Users in the same application can talk to each other and you only need one application for all the platforms you want to support. To see an sample app of how to use AppFriendsUI, please checkout our repo:
2. Integrate AppFriends SDK¶
Using Cocoapods¶
To integrate AppFriends iOS SDK to your Xcode iOS project, add this line in your Podfile
Swift 4¶
pod 'AppFriendsUI', '~> 2.3' pod 'AppFriendsCore', '~> 2.2'
Swift 3.2¶
pod 'AppFriendsUI', '~> 2.2' pod 'AppFriendsCore', '~> 2.1'
Also, add use_frameworks!
to the top of file. eg.
source 'https://github.com/CocoaPods/Specs.git' source 'https://github.com/Hacknocraft/hacknocraft-cocoapods-spec.git' use_frameworks! ...
You might need to run pod repo update
after this step before calling pod install
Using Carthage¶
To integrate using Carthage
github "Hacknocraft/AppFriendsCarthage" ~> 2.1
Add frameworks:¶
Copy frameworks:¶
If you don't want any of the UI components we provide, you can directly interact with the platform API, and we have a core framework to use for that purpose:
pod 'AppFriendsCore', '~> 2.2'
3. Import Header¶
The next step is import the headers.
Example¶
Swift¶
#import AppFriendsCore #import AppFriendsUI
Objective-C¶
import AppFriendsCore import AppFriendsUI
4. Initialization¶
Now, we can use the AppFriends key and secret to initialize the SDK. Key and secret can be found in your AppFriends dashboard. If you are using the AppFriendsUI
SDK, you can initialize by:
AppFriends Initialization¶
Swift¶
AppFriendsUI.sharedInstance.initialize("[appfriends key]", secret: "[appfriends secret]") { (success, error) in if !success { NSLog("AppFriends initialization error:\(error?.localizedDescription)") }else { // initialization is successful } }
5. Login¶
After initialization, you want to login your user to AppFriends, so he can start chatting with other users. Please see sessions for detail
6. UI¶
There are a lot of ready to use UI components in the AppFriendsUI SDK. They can save you hundreds of hours of development. To learn the UI components and how to use them, please see ui components section