> For the complete documentation index, see [llms.txt](https://docs.antsomi.com/developers-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.antsomi.com/developers-guide/ios/getting-started.md).

# Getting Started

### 1. Install the SDK

#### Cocoapods

The easiest way to use Antsomi in your iOS project is with [CocoaPods](https://cocoapods.org/pods/WebEngage). Before you begin, please ensure that you are using [Ruby v2.0.0](https://www.ruby-lang.org/en/installation/) or higher (knowledge of Ruby syntax isn’t needed to install the SDK).

**Step 1: Download CocoaPods**

CocoaPods is a dependency manager for Swift and Objective-C projects. You can install CocoaPods by running the following command.

{% tabs %}
{% tab title="Shell" %}

```sh
$ sudo gem install cocoapods
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Please refer to the [CocoaPods Troubleshooting Guide](http://guides.cocoapods.org/using/troubleshooting.html) in case you have trouble using CocoaPods.
{% endhint %}

**Step 2: Add a** `Podfile`

In the terminal, navigate to your Xcode project directory and create a `Podfile` by running the following command.

{% tabs %}
{% tab title="Shell" %}

```sh
$ pod init
```

{% endtab %}
{% endtabs %}

**Step 3: Edit your** `Podfile`

Add the following in your `Podfile` under your project's target.

{% tabs %}
{% tab title="Ruby" %}

```ruby
# Avoid use_frameworks! declaration in your Podfile.

target 'YourAppTarget' do
  pod 'AntsomiFramework', '1.1.59'
end
```

{% endtab %}
{% endtabs %}

**Step 4: Install AntsomiFramework SDK**

To install the Antsomi SDK, navigate to your Xcode project directory and run the following command.

{% tabs %}
{% tab title="Shell" %}

```sh
$ pod install
```

{% endtab %}
{% endtabs %}

**Step 5:** Stop using your project file, `YOUR-PROJECT-NAME.xcodeproj`. And start using the project workspace file created by CocoaPods, `YOUR-PROJECT-NAME.xcworkspace` from now on.

* Doing so will ensure that the AntsomiFramework SDK is properly loaded.

### 2. Initialize the SDK

**Step 1:** Add `Antsomi.Configuration` to the `application:didFinishLaunchingWithOptions:` of your `AppDelegate`.

* We recommend that you make this call at the end of `didFinishLaunchingWithOptions:`.

**Step 2:** Add `registerForNotification` to the `application:didRegisterForRemoteNotificationsWithDeviceToken:` of your `AppDelegate`.

{% tabs %}
{% tab title="Swift" %}

```swift
import AntsomiFramework

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
                
        /**
          YOUR CODE GOES HERE
        **/
                
        let config = Antsomi.Configuration(portalId: "XXXXXXXXX", propsId: "YYYYYYYYY", appGroupId: "group.antsomi.news",applicationId: "b25d06f4-d322-46d5-b323-ZZZZZZZZZZZZ")        
        Antsomi.shared.activate(with: config)
        
        Antsomi.shared.trackAppLaunch()
        
        return true
  }

  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {        
        Antsomi.shared.registerForNotification(deviceToken)
  }
```

{% endtab %}

{% tab title="Objective-C" %}

```objectivec
#import <AntsomiFramework/AntsomiFramework-Swift.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
  /**
    YOUR CODE GOES HERE
  **/
  
  return YES;
}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    Antsomi const *antsomi = [Antsomi shared];
    
    [antsomi registerForNotification: deviceToken];
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
If you haven't had your CDP365 Application ID, please follow this [instruction](https://docs.antsomi.com/cdp-365-user-guide-en/marketing-hub/destinations/all-destinations/app-notification#1.-antsomi-app-notification).
{% endhint %}

***

You have successfully integrated the Antsomi SDK with your iOS app and are sending user session and system events data to your Antsomi account. Please note that it may take a up to few minutes for your data to reflect on your dashboard.