Adding Matatino to your project


This tutorial will guide you to add the Matatino framework to your project. We assume that you will be using Xcode 4 or greater. For the more advanced readers, adding Matatino is the same as other frameworks, but we don't use ARC (yet).



Step 1

To start off, we will have to create a new project. Just use a default Mac Cocoa application template.

Step 2

We have to add the Matatino framework to our project's directory. Find your project's directory, and create a Frameworks folder. Then copy Matatino.framework into that directory.




Step 3

Now we will add the Matatino framework into our Xcode project. Drag Matatino.framework from your folder into your Xcode project. Check the checkbox beside Destination just in case.

Also, make sure that you are adding it to the right target by checking the target's checkbox. This is already checked for you if you are starting from the template code. :)

You should see the Matatino.framework appear in "Linked Frameworks and Libraries" under your target's Summary tab.

Step 4

Now we have to make sure all the various "connections" are made. This takes a few steps, so bear with us.

In your target's "Build Phases", add Matatino.framework to the "Link Binary with Libraries" option if it is not already there.

Step 5

Press the "Add Build Phase" button in the bottom right corner and choose "Copy Files".

Step 6

Change the Copy Files destination to Frameworks and add in the Matatino.framework by dragging it from the left sidebar.

Step 7

Change to the Build Settings tab for your target and search for "search paths". Make sure that "All" is selected in the top left corner!

Step 8

Under "Linking" for "Runpath Search Paths", set the value to: @loader_path/../Frameworks

Step 9

Under "Search Paths" for "Always Search User Paths", set it to Yes

Step 10

Under "Search Paths" for "Framework Search Paths", set it to $(inherited) and "$(SRCROOT)/Frameworks". This may already be set for you.

Step 10

Under "Search Paths" for "Framework Search Paths", set it to $(inherited) and "$(SRCROOT)/Frameworks". This may already be set for you.

Step 11


Now that we have sufficiently linked everything together, compile and see if there are any errors.
If there are errors, check that you did each of the steps (especially the ones for linking everything together).

If you get errors like NSZone.h Semantic issue and NSObject.h Semantic issue...
- Search for arc in your target's Build Settings
- Under "Apple LLVM compiler 3.0 - Language" set "Objective-C Automatic Reference Counting" to No
Compile again, and hopefully there are no issues!




Download the Xcode project


Now that you are done this tutorial, check out the ones on using the Matatino framework for sending and receiving data!

Page was last modified: January 29 2012 22:03:58.