SM0 She11

Path: / / usr / share / cmake3 / Modules

Full Path (server): /usr/share/cmake3/Modules

📄 AddFileDependencies.cmake [E] [D]
📁 AndroidTestUtilities Open [D]
📄 AndroidTestUtilities.cmake [E] [D]
📄 BasicConfigVersion-AnyNewerVersion.cmake.in [E] [D]
📄 BasicConfigVersion-ExactVersion.cmake.in [E] [D]
📄 BasicConfigVersion-SameMajorVersion.cmake.in [E] [D]
📄 BasicConfigVersion-SameMinorVersion.cmake.in [E] [D]
📄 BundleUtilities.cmake [E] [D]
📄 CMake.cmake [E] [D]
📄 CMakeASM-ATTInformation.cmake [E] [D]
📄 CMakeASMCompiler.cmake.in [E] [D]
📄 CMakeASMInformation.cmake [E] [D]
📄 CMakeASM_MASMInformation.cmake [E] [D]
📄 CMakeASM_NASMInformation.cmake [E] [D]
📁 CMakeAddFortranSubdirectory Open [D]
📄 CMakeAddFortranSubdirectory.cmake [E] [D]
📄 CMakeAddNewLanguage.txt [E] [D]
📄 CMakeBackwardCompatibilityC.cmake [E] [D]
📄 CMakeBackwardCompatibilityCXX.cmake [E] [D]
📄 CMakeBorlandFindMake.cmake [E] [D]
📄 CMakeBuildSettings.cmake.in [E] [D]
📄 CMakeCCompiler.cmake.in [E] [D]
📄 CMakeCCompilerABI.c [E] [D]
📄 CMakeCCompilerId.c.in [E] [D]
📄 CMakeCInformation.cmake [E] [D]
📄 CMakeCSharpCompiler.cmake.in [E] [D]
📄 CMakeCSharpCompilerId.cs.in [E] [D]
📄 CMakeCSharpInformation.cmake [E] [D]
📄 CMakeCUDACompiler.cmake.in [E] [D]
📄 CMakeCUDACompilerABI.cu [E] [D]
📄 CMakeCUDACompilerId.cu.in [E] [D]
📄 CMakeCUDAInformation.cmake [E] [D]
📄 CMakeCXXCompiler.cmake.in [E] [D]
📄 CMakeCXXCompilerABI.cpp [E] [D]
📄 CMakeCXXCompilerId.cpp.in [E] [D]
📄 CMakeCXXInformation.cmake [E] [D]
📄 CMakeCheckCompilerFlagCommonPatterns.cmake [E] [D]
📄 CMakeCommonLanguageInclude.cmake [E] [D]
📄 CMakeCompilerABI.h [E] [D]
📄 CMakeCompilerIdDetection.cmake [E] [D]
📄 CMakeConfigurableFile.in [E] [D]
📄 CMakeDependentOption.cmake [E] [D]
📄 CMakeDetermineASM-ATTCompiler.cmake [E] [D]
📄 CMakeDetermineASMCompiler.cmake [E] [D]
📄 CMakeDetermineASM_MASMCompiler.cmake [E] [D]
📄 CMakeDetermineASM_NASMCompiler.cmake [E] [D]
📄 CMakeDetermineCCompiler.cmake [E] [D]
📄 CMakeDetermineCSharpCompiler.cmake [E] [D]
📄 CMakeDetermineCUDACompiler.cmake [E] [D]
📄 CMakeDetermineCXXCompiler.cmake [E] [D]
📄 CMakeDetermineCompileFeatures.cmake [E] [D]
📄 CMakeDetermineCompiler.cmake [E] [D]
📄 CMakeDetermineCompilerABI.cmake [E] [D]
📄 CMakeDetermineCompilerId.cmake [E] [D]
📄 CMakeDetermineFortranCompiler.cmake [E] [D]
📄 CMakeDetermineJavaCompiler.cmake [E] [D]
📄 CMakeDetermineOBJCCompiler.cmake [E] [D]
📄 CMakeDetermineOBJCXXCompiler.cmake [E] [D]
📄 CMakeDetermineRCCompiler.cmake [E] [D]
📄 CMakeDetermineSwiftCompiler.cmake [E] [D]
📄 CMakeDetermineSystem.cmake [E] [D]
📄 CMakeDetermineVSServicePack.cmake [E] [D]
📄 CMakeExpandImportedTargets.cmake [E] [D]
📄 CMakeExportBuildSettings.cmake [E] [D]
📄 CMakeExtraGeneratorDetermineCompilerMacrosAndIncludeDirs.cmake [E] [D]
📄 CMakeFindBinUtils.cmake [E] [D]
📄 CMakeFindCodeBlocks.cmake [E] [D]
📄 CMakeFindDependencyMacro.cmake [E] [D]
📄 CMakeFindEclipseCDT4.cmake [E] [D]
📄 CMakeFindFrameworks.cmake [E] [D]
📄 CMakeFindJavaCommon.cmake [E] [D]
📄 CMakeFindKate.cmake [E] [D]
📄 CMakeFindPackageMode.cmake [E] [D]
📄 CMakeFindSublimeText2.cmake [E] [D]
📄 CMakeFindWMake.cmake [E] [D]
📄 CMakeFindXCode.cmake [E] [D]
📄 CMakeForceCompiler.cmake [E] [D]
📄 CMakeFortranCompiler.cmake.in [E] [D]
📄 CMakeFortranCompilerABI.F [E] [D]
📄 CMakeFortranCompilerId.F.in [E] [D]
📄 CMakeFortranInformation.cmake [E] [D]
📄 CMakeGenericSystem.cmake [E] [D]
📄 CMakeGraphVizOptions.cmake [E] [D]
📄 CMakeIOSInstallCombined.cmake [E] [D]
📄 CMakeImportBuildSettings.cmake [E] [D]
📄 CMakeInitializeConfigs.cmake [E] [D]
📄 CMakeJOMFindMake.cmake [E] [D]
📄 CMakeJavaCompiler.cmake.in [E] [D]
📄 CMakeJavaInformation.cmake [E] [D]
📄 CMakeLanguageInformation.cmake [E] [D]
📄 CMakeMSYSFindMake.cmake [E] [D]
📄 CMakeMinGWFindMake.cmake [E] [D]
📄 CMakeNMakeFindMake.cmake [E] [D]
📄 CMakeNinjaFindMake.cmake [E] [D]
📄 CMakeOBJCCompiler.cmake.in [E] [D]
📄 CMakeOBJCCompilerABI.m [E] [D]
📄 CMakeOBJCCompilerId.m.in [E] [D]
📄 CMakeOBJCInformation.cmake [E] [D]
📄 CMakeOBJCXXCompiler.cmake.in [E] [D]
📄 CMakeOBJCXXCompilerABI.mm [E] [D]
📄 CMakeOBJCXXCompilerId.mm.in [E] [D]
📄 CMakeOBJCXXInformation.cmake [E] [D]
📄 CMakePackageConfigHelpers.cmake [E] [D]
📄 CMakeParseArguments.cmake [E] [D]
📄 CMakeParseImplicitIncludeInfo.cmake [E] [D]
📄 CMakeParseImplicitLinkInfo.cmake [E] [D]
📄 CMakePlatformId.h.in [E] [D]
📄 CMakePrintHelpers.cmake [E] [D]
📄 CMakePrintSystemInformation.cmake [E] [D]
📄 CMakePushCheckState.cmake [E] [D]
📄 CMakeRCCompiler.cmake.in [E] [D]
📄 CMakeRCInformation.cmake [E] [D]
📄 CMakeSwiftCompiler.cmake.in [E] [D]
📄 CMakeSwiftInformation.cmake [E] [D]
📄 CMakeSystem.cmake.in [E] [D]
📄 CMakeSystemSpecificInformation.cmake [E] [D]
📄 CMakeSystemSpecificInitialize.cmake [E] [D]
📄 CMakeTestASM-ATTCompiler.cmake [E] [D]
📄 CMakeTestASMCompiler.cmake [E] [D]
📄 CMakeTestASM_MASMCompiler.cmake [E] [D]
📄 CMakeTestASM_NASMCompiler.cmake [E] [D]
📄 CMakeTestCCompiler.cmake [E] [D]
📄 CMakeTestCSharpCompiler.cmake [E] [D]
📄 CMakeTestCUDACompiler.cmake [E] [D]
📄 CMakeTestCXXCompiler.cmake [E] [D]
📄 CMakeTestCompilerCommon.cmake [E] [D]
📄 CMakeTestFortranCompiler.cmake [E] [D]
📄 CMakeTestGNU.c [E] [D]
📄 CMakeTestJavaCompiler.cmake [E] [D]
📄 CMakeTestOBJCCompiler.cmake [E] [D]
📄 CMakeTestOBJCXXCompiler.cmake [E] [D]
📄 CMakeTestRCCompiler.cmake [E] [D]
📄 CMakeTestSwiftCompiler.cmake [E] [D]
📄 CMakeUnixFindMake.cmake [E] [D]
📄 CMakeVerifyManifest.cmake [E] [D]
📄 CPack.cmake [E] [D]
📄 CPackComponent.cmake [E] [D]
📄 CPackIFW.cmake [E] [D]
📄 CPackIFWConfigureFile.cmake [E] [D]
📄 CSharpUtilities.cmake [E] [D]
📄 CTest.cmake [E] [D]
📄 CTestCoverageCollectGCOV.cmake [E] [D]
📄 CTestScriptMode.cmake [E] [D]
📄 CTestTargets.cmake [E] [D]
📄 CTestUseLaunchers.cmake [E] [D]
📄 CheckCCompilerFlag.cmake [E] [D]
📄 CheckCSourceCompiles.cmake [E] [D]
📄 CheckCSourceRuns.cmake [E] [D]
📄 CheckCXXCompilerFlag.cmake [E] [D]
📄 CheckCXXSourceCompiles.cmake [E] [D]
📄 CheckCXXSourceRuns.cmake [E] [D]
📄 CheckCXXSymbolExists.cmake [E] [D]
📄 CheckForPthreads.c [E] [D]
📄 CheckFortranCompilerFlag.cmake [E] [D]
📄 CheckFortranFunctionExists.cmake [E] [D]
📄 CheckFortranSourceCompiles.cmake [E] [D]
📄 CheckFortranSourceRuns.cmake [E] [D]
📄 CheckFunctionExists.c [E] [D]
📄 CheckFunctionExists.cmake [E] [D]
📁 CheckIPOSupported Open [D]
📄 CheckIPOSupported.cmake [E] [D]
📄 CheckIncludeFile.c.in [E] [D]
📄 CheckIncludeFile.cmake [E] [D]
📄 CheckIncludeFile.cxx.in [E] [D]
📄 CheckIncludeFileCXX.cmake [E] [D]
📄 CheckIncludeFiles.cmake [E] [D]
📄 CheckLanguage.cmake [E] [D]
📄 CheckLibraryExists.cmake [E] [D]
📄 CheckLibraryExists.lists.in [E] [D]
📄 CheckOBJCCompilerFlag.cmake [E] [D]
📄 CheckOBJCSourceCompiles.cmake [E] [D]
📄 CheckOBJCSourceRuns.cmake [E] [D]
📄 CheckOBJCXXCompilerFlag.cmake [E] [D]
📄 CheckOBJCXXSourceCompiles.cmake [E] [D]
📄 CheckOBJCXXSourceRuns.cmake [E] [D]
📄 CheckPIESupported.cmake [E] [D]
📄 CheckPrototypeDefinition.c.in [E] [D]
📄 CheckPrototypeDefinition.cmake [E] [D]
📄 CheckSizeOf.cmake [E] [D]
📄 CheckStructHasMember.cmake [E] [D]
📄 CheckSymbolExists.cmake [E] [D]
📄 CheckTypeSize.c.in [E] [D]
📄 CheckTypeSize.cmake [E] [D]
📄 CheckTypeSizeMap.cmake.in [E] [D]
📄 CheckVariableExists.c [E] [D]
📄 CheckVariableExists.cmake [E] [D]
📁 Compiler Open [D]
📁 CompilerId Open [D]
📄 Dart.cmake [E] [D]
📄 DartConfiguration.tcl.in [E] [D]
📄 DeployQt4.cmake [E] [D]
📄 Documentation.cmake [E] [D]
📄 DummyCXXFile.cxx [E] [D]
📄 ExternalData.cmake [E] [D]
📄 ExternalData_config.cmake.in [E] [D]
📄 ExternalProject-download.cmake.in [E] [D]
📄 ExternalProject-verify.cmake.in [E] [D]
📄 ExternalProject.cmake [E] [D]
📄 FLTKCompatibility.cmake [E] [D]
📄 FeatureSummary.cmake [E] [D]
📁 FetchContent Open [D]
📄 FetchContent.cmake [E] [D]
📄 FindALSA.cmake [E] [D]
📄 FindASPELL.cmake [E] [D]
📄 FindAVIFile.cmake [E] [D]
📄 FindArmadillo.cmake [E] [D]
📄 FindBISON.cmake [E] [D]
📄 FindBLAS.cmake [E] [D]
📄 FindBZip2.cmake [E] [D]
📄 FindBacktrace.cmake [E] [D]
📄 FindBoost.cmake [E] [D]
📄 FindBullet.cmake [E] [D]
📄 FindCABLE.cmake [E] [D]
📁 FindCUDA Open [D]
📄 FindCUDA.cmake [E] [D]
📄 FindCUDAToolkit.cmake [E] [D]
📄 FindCURL.cmake [E] [D]
📄 FindCVS.cmake [E] [D]
📄 FindCoin3D.cmake [E] [D]
📄 FindCups.cmake [E] [D]
📄 FindCurses.cmake [E] [D]
📄 FindCxxTest.cmake [E] [D]
📄 FindCygwin.cmake [E] [D]
📄 FindDCMTK.cmake [E] [D]
📄 FindDart.cmake [E] [D]
📄 FindDevIL.cmake [E] [D]
📄 FindDoxygen.cmake [E] [D]
📄 FindEXPAT.cmake [E] [D]
📄 FindEnvModules.cmake [E] [D]
📄 FindFLEX.cmake [E] [D]
📄 FindFLTK.cmake [E] [D]
📄 FindFLTK2.cmake [E] [D]
📄 FindFontconfig.cmake [E] [D]
📄 FindFreetype.cmake [E] [D]
📄 FindGCCXML.cmake [E] [D]
📄 FindGDAL.cmake [E] [D]
📄 FindGIF.cmake [E] [D]
📄 FindGLEW.cmake [E] [D]
📄 FindGLU.cmake [E] [D]
📄 FindGLUT.cmake [E] [D]
📄 FindGSL.cmake [E] [D]
📄 FindGTK.cmake [E] [D]
📄 FindGTK2.cmake [E] [D]
📄 FindGTest.cmake [E] [D]
📄 FindGettext.cmake [E] [D]
📄 FindGit.cmake [E] [D]
📄 FindGnuTLS.cmake [E] [D]
📄 FindGnuplot.cmake [E] [D]
📄 FindHDF5.cmake [E] [D]
📄 FindHSPELL.cmake [E] [D]
📄 FindHTMLHelp.cmake [E] [D]
📄 FindHg.cmake [E] [D]
📄 FindICU.cmake [E] [D]
📄 FindIce.cmake [E] [D]
📄 FindIconv.cmake [E] [D]
📄 FindIcotool.cmake [E] [D]
📄 FindImageMagick.cmake [E] [D]
📄 FindIntl.cmake [E] [D]
📄 FindJNI.cmake [E] [D]
📄 FindJPEG.cmake [E] [D]
📄 FindJasper.cmake [E] [D]
📄 FindJava.cmake [E] [D]
📄 FindKDE3.cmake [E] [D]
📄 FindKDE4.cmake [E] [D]
📄 FindLAPACK.cmake [E] [D]
📄 FindLATEX.cmake [E] [D]
📄 FindLTTngUST.cmake [E] [D]
📄 FindLibArchive.cmake [E] [D]
📄 FindLibLZMA.cmake [E] [D]
📄 FindLibXml2.cmake [E] [D]
📄 FindLibXslt.cmake [E] [D]
📄 FindLibinput.cmake [E] [D]
📄 FindLua.cmake [E] [D]
📄 FindLua50.cmake [E] [D]
📄 FindLua51.cmake [E] [D]
📄 FindMFC.cmake [E] [D]
📄 FindMPEG.cmake [E] [D]
📄 FindMPEG2.cmake [E] [D]
📁 FindMPI Open [D]
📄 FindMPI.cmake [E] [D]
📄 FindMatlab.cmake [E] [D]
📄 FindMotif.cmake [E] [D]
📄 FindODBC.cmake [E] [D]
📄 FindOpenACC.cmake [E] [D]
📄 FindOpenAL.cmake [E] [D]
📄 FindOpenCL.cmake [E] [D]
📄 FindOpenGL.cmake [E] [D]
📄 FindOpenMP.cmake [E] [D]
📄 FindOpenSSL.cmake [E] [D]
📄 FindOpenSceneGraph.cmake [E] [D]
📄 FindOpenThreads.cmake [E] [D]
📄 FindPHP4.cmake [E] [D]
📄 FindPNG.cmake [E] [D]
📄 FindPackageHandleStandardArgs.cmake [E] [D]
📄 FindPackageMessage.cmake [E] [D]
📄 FindPatch.cmake [E] [D]
📄 FindPerl.cmake [E] [D]
📄 FindPerlLibs.cmake [E] [D]
📄 FindPhysFS.cmake [E] [D]
📄 FindPike.cmake [E] [D]
📄 FindPkgConfig.cmake [E] [D]
📄 FindPostgreSQL.cmake [E] [D]
📄 FindProducer.cmake [E] [D]
📄 FindProtobuf.cmake [E] [D]
📁 FindPython Open [D]
📄 FindPython.cmake [E] [D]
📄 FindPython2.cmake [E] [D]
📄 FindPython3.cmake [E] [D]
📄 FindPythonInterp.cmake [E] [D]
📄 FindPythonLibs.cmake [E] [D]
📄 FindQt.cmake [E] [D]
📄 FindQt3.cmake [E] [D]
📄 FindQt4.cmake [E] [D]
📄 FindQuickTime.cmake [E] [D]
📄 FindRTI.cmake [E] [D]
📄 FindRuby.cmake [E] [D]
📄 FindRuby.cmake.findruby [E] [D]
📄 FindSDL.cmake [E] [D]
📄 FindSDL_image.cmake [E] [D]
📄 FindSDL_mixer.cmake [E] [D]
📄 FindSDL_net.cmake [E] [D]
📄 FindSDL_sound.cmake [E] [D]
📄 FindSDL_ttf.cmake [E] [D]
📄 FindSQLite3.cmake [E] [D]
📄 FindSWIG.cmake [E] [D]
📄 FindSelfPackers.cmake [E] [D]
📄 FindSquish.cmake [E] [D]
📄 FindSubversion.cmake [E] [D]
📄 FindTCL.cmake [E] [D]
📄 FindTIFF.cmake [E] [D]
📄 FindTclStub.cmake [E] [D]
📄 FindTclsh.cmake [E] [D]
📄 FindThreads.cmake [E] [D]
📄 FindUnixCommands.cmake [E] [D]
📄 FindVulkan.cmake [E] [D]
📄 FindWget.cmake [E] [D]
📄 FindWish.cmake [E] [D]
📄 FindX11.cmake [E] [D]
📄 FindXCTest.cmake [E] [D]
📄 FindXMLRPC.cmake [E] [D]
📄 FindXalanC.cmake [E] [D]
📄 FindXercesC.cmake [E] [D]
📄 FindZLIB.cmake [E] [D]
📄 Findosg.cmake [E] [D]
📄 FindosgAnimation.cmake [E] [D]
📄 FindosgDB.cmake [E] [D]
📄 FindosgFX.cmake [E] [D]
📄 FindosgGA.cmake [E] [D]
📄 FindosgIntrospection.cmake [E] [D]
📄 FindosgManipulator.cmake [E] [D]
📄 FindosgParticle.cmake [E] [D]
📄 FindosgPresentation.cmake [E] [D]
📄 FindosgProducer.cmake [E] [D]
📄 FindosgQt.cmake [E] [D]
📄 FindosgShadow.cmake [E] [D]
📄 FindosgSim.cmake [E] [D]
📄 FindosgTerrain.cmake [E] [D]
📄 FindosgText.cmake [E] [D]
📄 FindosgUtil.cmake [E] [D]
📄 FindosgViewer.cmake [E] [D]
📄 FindosgVolume.cmake [E] [D]
📄 FindosgWidget.cmake [E] [D]
📄 Findosg_functions.cmake [E] [D]
📄 FindwxWidgets.cmake [E] [D]
📄 FindwxWindows.cmake [E] [D]
📁 FortranCInterface Open [D]
📄 FortranCInterface.cmake [E] [D]
📄 GNUInstallDirs.cmake [E] [D]
📄 GenerateExportHeader.cmake [E] [D]
📄 GetPrerequisites.cmake [E] [D]
📄 GoogleTest.cmake [E] [D]
📄 GoogleTestAddTests.cmake [E] [D]
📄 ITKCompatibility.cmake [E] [D]
📄 InstallRequiredSystemLibraries.cmake [E] [D]
📁 IntelVSImplicitPath Open [D]
📁 Internal Open [D]
📄 KDE3Macros.cmake [E] [D]
📄 MacOSXBundleInfo.plist.in [E] [D]
📄 MacOSXFrameworkInfo.plist.in [E] [D]
📄 MacroAddFileDependencies.cmake [E] [D]
📄 MatlabTestsRedirect.cmake [E] [D]
📁 Platform Open [D]
📄 ProcessorCount.cmake [E] [D]
📄 Qt4ConfigDependentSettings.cmake [E] [D]
📄 Qt4Macros.cmake [E] [D]
📄 RepositoryInfo.txt.in [E] [D]
📄 SelectLibraryConfigurations.cmake [E] [D]
📄 Squish4RunTestCase.bat [E] [D]
📄 Squish4RunTestCase.sh [E] [D]
📄 SquishRunTestCase.bat [E] [D]
📄 SquishRunTestCase.sh [E] [D]
📄 SquishTestScript.cmake [E] [D]
📄 SystemInformation.cmake [E] [D]
📄 SystemInformation.in [E] [D]
📄 TestBigEndian.cmake [E] [D]
📄 TestCXXAcceptsFlag.cmake [E] [D]
📄 TestEndianess.c.in [E] [D]
📄 TestForANSIForScope.cmake [E] [D]
📄 TestForANSIStreamHeaders.cmake [E] [D]
📄 TestForANSIStreamHeaders.cxx [E] [D]
📄 TestForAnsiForScope.cxx [E] [D]
📄 TestForSSTREAM.cmake [E] [D]
📄 TestForSSTREAM.cxx [E] [D]
📄 TestForSTDNamespace.cmake [E] [D]
📄 TestForSTDNamespace.cxx [E] [D]
📄 UseEcos.cmake [E] [D]
📄 UseJava.cmake [E] [D]
📄 UseJavaClassFilelist.cmake [E] [D]
📄 UseJavaSymlinks.cmake [E] [D]
📄 UsePkgConfig.cmake [E] [D]
📄 UseQt4.cmake [E] [D]
📁 UseSWIG Open [D]
📄 UseSWIG.cmake [E] [D]
📄 Use_wxWindows.cmake [E] [D]
📄 UsewxWidgets.cmake [E] [D]
📄 VTKCompatibility.cmake [E] [D]
📄 WriteBasicConfigVersionFile.cmake [E] [D]
📄 WriteCompilerDetectionHeader.cmake [E] [D]
📄 ecos_clean.cmake [E] [D]
📄 exportheader.cmake.in [E] [D]
📄 javaTargets.cmake.in [E] [D]
📄 kde3init_dummy.cpp.in [E] [D]
📄 kde3uic.cmake [E] [D]
📄 readme.txt [E] [D]

