rapids_export_find_package_file

Added in version v21.06.00.

Record that the file found at <file_path> needs to be usable as part of the associated export set.

rapids_export_find_package_file( (BUILD|INSTALL)
                                 <file_path>
                                 (<ExportSetName> | EXPORT_SET [ExportSetName])
                                 [CONDITION <variableName>]
                                )

When constructing export sets, espically installed ones it is necessary to install any custom FindModules that your project has written. The rapids_export_find_package_file(BUILD|INSTALL) allows projects to easily specify that a FindModule is either used by our export set or used by a consumer, allowing rapids-cmake to ensure it is installed correct and added to CMAKE_MODULE_PATH when needed.

BUILD

Record that the FindPackage at <file_path> needs to be part of our build directory export set. This means that it will be usable by the calling package if it needs to search for <PackageName> again.

INSTALL

Record that the FindPackage at <file_path> needs to be part of our install export set. This means that it will be installed as part of our packages CMake export set infrastructure

EXPORT_SET

List the export set name that this code should be attached too. If no name is given the associated call will be ignored.

CONDITION

A boolean variable name, that when evaluates to undefined or a false value will cause the associated call to be ignored.