Alex Rivera | Logout

Header management with static libraries in Xcode 4

Asked 2011-06-09T08:23:17.073
9

Is there a best practice for importing static library headers in Xcode 4? Most of my projects depend on several other projects, so that I recently started to use the workspace feature to build all needed modules from one place (which I find very convenient).

What sucks is that we can’t use custom frameworks on iOS, so that the dependencies have to be built as static libraries and I get problems with header search paths. Whereas frameworks keep their headers with them inside the framework bundle, static libraries don’t have the option. I hate to set up user header search paths individually for each library I import. Ideally I’d like to drag the dependency project to the workspace, add the library to the main target and build, without further settings. Is this workflow supported?

xcode4 static-libraries header-files
Edit
Report

1 Answer

3

What I do is rather complicated, but it works well for me.

In the settings of the static library project, in the "Packaging" section, I set the "Wrapper Extension" to "framework". I then change:

"Public Headers Folder Path" to "$(PRODUCT_NAME).$(WRAPPER_EXTENSION)/Headers"

and

"Private Headers Folder Path" to $(PRODUCT_NAME).$(WRAPPER_EXTENSION)/PrivateHeaders

The end result in the build products is a folder named "MyLibraryName.framework" the guts of which look just like... well.. a Framework. One thing I like about this is I can use Framework-style includes in my code: 

#include <MyLibraryName/blah.h>

The downside is that (as discovered in the answer from "zoul") the "Archive" command doesn't work properly. The reason it doesn't work is because the Archive command separates the final build products and the target build products into separate directories. A normal "build" doesn't do that. When you archive the system tries to find the static libraries headers in the final build products directory and can't find them because the system put them in the target build directory for the static library.

If you think about it, Xcode thinks your static library's target has a single "product". That product is "libMyLibraryName.a". But really the target has two products... one is the library, and the other is the set of headers for the library. The problem with the Archive command is that the library is copied as a build product, but the headers are not. You end up with "header could not be found" when you try to run the archive.

To fix THAT, what I do is use a Run Script build phase. The script looks like this (written in Ruby):

if ENV["TARGET_BUILD_DIR"] != ENV["BUILT_PRODUCTS_DIR"] then
  $product_name = ENV['PRODUCT_NAME']
  $wrapper_extension = ENV['WRAPPER_EXTENSION']
  $target_build_dir = ENV['TARGET_BUILD_DIR']
answered 2012-10-24T19:58:07.437

Your Answer