Editing: AndroidTestUtilities.cmake

# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
# file Copyright.txt or https://cmake.org/licensing for details.

#[======================================================================[.rst:
AndroidTestUtilities
------------------------

Create a test that automatically loads specified data onto an Android device.

Introduction
^^^^^^^^^^^^

Use this module to push data needed for testing an Android device behavior
onto a connected Android device. The module will accept files and libraries as
well as separate destinations for each. It will create a test that loads the
files into a device object store and link to them from the specified
destination. The files are only uploaded if they are not already in the object
store.

For example:

.. code-block:: cmake

include(AndroidTestUtilities)
  android_add_test_data(
    example_setup_test
    FILES <files>...
    LIBS <libs>...
    DEVICE_TEST_DIR "/data/local/tests/example"
    DEVICE_OBJECT_STORE "/sdcard/.ExternalData/SHA"
    )

At build time a test named "example_setup_test" will be created.  Run this test
on the command line with :manual:`ctest(1)` to load the data onto the Android
device.

Module Functions
^^^^^^^^^^^^^^^^

.. command:: android_add_test_data

.. code-block:: cmake

android_add_test_data(<test-name>
      [FILES <files>...] [FILES_DEST <device-dir>]
      [LIBS <libs>...]   [LIBS_DEST <device-dir>]
      [DEVICE_OBJECT_STORE <device-dir>]
      [DEVICE_TEST_DIR <device-dir>]
      [NO_LINK_REGEX <strings>...]
      )

