How to fix "dyld: Library not loaded @rpath" error

If you are using a third-party framework in your project and getting the following error on launch, I can share one solution that solves the problem for me.

dyld: Library not loaded: @rpath/FrameworkName.framework/FrameworkName

Referenced from: <067E26D4-XXXX-YYYY-ZZZZ-7C89CFBE81CB> /private/var/containers/Bundle/Application/067E26D4-XXXX-YYYY-ZZZZ-7C89CFBE81CB/AppName.app/AppName

Reason: tried: '/usr/lib/swift/FrameworkName.framework/FrameworkName' (errno=2, not in dyld cache), '/private/preboot/Cryptexes/OS/usr/lib/swift/FrameworkName.framework/FrameworkName' (errno=2)
...

There might be several reasons that cause this error. I will share one reason in this article.

Cause of the problem

This error happened when you linked a Dynamic Library in your project but didn't ship (embed) the framework with the final application package.

As a result, a dynamic linker (dyld) complains that it can't find the framework.

You can easily support sarunw.com by checking out this sponsor.

AI Grammar: Correct grammar, spell check, check punctuation, and parphrase.

Try it for Free

How to fix "dyld: Library not loaded @rpath" error

The solution for this is easy. You need to embed the framework together with the application package.

To do that.

1. Select your app target.
2. Select "General" tab.
3. Scroll down to the "Framework, Libraries, and Embedded Content" section.
4. Make sure your framework is "Embed & Sign".