Skip to main content

Installation

It is recommended to use Xcode to develop and build the project.

Requirements

  • Device must be able to connect to the Internet.
  • iOS version must be 11.0 or above.

Xcode

It is recommended to use Xcode to develop and build the project.

Adding Framework and Configuration to Xcode Project

info

Nexus Repository credentials have changed when upgrading from Legacy version. Contact MeaWallet for new credentials.

  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. Archive contains iOS XCFramework - MeaCardData.xcframework.

  3. Add MeaCardData.xcframework to Frameworks, Libraries and Embedded Content section of General settings in iOS project target. Set Embed & Sign.

  4. Download mea_config.<issuer>.zip.

  5. Unzip the archive. Archive contains configuration file mea_config.

  6. Add mea_config to iOS App Resources folder and App Target. File must be included in the final app bundle. Framework automatically loads configuration from app bundle during runtime. Framework raises an exception if configuration file is missing, broken or otherwise fails to load.

Framework (Legacy version 1.1.0 and older)

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

  2. Unzip the archive. Archive contains iOS XCFramework - MeaCardData.xcframework.

  3. Add MeaCardData.xcframework to Frameworks, Libraries and Embedded Content section of General settings in iOS project target. Set Embed & Sign.

M1 Support

MCD SDK is supported on Apple M1 and latest Xcode version. In Xcode project Build Settings for iOS Simulator target add arm64 to Excluded Architectures to avoid the following error:

McdTestApp-iphonesimulator/MeaCardData.framework/MeaCardData,
missing required architecture arm64 in file /Library/Developer/Xcode/DerivedData/McdTestApp/Build/Products/McdTestApp-iphonesimulator/MeaCardData.framework/MeaCardData (2 slices)
Undefined symbols for architecture arm64
...
ld: symbol(s) not found for architecture arm64

Xcode Excluded arm64