The ``android_add_test_data`` function is used to copy files and libraries
  needed to run project-specific tests. On the host operating system, this is
  done at build time. For on-device testing, the files are loaded onto the
  device by the manufactured test at run time.

This function accepts the following named parameters:

``FILES <files>...``
    zero or more files needed for testing
  ``LIBS <libs>...``
    zero or more libraries needed for testing
  ``FILES_DEST <device-dir>``
    absolute path where the data files are expected to be
  ``LIBS_DEST <device-dir>``
    absolute path where the libraries are expected to be
  ``DEVICE_OBJECT_STORE <device-dir>``
    absolute path to the location where the data is stored on-device
  ``DEVICE_TEST_DIR <device-dir>``
    absolute path to the root directory of the on-device test location
  ``NO_LINK_REGEX <strings>...``
    list of regex strings matching the names of files that should be
    copied from the object store to the testing directory
#]======================================================================]

include(${CMAKE_CURRENT_LIST_DIR}/ExternalData.cmake)

# The parameters to this function should be set to the list of directories,
# files, and libraries that need to be installed prior to testing.
function(android_add_test_data test_name)
  # As the names suggest, oneValueArgs lists the arguments that specify a
  # single value, while multiValueArgs can contain one or more values.
  set(keywordArgs)
  set(oneValueArgs FILES_DEST LIBS_DEST DEVICE_OBJECT_STORE DEVICE_TEST_DIR)
  set(multiValueArgs FILES LIBS NO_LINK_REGEX)

