На этапах сборки оболочки вы можете писать в stderr в следующем формате:
<filename>:<linenumber>: error | warn | note : <message>\n
Это тот же формат, который использует gcc для отображения ошибок. Имя файла: часть белья может быть опущена. В зависимости от режима (ошибка, предупреждение, примечание), Xcode покажет ваше сообщение с красным или желтым значком.
Если указать абсолютный путь к файлу и номер строки (если ошибка произошла в файле), двойной щелчок по ошибке в журнале сборки позволяет Xcode открыть файл и перейти к строке, даже если она не является частью проект. Очень удобно.