"Do Not Embed", "Embed & Sign", "Embed Without Signing". What are they?. What they do?

Solution 1:

As already stated by @przemyslaw-jablonski, this is similar to what was in XCode 10, but in only one screen (which I personally like!).


Embedding

Do not embed static frameworks and libraries (linking happens at build time), only shared ones (dynamic linking happens at run time, so they need to be in your bundle).

file frameworkToLink.framework/frameworkToLink will return:

  • current ar archive: static library, select Do not embed
  • Mach-O dynamically linked: shared library, select Embed

Signing (only if shared/embedded)

Not required if it already has a proper signature (adhoc doesn't count).

codesign -dv frameworkToLink.framework will return:

  • code object is not signed at all or adhoc: select Embed and sign
  • anything else: already properly signed, select Embed Without Signing

Solution 2:

Basically in Xcode 10 in project settings (upon clicking on .xcodeproj file, with the blue icon) you had two framework-oriented sections visible - Embedded Binaries and Linked Frameworks and Libraries. Now they are merged into one.

Do Not Embed option is basically Linking given .framework into project.

Embed & Sign and Embed Without Signing is old Embedding option.

I am not entirely sure what is the functional difference between the last two, apart from the fact that framework will or will not be signed during assembly. If you want to know the difference between Linking and Embedding then here you can find SO answer on this.

Pics:

Xcode 10

Xcode 11

Solution 3:

Xcode v11. Frameworks, Libraries, and Embedded Content plus Frameworks and Libraries with Embed vs Do Not Embed

enter image description here

History

Embedded Binaries, Linked Frameworks and Libraries -> Frameworks, Libraries, and Embedded Content

[Xcode pre-v11. Embedded Binaries, Linked Frameworks and Libraries] existed till to Xcode v11 section in General tab

It is a part of Dependency management [About]

Xcode v11 has:

  • App target - Frameworks, Libraries, and Embedded Content
  • Framework or App extension target - Frameworks and Libraries

Embedding

Embed

It adds a copy of the framework into your final bundle. After that Dynamic linker :dyld at load or run time tries to find the embedded framework using @rpath[About] If it is not found the error will occur [dyld: Library not loaded]

Embed is a mirror of Build Phases -> Embed Frameworks. Here you can setup bundle's folder and Subpath.

Do Not Embed

Static Linker at compile time tries to copy code from a static library into the executable object file using Build Settings -> Framework Search Paths

Do Not Embed is a mirror of Build Phases -> Link Binary With Libraries. Sign is a mirror of Code Sign On Copy

If you do not add a static framework to this section you will get a compile error[No such module]

Result:

  • static library
  • static framework - Do Not Embed
  • dynamic framework - Embed

*Please note that Embedding has bigger priority than Mach-O Type[About]

  • Application's Frameworks, Libraries... is Embed and Framework's Mach-O is Static Library - result dynamic framework.
  • Application's Frameworks, Libraries... is Do Not Embed and Framework's Mach-O is Dynamic Library and - result error dyld: Library not loaded[About]
App's Embed (Dynamic) -> Framework's Mach-O Static - Dynamic
App's Do Not Embed(Static) -> Framework's Mach-O Dynamic - error

[Static vs Dynamic linker]
[When use Link and Embed]
[Vocabulary]