# Installation

## Adding the MOVE SDK

### Using Cocoapods

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. Check out their [homepage](https://cocoapods.org/) for more details.

If your project already uses CocoaPods, then add the dependency to your ***Podfile***:

```bash
pod 'DolphinMoveSDK'
```

Run the following command from the terminal:

```bash
$ pod install
```

*See also* [*Troubleshooting*](https://docs.movesdk.com/move-platform/troubleshooting/ios#cocoapods)*.*

### Health Kit Extension

{% hint style="warning" %}
Vesrion 2.15 and above:

In order to allow the [Steps](https://docs.movesdk.com/move-platform/move-services#health) service to collect HealthKit data an additional framework is needed.

Make sure to use the *DolphinMoveSDKHealth* framework with the same version number.
{% endhint %}

```bash
pod 'DolphinMoveSDKHealth'
```

### Swift Package Manager

Add the package with the URL:

```
https://github.com/dolphin-technologies/MOVE-iOS-Packages
```

Add the frameworks to the project:

* Go to the **General** tab of your target settings
* Click the **+** button under the **Frameworks, Libraries, and Embedded Content** heading
* Click **Add Other** and then **Add Package Dependency**

<figure><img src="https://394612935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmwu27YShuN4k8SNwEG4H%2Fuploads%2FuWtys1HUCprL3vIxoOKH%2FScreenshot%202024-01-16%20at%2016.18.27.png?alt=media&#x26;token=2a561b95-505e-41ae-8774-c5606c7826d5" alt=""><figcaption><p><strong>DolphinMoveSDK</strong> added to <strong>Libraries</strong>.</p></figcaption></figure>

{% hint style="warning" %}
Version 2.15 and above:

If you are using the steps feature with health kit synchronization, in order to sync data with your AppleWatch or other devices, you also need to embed *DolphinMoveSDKHealth.* This will use HealthKit, which must be supported by your app's provisioning and requires user permissions, see [Permission Handling](https://docs.movesdk.com/move-platform/sdk/appendix/ios/permission-handling).
{% endhint %}

### Manual Installation&#x20;

{% hint style="info" %}
If you need to install the Framework manually you will have to extract the download link for the zip from the latest [Swift Package](https://github.com/dolphin-technologies/MOVE-iOS-Packages/blob/master/Package.swift). If you want to use a specific version refer to the [tags](https://github.com/dolphin-technologies/MOVE-iOS-Packages/tags) in the repository.
{% endhint %}

1. Download and extract the latest Move SDK XCFramework&#x20;
2. Add the frameworks to the project ()
   * Go to the **General** tab of your target settings
   * Click the **+** button under the **Frameworks, Libraries, and Embedded Content** heading
   * Click **Add Other** and then **Add Files**
   * Choose the **Move XCFramework** file and click **Open**
3. Change the **Embed** option next to the framework to **Do Not Embed**

### Important Notes

{% hint style="warning" %}
*For versions bellow 2.3:*

When exporting your application archive make sure the ***manageAppVersionAndBuildNumber*** option is set to false, otherwise the version numbers of all frameworks (including MoveSDK) included in your application will be overwritten. This can cause issues with migration code since the correct version number is lost.

When building with ***Fastlane*** this is done by adding export options to your ***gym*** export command, see following code snippet:
{% endhint %}

```ruby
gym(
	...
	export_options: {
		manageAppVersionAndBuildNumber: false,
		...
	}
	...
)
```


---

# 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.movesdk.com/move-platform/sdk/getting-started/ios/installation.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.