Handling Archiver Driver Differences

Added in version 4.0.

To pass options to the archiver tool, each compiler driver has its own syntax. The ARCHIVER: prefix and , separator can be used to specify, in a portable way, options to pass to the archiver tool. ARCHIVER: is replaced by the appropriate driver option and , by the appropriate driver separator. The driver prefix and driver separator are given by the values of the CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG and CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG_SEP variables.

The ARCHIVER: prefix can be specified as part of a SHELL: prefix expression.

The ARCHIVER: prefix supports, as an alternative syntax, specification of arguments using the SHELL: prefix and space as separator.

Note

Specifying the SHELL: prefix anywhere other than at the beginning of the ARCHIVER: prefix is not supported.