> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.