Commit 9d1c77cf authored by Brad King's avatar Brad King Committed by Kitware Robot
Browse files

Merge topic 'doc-apple-info-plist-properties'

9a7f042a Help: Document target properties setting Info.plist fields (#15820)
parents 06ed3eb9 9a7f042a
MACOSX_BUNDLE_INFO_PLIST
------------------------
Specify a custom Info.plist template for a Mac OS X App Bundle.
Specify a custom ``Info.plist`` template for a Mac OS X App Bundle.
An executable target with MACOSX_BUNDLE enabled will be built as an
application bundle on Mac OS X. By default its Info.plist file is
created by configuring a template called MacOSXBundleInfo.plist.in
located in the CMAKE_MODULE_PATH. This property specifies an
alternative template file name which may be a full path.
An executable target with :prop_tgt:`MACOSX_BUNDLE` enabled will be built as an
application bundle on Mac OS X. By default its ``Info.plist`` file is created
by configuring a template called ``MacOSXBundleInfo.plist.in`` located in the
:variable:`CMAKE_MODULE_PATH`. This property specifies an alternative template
file name which may be a full path.
The following target properties may be set to specify content to be
configured into the file:
::
MACOSX_BUNDLE_INFO_STRING
MACOSX_BUNDLE_ICON_FILE
MACOSX_BUNDLE_GUI_IDENTIFIER
MACOSX_BUNDLE_LONG_VERSION_STRING
MACOSX_BUNDLE_BUNDLE_NAME
MACOSX_BUNDLE_SHORT_VERSION_STRING
MACOSX_BUNDLE_BUNDLE_VERSION
MACOSX_BUNDLE_COPYRIGHT
``MACOSX_BUNDLE_BUNDLE_NAME``
Sets ``CFBundleName``.
``MACOSX_BUNDLE_BUNDLE_VERSION``
Sets ``CFBundleVersion``.
``MACOSX_BUNDLE_COPYRIGHT``
Sets ``NSHumanReadableCopyright``.
``MACOSX_BUNDLE_GUI_IDENTIFIER``
Sets ``CFBundleIdentifier``.
``MACOSX_BUNDLE_ICON_FILE``
Sets ``CFBundleIconFile``.
``MACOSX_BUNDLE_INFO_STRING``
Sets ``CFBundleGetInfoString``.
``MACOSX_BUNDLE_LONG_VERSION_STRING``
Sets ``CFBundleLongVersionString``.
``MACOSX_BUNDLE_SHORT_VERSION_STRING``
Sets ``CFBundleShortVersionString``.
CMake variables of the same name may be set to affect all targets in a
directory that do not have each specific property set. If a custom
Info.plist is specified by this property it may of course hard-code
``Info.plist`` is specified by this property it may of course hard-code
all the settings instead of using the target properties.
MACOSX_FRAMEWORK_INFO_PLIST
---------------------------
Specify a custom Info.plist template for a Mac OS X Framework.
Specify a custom ``Info.plist`` template for a Mac OS X Framework.
A library target with FRAMEWORK enabled will be built as a framework
on Mac OS X. By default its Info.plist file is created by configuring
a template called MacOSXFrameworkInfo.plist.in located in the
CMAKE_MODULE_PATH. This property specifies an alternative template
A library target with :prop_tgt:`FRAMEWORK` enabled will be built as a
framework on Mac OS X. By default its ``Info.plist`` file is created by
configuring a template called ``MacOSXFrameworkInfo.plist.in`` located in the
:variable:`CMAKE_MODULE_PATH`. This property specifies an alternative template
file name which may be a full path.
The following target properties may be set to specify content to be
configured into the file:
::
MACOSX_FRAMEWORK_ICON_FILE
MACOSX_FRAMEWORK_IDENTIFIER
MACOSX_FRAMEWORK_SHORT_VERSION_STRING
MACOSX_FRAMEWORK_BUNDLE_VERSION
``MACOSX_FRAMEWORK_BUNDLE_VERSION``
Sets ``CFBundleVersion``.
``MACOSX_FRAMEWORK_ICON_FILE``
Sets ``CFBundleIconFile``.
``MACOSX_FRAMEWORK_IDENTIFIER``
Sets ``CFBundleIdentifier``.
``MACOSX_FRAMEWORK_SHORT_VERSION_STRING``
Sets ``CFBundleShortVersionString``.
CMake variables of the same name may be set to affect all targets in a
directory that do not have each specific property set. If a custom
Info.plist is specified by this property it may of course hard-code
``Info.plist`` is specified by this property it may of course hard-code
all the settings instead of using the target properties.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment