[cmake-developers] [CMake 0015820]: lack of descrition of corresponding keys inside MACOSX_FRAMEWORK_INFO_PLIST and MACOSX_BUNDLE_INFO_PLIST

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
https://public.kitware.com/Bug/view.php?id=15820 
====================================================================== 
Reported By:                gang65
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   15820
Category:                   CMake
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2015-10-29 08:05 EDT
Last Modified:              2015-10-29 08:05 EDT
====================================================================== 
Summary:                    lack of descrition of corresponding keys inside
MACOSX_FRAMEWORK_INFO_PLIST and MACOSX_BUNDLE_INFO_PLIST
Description: 
Hello.

In following documentation there is description of target properties:
https://cmake.org/cmake/help/v3.0/prop_tgt/MACOSX_BUNDLE_INFO_PLIST.html
and
https://cmake.org/cmake/help/v3.0/prop_tgt/MACOSX_FRAMEWORK_INFO_PLIST.html

The is no described what keys are corresponding to:

For MACOSX_FRAMEWORK_INFO_PLIST is:
MACOSX_FRAMEWORK_ICON_FILE
MACOSX_FRAMEWORK_IDENTIFIER
MACOSX_FRAMEWORK_SHORT_VERSION_STRING
MACOSX_FRAMEWORK_BUNDLE_VERSION

It will be very useful to add description of following keys, for example:
MACOSX_FRAMEWORK_ICON_FILE Key: "CFBundleIconFile"
MACOSX_FRAMEWORK_IDENTIFIER Key: "CFBundleIdentifier"
MACOSX_FRAMEWORK_SHORT_VERSION_STRING Key: "CFBundleShortVersionString"
MACOSX_FRAMEWORK_BUNDLE_VERSION Key: CFBundleVersion

The same for MACOSX_BUNDLE_INFO_PLIST.
MACOSX_BUNDLE_ICON_FILE Key: "CFBundleIconFile"
MACOSX_BUNDLE_IDENTIFIER Key: "CFBundleIdentifier"
MACOSX_BUNDLE_SHORT_VERSION_STRING Key: "CFBundleShortVersionString"
MACOSX_BUNDLE_BUNDLE_VERSION Key: CFBundleVersion
MACOSX_BUNDLE_INFO_STRING 
MACOSX_BUNDLE_GUI_IDENTIFIER
MACOSX_BUNDLE_LONG_VERSION_STRING Key: "CFBundleLongVersionString"
MACOSX_BUNDLE_BUNDLE_NAME Key: "CFBundleName"
MACOSX_BUNDLE_COPYRIGHT

etc..

The Info.plist is universal file (for every bundle), is it possible to create
only one list?
Also MACOSX_ prefix is very confusing, as Info.plist is also applicable for iOS,
and it looks the same.


Additional Information: 


Solution proposal:
Introduce new universal property BUNDLE_INFO_PLIST, with all possible
properties, which could be written into Info.plist:
BUNDLE_CF_ICON_FILE Key: "CFBundleIconFile"
BUNDLE_CF_IDENTIFIER Key: "CFBundleIdentifier"
BUNDLE_CF_SHORT_VERSION_STRING Key: "CFBundleShortVersionString"
BUNDLE_CF_BUNDLE_VERSION Key: CFBundleVersion
BUNDLE_NS_HUMAN_READABLE_COPYRIGHT Key: "NSHumanReadableCopyright"


More information about keys Core Foundation keys:
https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html

https://developer.apple.com/library/mac/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html

https://developer.apple.com/library/ios/documentation/General/Reference/InfoPlistKeyReference/Introduction/Introduction.html


====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2015-10-29 08:05 gang65         New Issue                                    
======================================================================