The Ada iOS SDK is a small framework that you can use to embed your Ada chatbot into your native iOS application.
It also supports actions and settings that you can use to customize the behavior of your bot. For example, you might want to set the bot language, or customize the greeting. The iOS SDK reference covers these options and more.
Compatibility
Ada’s iOS SDK supports applications targeting iOS 15.0 and above, ensuring compatibility with the latest iOS features and security updates.
For developers needing to support older versions, the SDK can target down to iOS 12.0. However, please note that the Ada development team does not conduct testing on versions below iOS 15.0. While functionality on these older versions is available, it is not guaranteed to be fully optimized or free of issues.
Ada will add support for new iOS versions as they become generally available, and will continue to support and test for two versions behind the current version.
Install the iOS SDK
You can install the the Ada iOS SDK manually or using CocoaPods.
Install iOS SDK manually
- Download the
AdaEmbedFramework.xcframework.zip
file from the latest release here. (For releases earlier than 1.8.0, the file isAdaEmbedFramework.framework.zip
.) - Right-click on the project file in XCode, then click Add Files to MyProjectName. Ensure that the Copy groups option is selected.
- Ensure your Deployment Target is set to 15.0, which is the minimum iOS version that the Ada iOS SDK is compatible with, or higher.
- In the project settings under General, link
AdaEmbedFramework.xcframework
( orAdaEmbedFramework.framework
for releases before 1.8.0) under the Embedded Binaries section. (Drag the framework from the left side list in the Embedded Binaries list.)
Install iOS SDK using CocoaPods
The AdaEmbedFramework CocoaPod is public, however, use of the chat interface is gated. To gain access please reach out to an Ada Account Manager.
Before you begin, get the latest version at https://cocoapods.org/pods/AdaEmbedFramework
-
Add the
AdaEmbedFramework
to your Podfile. -
Install the pod using:
pod install
.
# Podfile
platform :ios, '10.0'
target 'MyApp' do
use_frameworks!
# Pods for MyApp
pod "AdaEmbedFramework", "~>1.8.0"
end
Import the framework
Once you've installed the Ada iOS SDK, you're ready to use it in your app!
- Import
AdaEmbedFramework
into your controller. - Create an instance of the
AdaWebHost
, as in the example below, replacingmy-bot
with the actual name of your bot.
import AdaEmbedFramework
# ...
lazy var adaFramework = AdaWebHost(handle: "my-bot")
The lazy property prevents AdaWebHost from initializing until the property is used. Use of this property may help to prevent unwanted chatters from being created in the background.
Launch Ada
Finally, launch Ada using one of the three opening methods: