Documentation TaskDoc JavaDoc Packages
  2. Property lists
  3. Property list overview

Property list overview

Property lists (also known as plist) are data containers that are extensively used by applications in the Apple ecosystem. One of the most important one is the Info.plist file that describes essential information about the apps.

The package supports dynamically manipulating property lists during the build. This is mostly used when build configuration related data needs to be inserted into the Info.plist file, or the plist format needs to be converted between binary and XML.

Note that the package only supports plist manipulation when running on macOS. While this seems obvious, you shouldn't expect to be able to work with property lists on non-macOS operating systems. The package uses the native CFPropertyList class to perform its operations.

Some aspects of the property list handling is still work in progress. Values with date or raw data type is not yet supported.

See Info.plist value insertion for inserting common values into the Info.plist file.