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

# 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*](/move-platform/sdk/troubleshooting/ios.md#cocoapods)*.*

### Health Kit Extension

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

In order to allow the [Steps](/move-platform/move-services.md#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="/files/DFNmHZ0fPw7ZbNH1tFFG" 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](/move-platform/sdk/appendix/ios/permission-handling.md).
{% 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,
		...
	}
	...
)
```