XCode 4 adding dylib

Question

I am trying to create and then add the dylib to a project. I created it by using the "Cocoa-Library" template and setting the type to "Dynamic" (not sure if it should be dynamic or static...). Then I created a simple obj-c class called Test and wrote a method in it that prints out something to console.

I compiled and used the generated .dylib file and put it in another project. Now whenever I try to use it, I get this message on runtime"

dyld: Library not loaded: /usr/local/lib/TESTLib.dylib
  Referenced from: /Users/***/Library/Developer/Xcode/DerivedData/TestingDYLIB-axmoocnxbwznoyerfogosumqufxc/Build/Products/Debug/TestingDYLIB.app/Contents/MacOS/TestingDYLIB
  Reason: image not found

I also created a Copy File phase and set the destination to "Frameworks". I still get the same error. What am I doing wrong? Thanks.

Answer 1

The issue is not where Xcode is looking for the library at compile time, which is what Simon Whitaker's answer addresses.

The issue is that the application which uses the dylib cannot find it at runtime. When an application is built that uses a dynamic library, it copies the install_name of the dylib into the output binary.

Creating a copy files phase and copying the dylib to the Frameworks subdirectory of the app's bundle is the right thing do do.

However, you need to do an additional step. You need to compile the dynamic library with an install_name appropriate for a bundle app. By default, a dynamic library is created with an install_name of /usr/local/lib. The app can't find your library there because it doesn't exist. Even if you put the library there, your users certainly won't have it, so that would be the wrong solution.

The right solution is bundling the library with the app. To set the install name for the dynamic library, go into the dynamic library project and set the "Dynamic Library Install Name" option to: @executable_path/../Frameworks/libmydynamiclibrary.dylib

Answer 2

Xcode is looking in /usr/local/lib/ for the library. If the library is in another location, add that location to your Library Search Paths:

1. Select project file in Xcode 4
2. Select the target, then click the Build Settings tab
3. Make sure All is selected in the filter bar (not Basic)
4. Scroll down to the Search Paths section and you'll find Library Search Paths in there