99

I'm creating an iOS framework with Xcode6 and iOS8. When I link this with an iOS app and try running it on the device I get this error

dyld: Library not loaded: @rpath/FrameworkName.framework/FrameworkName
  Referenced from: /private/var/mobile/Containers/Bundle/Application/0F2C2461-A68B-4ABA-A604-B88E6E9D1BB1/AppName.app/AppName
  Reason: image not found

The 'Runpath Search Paths' build setting for the framework is set by default to

'@executable_path/Frameworks', '@loader_path/Frameworks'

I could not find any documentation related to this. This was something new introduced with Xcode6 and I would expect it to just work by simply including the framework into any app that needs it.

4
  • You should be creating the framework as a target in the project to start with. Then it will "just work".
    – matt
    Jan 30, 2015 at 21:00
  • 1
    @Matt, for our use we need to keep it as another project within the same workspace. Any tips on what to do in this scenario ?
    – ArdenDev
    Jan 30, 2015 at 21:53
  • What I would do is this: make a new project and in that project make a new framework target. That builds and runs, so now I know what all the settings need to be for both the app target and the framework target. Now compare. :)
    – matt
    Jan 30, 2015 at 22:46
  • **Please check this answer. ** stackoverflow.com/a/67886532/13439617 Jun 8, 2021 at 12:04

13 Answers 13

80

To make this work

  1. In the framework project settings change the install directory from '/Library/Frameworks' to '@executable_path/../Frameworks'

  2. In the project that includes this framework, add a copy files phase and copy this framework to the 'Frameworks' folder. Once you do this ensure that this framework is listed under the 'Embedded Binaries' section.

7
  • 3
    Thank you for reporting back. I believe this will be of value to others...!
    – matt
    Feb 9, 2015 at 1:53
  • 5
    Thnx, step 2 was enough for me.
    – M.Othman
    Apr 7, 2016 at 13:21
  • I had not looked under General -> Embedded Binaries. Adding it there fixed my issue too. Aug 30, 2016 at 23:54
  • Also check "Build Settings"->"Linking"->“Dynamic Library Install Name Base” is set to @rpath.
    – Gavin
    Jul 27, 2017 at 9:26
  • @AdamMendoza I've done same as you mentioned in my framework but i think my problem is different, so can you answer this post if you've idea: stackoverflow.com/questions/50384137/…
    – Aleem
    May 17, 2018 at 7:21
45

Issue resolved using this answer. According to @vladof81:

In the target's General tab, there is an Embedded Binaries field. When you add the framework there the crash is resolved.

Reference is here on Apple Developer Forums.

4
  • 1
    You really deserve a beer! Jul 27, 2018 at 8:00
  • This fix the issue Nov 16, 2018 at 11:33
  • This fixed it for me. Thanks! Jan 28, 2019 at 2:31
  • Please send me screensort, how i can add Aug 16, 2023 at 7:21
39

I also had same kind of problem where I was not able to launch the app & app was crashing with above message :

dyld: Library not loaded: @rpath/FrameworkName.framework/FrameworkName Referenced from: /private/var/mobile/Containers/Bundle/Application/xxxxxxxxxxxxxxxxxxx

Reason: image not found

Here is my approach that helped me to resolve this error:

  1. From General Tab

Frameworks, Libraries, and Embedded Content

  • add the framework and make sure to make it Embed & Sign

General Tab

  1. From Build Phases

Dependences

  • add the framework to it

Build Phases

3
  • 4
    I cannot add framework in Build Phased -> dependences. Jan 20, 2020 at 13:47
  • 8
    Embed & Sign did the trick. I'm not sure if the second step is necessary but thank you for the answer, upvoted!
    – Lukas
    May 12, 2020 at 7:18
  • You really deserve a beer brother!! Rock the Party!! Embed & Sign did the trick, I'm not sure if the second step is necessary or not.
    – Ravi
    Aug 28, 2021 at 4:34
11

Check if you can find framework in context under :

Build Phases > Embed Frameworks >

If not just add that framework in "Embed Frameworks" after adding that framework in your project directory's "Frameworks" section.
enter image description here

1
9

I was getting this error on a library installed through CocoaPods. Cleaning the build folder (cmd + option + shift + k) and then doing a clean (cmd + shift + k) was what ended up resolving this issue for me.

1
  • Same here! Thank you so much!
    – Xcoder
    Nov 24, 2018 at 16:49
6

If you are using Carthage

Run carthage update on terminal

Go to Project Settings -> Build Phases -> Carthage Copy Frameworks

Add line in Inputs files: $(SRCROOT)/Carthage/Build/iOS/YOURLIBRARY.framework

Add this line to Output files: $(BUILT_PRODUCTS_DIR)/$(FRAMEWORKS_FOLDER_PATH)/YOURLIBRARY.framework

4

Made the library which shows not loaded changed from required to optional in Linked binaries and frameworks. It is working perfectly now

3

For me it was because of the SSL issue, I had set my developer, distribution certificates on my Mac(Keychain) to 'Always Trust' for one of my other project. I had to change them back to 'Use System Defaults'. it was working for me then!!

0
2

I also had same kind of problem where I was not able to launch the app & app was crashing with above message :

dyld: Library not loaded: @rpath/FrameworkName.framework/FrameworkName Referenced from: /private/var/mobile/Containers/Bundle/Application/xxxxxxxxxxxxxxxxxxx

Reason: image not found

Here is my approach that helped me to resolve this error:

1.Please delete your app from device, Clean the build and and rebuild and run on the device.

2.If above steps does not help you, then please check for below settings :
From "TARGET">"Build Settings">"Runpath Search Paths" & then check for values "$(inherited)" & "@executable_path/Frameworks", Feel free to add incase they don't exist.

Build your app and run it on device

1

In addition to the above solutions, recheck the paths of frameworks included in your application under

Build Settings --> Search Paths --> Framework Search Paths

1

When non of those solution works:

  1. (Optional) Get a clear knowledge from here on different search path type
  2. Make sure that your .framework file paths are added in Build Settings -> Framework Search Paths. You can keep all framework files somewhere in App/libs/ and add this folder and enable recursively.
  3. Make sure that your .a files paths are added in Build Settings -> Library Search Paths.

enter image description here

0

I installed third party libraries using Cocoapods. Got the same error, tried everything but finally realised I havent had use_frameworks! in my pod file.

So removed the currently installed library, added use_frameworks! line in pod file, reinstalled the libraries and all worked for me.

0

The way tested by me is well.

In "Linked Binary With Libraries" change the missing framework to "Embedded Framework".

Because, "Do not Embedded" do not copy to the App, but Embedded Framework will copy into it.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.