# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.truecaller.com/truecaller-sdk/ios/integrating-with-your-ios-app/setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.