> For the complete documentation index, see [llms.txt](https://docs.truecaller.com/truecaller-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truecaller.com/truecaller-sdk/ios/integrating-with-your-ios-app/setup.md).

# Setup

**Manual Installation**

1. Download the project zip file from the [release section](https://github.com/truecaller/ios-sdk/releases)
2. Unzip the file
3. Copy the TruecallerSDK project files into your project ( TrueSDK directory, TrueSDKTests directory and TrueSDK.xcodeproj )
4. Drag and drop TrueSDK.xcodeproj into your project ( i.e. add it as a subproject to your main project ). Embedding it this way will not require any additional script to be run.
5. Add the TruecallerSDK framework ( from Products output of TrueSDK.xcodeproj ) into the Embedded Binaries section of the General tab of your target.

{% hint style="info" %}
NOTE: We recommend using the Swift Package Manager.
{% endhint %}

**Installation with Swift Package Manager (Recommended)**

1. Integrate your Swift package with Xcode by selecting “File” from the Xcode menu, then select “Add Packages” or use the keyboard shortcut Shift+Command+K
2. Search for truecaller SDK, use URL - <https://github.com/truecaller/ios-sdk>\
   ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdtCk41RzO03e8IbTVwRyKS0mcJ0b_TMqCy3L1AQ_oGL0UKmNJWmhiqoidkdZDJNq7y7bLh9lWeROLnDFv2T0tdFXH7mx5m2AJnf8RYyOvtauC8ZvyyJNEyOjXjDpmVdfx2FhBN?key=vfNZ1xX2WgXJ-j5TIVfkkb9i)
3. Choose the package and select the latest version&#x20;
4. Click "Add Package" to confirm&#x20;
5. Select the target\
   ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfhngv6HJBKhVx1NVMv1e8mwVT2S4jsITE_z0SgLbaqBbMf_Bd2EYJ1iX-2E7NmTjrP0rw8b1uZAeOKCm239ReajI2ughM373LTUjNxXpAD2WAYrie2BR3w6qGBHVa4snjDyxe5dA?key=vfNZ1xX2WgXJ-j5TIVfkkb9i)
6. Click "Add Package" to confirm.&#x20;
7. Use the package in your Xcode project by importing it into your swift files. &#x20;

**Installation with CocoaPods**

[CocoaPods](http://cocoapods.org/) is a dependency manager which automates and simplifies the process of using 3rd party libraries.

You can install it with the following command:

```
$ gem install cocoapods
```

You can create your Podfile using the command ( in case you do not already have it ):

```
$ pod init
```

To integrate TruecallerSDK into your Xcode project using CocoaPods, specify it in your `Podfile` :

```
platform :ios, '8.0'
use_frameworks!

target 'TargetName' do
pod 'TrueSDK'
end
```

Then, run the following command:

```
$ pod install
```