**Step 2: Add iOS SDK GitHub repository**
Enter the AppsFlyer SDK GitHub repository:
`https://github.com/AppsFlyerSDK/AppsFlyerURLResolver.git`

**Step 3: Select SDK version**

**Step 4: Add AppsFlyerURLResolver to desired Target**

#### Cocoapods
**Step 1: Download CocoaPods**
[Download and install](https://guides.cocoapods.org/using/getting-started.html#installation) the latest version of CocoaPods.

**Step 2: Add dependencies**
Add the [latest version of `AppsFlyerURLResolver`](https://github.com/AppsFlyerSDK/AppsFlyerURLResolver/releases/latest) to your project's Podfile:

```
pod 'AppsFlyerURLResolver'
```

**Step 3: Install dependencies**
In your terminal, navigate to your project's root folder and run `pod install`.

**Step 4: Open Xcode workspace**
In Xcode, use the `.xcworkspace` file to open the project from this point forward, instead of the `.xcodeproj` file.

#### Carthage
**Step 1: Install Carthage**
[Install](https://github.com/Carthage/Carthage#installing-carthage) the latest version of Carthage.

### `resolve`
**Method signature**
```kotlin
fun resolve(url: String?,maxRedirections: Int = 10, urlResolverListener: URLResolverListener)
```
**Description**
Resolve a given URL.
This function will perform redirects until it gets to the final URL or up to the maximum redirects. The function will return the last URL address.
* `null` URL will return `null`.
* An invalid URL will return the original input (passed in the `url` parameter).

**Input arguments**
|Type|Name|Description|
|--|--|--|
|String?|url|The URL to resolve|
|Int|maxRedirections|The maximum redirections to relove. The default value is 10 Redirections|
|URLResolverListener|urlResolverListener|The listener for the output of the URL resolving

**Example**
```kotlin
override fun onDeepLinking(deepLinkResult: DeepLinkResult) {
if (deepLinkResult.status == DeepLinkResult.Status.FOUND) {
URLResolver().resolve(deepLinkResult.deepLink?.deepLinkValue, 5, object : URLResolverListener {
override fun onComplete(url: String?) {
Log.d(TAG, "final URL: $url")
}
})
}
}
```
### `resolveJSRedirection`
**Method signature**
```kotlin
fun fun resolveJSRedirection(url: String?, urlResolverListener: URLResolverListener)
```
**Description**

Use this API if you want to perform redirection based on JS (Hubspot). This api extracts the link from the JS code and returns it to the `urlResolverListener` callback for forther redirections.
* `null` URL will return `null`.
* An invalid URL will return the original input (passed in the `url` parameter).

**Input arguments**
|Type|Name|Description|
|--|--|--|
|String?|url|The URL to resolve|
|URLResolverListener|urlResolverListener|The listener for the output of the URL resolving

**Example**
```kotlin
URLResolver(true).resolveJSRedirection("my-url"){
Log.d(TAG, "The URL is: $it")
}
```

**Input arguments**
|Type|Name|Description|
|--|--|--|
|String?|url|The URL to resolve|
|Int|maxRedirections|The maximum redirections to relove. The default value is 10 Redirections|
|@escaping (String?) -> Void|completionHandler|Completion handler that will return the result as a optional string|

**Example**
```swift
// add this import
import AppsFlyerURLResolver

func didResolveDeepLink(_ result: DeepLinkResult) {
if result.status == .found{
URLResolver().resolve(url: result.deepLink?.deeplinkValue, maxRedirections: 9){ res in
print("The URL is: \(res ?? "nil")")
}
}
}
```

### `resolveJSRedirection`
**Method signature**
```swift
resolveJSRedirection(url: String?, completionHandler : @escaping (String?) -> Void)
```
**Description**

Use this api if you want to perform redirection based on JS. This api extracts the link from the JS code and returns it to the `completion handler` for forther redirections.
* `nil` URL will return `nil`.
* Not a vailid URL will return the input to the function (`url` parameter).

**Input arguments**
|Type|Name|Description|
|--|--|--|
|String?|url|The URL to resolve|
|@escaping (String?) -> Void|completionHandler|Completion handler that will return the result as a optional string|

### Android
```Kotlin
URLResolver(true)
```

### iOS
```swift
URLResolver(isDebug: true)
```

🛠 In order for us to provide optimal support, we would kindly ask you to submit any issues to support@appsflyer.com