I can't find anything workspace related in the Xcode Build Setting Reference.
Essentially I need something like $(WORKSPACE_DIR). If Xcode doesn't provide it, is there any way to define a custom user variable that could somehow accurately provide the workspace path in the event that the working workspace were to move (think branches etc)?
Custom variables can be defined under build settings. I think there is a button named Add Build Setting. So, a new variable workspace root can be defined relative to the SRCROOT or use absolute path.
The new setting is shown under "User Defined" group in build settings. "Add Build Setting" button is near lower right corner.
If your workspace is set up like:
then you can use
to get the workspace directory from a give project directory.
For example, if you want to have one project reference headers in another project:
(and set it to 'recursive' if you don't want to add every folder)