CocoQML 参考

cocoqmlscanner

语法

cocoqmlscanner [<选项>] <路径>...

选项

• <路径>：是要仪器化或恢复的文件和目录的空格分隔路径。

  操作取决于是否设置了选项 -r。

  如果没有设置 -r，则递归地扫描 <路径>，并读取并仪器化以 .qml 或 .js 结尾的每个文件。保留每个文件的备份副本；它分别具有后缀 .qmlbak 或 .jsbak。如果已有备份副本，则不执行任何操作，并带有错误返回。

  如果设置了 -r，则将所有备份文件重命名回其旧名称，以替换仪器化文件。如果没有备份副本，则程序不执行任何操作，并带有错误返回。

• -r | --restore：启用恢复模式。
• -c | --csmes-name=<filename>：将生成的 .csmes 文件保存为 <filename>。如果不已存在，则附加后缀 .csmes。

  没有此选项，生成的数据将保存为 cocoqmlscanner_result.csmes。

• -b | --blacklist-regex=<filename> | --blacklist=<filename>：从仪器化中排除某些路径。该文件是包含每行的正则表达式的文本文件的路径。如果其中一个正则表达式与文件名匹配，则文件将被排除在仪器化之外。

  以 # 开头的行将被忽略。

• -B | --blacklist-wildcard=<filename>：从仪器化中排除某些路径。该文件是包含每行的通配符表达式的文本文件的路径。如果其中一个通配符表达式与文件名匹配，则文件将被排除在仪器化之外。

  以 # 开头的行将被忽略。

• -l | --logfile=<logfile>：如果设置了此变量，则 cocoqmlscanner 将其日志消息写入指定的日志文件。
• --quiet：禁用 cocoqmlscanner 生成 的所有消息。此设置覆盖详细模式。
• --verbose：启用详细模式。此设置可以被安静模式覆盖。
• -v | --version：打印程序版本号并结束。
• -h | --help：打印帮助信息并结束。

跟踪插件

跟踪插件以源代码形式提供，因为它编译时必须与 QML 应用程序的 Qt 版本相同。

以下变量控制由跟踪器生成的各种调试输出。所有日志消息都以 CocoQML: 为前缀。

• COCOQML_OUTPUT：设置此变量以确定输出 .csexe 文件的目录和/或基本名称。COCOQML_OUTPUT 的值必须是现有目录的相对或绝对路径，基本名称或两者组合。如果只给出目录，则在具有默认基本名称的目录中创建 .csexe 文件。如果给出了基本名称，则输出文件将为 <base name>.csexe。默认基本名称通常是 <application name>_qml。

  例如，您可以设置 COCOQML_OUTPUT=/home/user/my_run，跟踪插件将输出写入 /home/user/my_run.csexe。

  如果此变量未设置或为空，则会在当前工作目录中创建一个文件 <application name>_qml.csexe。

• COCOQML_QUIET：设置此变量为 1 以禁用插件生成的所有消息。通常，所有消息都会打印到标准错误，但如果您依赖于在您的应用程序中解析标准错误，则可以使用此来避免干扰。

  此设置覆盖详细模式，见下文。

• COCOQML_VERBOSE：设置此变量为 1 以启用详细模式。如果详细模式激活，CocoQML 扩展将打印可能有助于调试目的的附加消息。通常，您无需启用详细模式。

  此设置可由静默模式覆盖，见上文。

• COCOQML_LOGFILE：设置此变量将 CocoQML 插件日志消息写入文件。 COCOQML_LOGFILE 的值必须是绝对或相对文件路径。相对文件路径在应用程序启动时相对于应用程序的工作目录进行解释。如果日志文件已存在，则新数据将附加到它。如果路径包含目录，则它们必须已存在，否则不会创建日志文件。

  例如，在 Unix 下，您可以设置 COCOQML_LOGFILE=/tmp/cocoqml.log。由于 /tmp/ 目录在任意正常的 Unix 安装中都存在且可写，因此所有日志消息随后都写入 /tmp/cocoqml.log 文件。