# For example, if you called this function with FILES </path/to/file>
  # then this path would be stored in the variable AST_FILES.
  # The AST prefix stands for the name of this function (android_add_test_data).
  cmake_parse_arguments(AST "${keywordArgs}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
  if(NOT AST_DEVICE_TEST_DIR)
    message(FATAL_ERROR "-- You must specify the location of the on device test directory.")
  endif()
  if(NOT AST_DEVICE_OBJECT_STORE)
    message(FATAL_ERROR "-- You must specify the location of the on device object store.")
  endif()
  if(${AST_DEVICE_TEST_DIR} STREQUAL "/")
    message(FATAL_ERROR "-- The device test directory cannot be '/'")
  endif()

# Copy all test data files into the binary directory, where tests are run.
  # ExternalData will handle fetching DATA{...} references.
  string(REPLACE "|" ";" hash_algs "${_ExternalData_REGEX_EXT}")
  # Convert ExternalData placeholder file names to DATA{} syntax.
  foreach(alg ${hash_algs})
    string(REGEX REPLACE "([^ ;]+)\\.${alg}" "DATA{\\1}" AST_FILES "${AST_FILES}")
  endforeach()

set(DATA_TARGET_NAME "${test_name}")
  string(FIND "${AST_FILES}" "DATA{" data_files_found)
  if(${data_files_found} GREATER "-1")
    # Use ExternalData if any DATA{} files were found.
    ExternalData_Expand_Arguments(
      ${DATA_TARGET_NAME}
      extern_data_output
      ${AST_FILES})
    ExternalData_Add_Target(${DATA_TARGET_NAME})
  else()
    add_custom_target(${DATA_TARGET_NAME} ALL)
    set(extern_data_output ${AST_FILES})
  endif()

# For regular files on Linux, just copy them directly.
  foreach(path ${AST_FILES})
    foreach(output ${extern_data_output})
      if(${output} STREQUAL ${path})
        # Check if a destination was specified.  If not, we copy by default
        # into this project's binary directory, preserving its relative path.
        if(AST_${VAR}_DEST)
          set(DEST ${CMAKE_BINARY_DIR}/${parent_dir}/${AST_${VAR}_DEST})
        else()
          get_filename_component(parent_dir ${path} DIRECTORY)
          set(DEST "${CMAKE_BINARY_DIR}/${parent_dir}")
        endif()
        get_filename_component(extern_data_source ${output} REALPATH)
        get_filename_component(extern_data_basename ${output} NAME)
        add_custom_command(
          TARGET ${DATA_TARGET_NAME} POST_BUILD
          DEPENDS ${extern_data_source}
          COMMAND ${CMAKE_COMMAND} -E copy_if_different ${extern_data_source} ${DEST}/${extern_data_basename}
        )
      endif()
    endforeach()
  endforeach()

if(ANDROID)
    string(REGEX REPLACE "DATA{([^ ;]+)}" "\\1"  processed_FILES "${AST_FILES}")
    add_test(
      NAME ${test_name}
      COMMAND ${CMAKE_COMMAND}
      "-Darg_files_dest=${AST_FILES_DEST}"
      "-Darg_libs_dest=${AST_LIBS_DEST}"
      "-Darg_dev_test_dir=${AST_DEVICE_TEST_DIR}"
      "-Darg_dev_obj_store=${AST_DEVICE_OBJECT_STORE}"
      "-Darg_no_link_regex=${AST_NO_LINK_REGEX}"
      "-Darg_files=${processed_FILES}"
      "-Darg_libs=${AST_LIBS}"
      "-Darg_src_dir=${CMAKE_CURRENT_SOURCE_DIR}"
      -P ${CMAKE_CURRENT_FUNCTION_LIST_DIR}/AndroidTestUtilities/PushToAndroidDevice.cmake)
  endif()
endfunction()