Preprocessing Info.plist files in Xcode Using the C Preprocessor
This document provides solutions to several challenges faced when preprocessing Info.plist files with the GCC C preprocessor in Xcode. It details how to keep URLs from being converted to comments, how to format strings to preserve whitespace in <string> properties and a successful technique to handle macro expansion.
There are several well-known challenges faced by the development community using the GCC C preprocessor to preprocess their property list (
Info.plist) files in Xcode. Some developers have faced issues with the whitespace in their user-defined strings being compressed after preprocessing. Others faced problems concerning URLs being turned into comments and discarded, or being unable to successfully expand user-defined macros in reference to the
Info.plist files. This document will present workarounds for each of these issues.
Preserving whitespace within strings defined in an Info.plist file
In Xcode a
<string> property in an
Info.plist file will have any embedded runs of spaces converted to a single space when the plist is copied to the built product. This is an issue when string properties are used in cases where strings are compared for matching purposes.
This problem is often seen in device driver development. For example, the IOSCSIPeripheralDeviceNub for a particular drive model has the property "Product Identification" with the value
- there are three consecutive spaces in this value. By default, if that key/value pair is placed in the
Info.plist of a device driver, the value in the built KEXT is changed to
- where the three consecutive spaces have been compressed into a single space. As a result, the property in the
Info.plist does not match the device and the driver silently fails to start.
To preserve the whitespace within the
<string> property, replace the space characters inside the string with the XML character reference
. In the device driver example, the
Info.plist would contain the property:
Preventing URLs from being converted to comments and discarded
Using the GCC C preprocessor to preprocess your
Info.plist files may have some unintended side-effects. Such as using URLs in your file. That is, the C preprocessor treats the text in the same way it would treat source code - anything following "//" characters are treated as comments and discarded. Therefore, a
<string> property that is originally represented as this:
will get converted into this:
To work around this feature of the C preprocessor, we can pass the
-traditional flag to the
Info.plist Other Preprocessor Flags build setting in Xcode. This will cause the preprocessor to use the traditional ANSI C
*/ character strings as tokens to recognize and discard text as comments.
Eliminating whitespace between tokens in the macro expansion process
Many developers wish to use macros to represent specific things about their software in the
Info.plist file. One such usage is to represent the values for the major, minor and maintenance versions of their software. For example:
#define MAJORVERSION 2 #define MINORVERSION 4 #define MAINTVERSION 6
placed in the Info.plist prefix header with a corresponding
Info.plist file containing:
will cause the string
"1 . 2 . 3" to appear in the
About window of the application. The spaces between the numbers in the macro expansion process can be avoided by passing
-traditional to the
Info.plist Other Preprocessor Flags build setting.
Document Revision History
Fixed typo. Pass the "-traditional" flag rather than the "-CC" flag to eliminate whitespace between tokens in the macro expansion process.
New document that describes workarounds for several issues concerning preprocessing Info.plist files in Xcode with the C preprocessor.
© 2010 Apple Inc. All Rights Reserved. (Last updated: 2010-05-07)