# iOS Setup

# iOS SDK: Setup

Add the required XCFrameworks to your project: `DigitalCardEngineSDK.xcframework` (API layer + UI microfrontends) and supporting modules such as `MeaCardData.xcframework`.

## Requirements

* iOS minimum deployment target: `iOS 17.0`

## Install DigitalCardEngineSDK

1. Download `DigitalCardEngineSDK.zip`.
2. Unzip the archive. You will find `DigitalCardEngineSDK.xcframework`.
3. Add `DigitalCardEngineSDK.xcframework` to **Frameworks, Libraries, and Embedded Content** for your app target and set it to **Embed & Sign**.

## Install MCD

### Adding Framework and Configuration to Xcode Project

1. Download `mcd-<environment>-<version>.zip`.

Use provided Nexus Repository credentials to sign in:

```
Test: https://nexus.ext.meawallet.com/repository/mcd-ios-group/ios/mcd-test/<version>/mcd-test-<version>.zip
Prod: https://nexus.ext.meawallet.com/repository/mcd-ios-group/ios/mcd-prod/<version>/mcd-prod-<version>.zip
```

2. Unzip the archive to obtain `MeaCardData.xcframework`.
3. Add `MeaCardData.xcframework` to **Frameworks, Libraries, and Embedded Content** for your app target. Set it to **Embed & Sign**.
4. Download `mea_config.<issuer>.zip`.
5. Unzip the archive to extract the `mea_config` file.
6. Add `mea_config` to your app’s Resources folder and ensure it is included in the target’s bundle resources. The framework automatically loads this configuration at runtime and throws an exception if the file is missing, corrupted, or unreadable.