BinaryProbe

Locates executable files outside the project. More...

• List of all members, including inherited members

Detailed Description

Finds executable files that have the specified file names.

BinaryProbe searches for executable files within directories specified by the PATH environment variable.

For example, BinaryProbe can be used to search for a protobuf compiler executable as follows:

 import qbs.File
 import qbs.Probes

 Module {
     // search for a protoc executable
     Probes.BinaryProbe {
         id: protocProbe
         names: "protoc"
     }
     property string executableFilePath: protocProbe.filePath

     validate: {
         if (!File.exists(executableFilePath))
             throw "The executable '" + executableFilePath + "' does not exist.";
     }

     // use the found executable
     Rule {
         // rule input/outputs here...

         // run executable
         prepare: {
             var args = // initialize arguments...
             var cmd = new Command(executableFilePath, args);
             cmd.highlight = "codegen";
             cmd.description = "generating protobuf files for " + input.fileName;
             return [cmd];
         }
     }
 }