二进制探针

定位项目外的可执行文件。更多信息...

继承

PathProbe

所有成员的列表，包括继承的成员
二进制探针是所有项的列表的一部分。

详细信息

查找具有指定文件名的可执行文件。

二进制探针在由 PATH 环境变量指定的目录中搜索可执行文件。

注意：在 Unix 上，默认情况下还会在 /usr/bin 和 /usr/local/bin 目录中搜索。要更改此行为，请覆盖 PathProbe.platformSearchPaths。

注意：在 Windows 上，只有具有 .com、.exe、.bat、.cmd 扩展名的文件被视为 可执行文件。要更改此行为，请覆盖 PathProbe.nameSuffixes。

例如，可以使用二进制探针如下搜索 protobuf 编译器的可执行文件：

// Assuming module is called "myproto"
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 for the module called "myproto":
        prepare: {
            var args = // initialize arguments...
            var cmd = new Command(input.myproto.executableFilePath, args);
            cmd.highlight = "codegen";
            cmd.description = "generating protobuf files for " + input.fileName;
            return [cmd];
        }
    }
}