What does it mean when you check on "Recursive" in Header Search Paths

Viewed 19382

I've been referencing a lot of Projects, and i do it through adding their paths in Header Search Paths.

I've been following the referencing stuffs through the "Referenced Project's" getting Started (like for example including the ZXingWidget).

And I've been doing it a lot now, but I don't understand the checking of recursive.

  1. What does this mean?
  2. When do I check a path for "recursive?"

Thanks

4 Answers

For those wondering, as I was, what the effect of choosing recursive for a Header Search Path is on the compiler command line, it's to generate a -I argument for every directory in the tree rooted at the given path. This can lead to very long compiler command lines which will make looking for anything else in there well nigh impossible. So it's worth considering how many directories are below the path you are specifying if you want to use recursive.

I tried specifying -I../path/to/subproject/** as a Compiler Flag for an individual file but that doesn't work (which is obviously why Xcode does the expansion itself).

(this is true for Xcode 9.4.1)

Xcode Recursive path

When you set a path(e.g. Header Search Paths, Library Search Paths, Framework Search Paths...) you can define a path to one of parent folder and set recursive(/** will be added to the end of the path). For example you can defile a path to a include directory(or more over to a Build directory) with recursive parameter instead of include/<target_name>.

Please note: If the patch contains spaces - , you should escape them using \ or enclose the path in double quotes ""

Related