# How to Set Up the MTSCRA SDK

#### Setup for XCode Project

To add the MTSCRA SDK libraries to a custom software project in the XCode development environment, follow these steps:

* Download the MTSCRA Demo app from MagTek.com.
* Open your custom software project in XCode.
* Open the MTSCRA Demo app folder in Finder.
* Open the Lib subfolder.
* Include the following files in your custom software project within XCode:
  * ibMTSCRA.a
  * MTSCRA.h
* Ensure the library search paths are set up correctly.
* If you are writing an app that will connect to Bluetooth LE devices, see the additional steps section 3 Important Information About Bluetooth LE.
* Clean, build, and run your custom software project to make sure the library imported correctly.
* In your custom software, create an instance of MTSCRA. For examples, including how to register delegate functions in your app for callbacks, see the source code included with the MTSCRA Demo app and / or Appendix C Code Examples .
* Begin using the features provided by the MTSCRA object’s methods. For details about these methods, see section 4 MTSCRA Functions.

#### Setup for Swift Project

* Add the following files to project, and setup the bridge header folder in build settings.
  * MTSCRA.H
  * MTSCRA-Bridge.h

<figure><img src="/files/ua0ldgEqj9rq2VHaBQd4" alt=""><figcaption></figcaption></figure>

* Add libMTSCRA.a, in build phases->Link Binary with libraries, click ‘+’, then select Add Files and browse to libMTSCRA.a

<figure><img src="/files/Mm4LqBEBe87SJaHv93za" alt=""><figcaption></figcaption></figure>

* Add libc++.tbd in build phases->Link Binary with libraries, click ‘+’, then type “c++” in the filter area and pick libc++.tbd.

<figure><img src="/files/nJOOBHZ3pT6lFt4MvKud" alt=""><figcaption></figcaption></figure>

* After adding those two libraries, this will be in the project.

<figure><img src="/files/IWnzjPpYD20iBXN1mWAl" alt=""><figcaption></figcaption></figure>

* Add the external accessory protocols into info file. In the screen shot, it adds iDynamo5 and iDynamo6 with default protocols. Add your custom protocol if different.

<figure><img src="/files/Gb5T8YFiVJ8UWFRZ4zmK" alt=""><figcaption></figcaption></figure>


---

# 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://developer.magtek.com/hardware/card-readers/magnetic-stripe-readers/idynamo-5-gen-iii/documentation/developers-manuals/programmers-manual-ios/how-to-set-up-the-mtscra-sdk.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.