文件系统与注册表

本章介绍了 Coco 使用文件系统存储永久设置的用法。

已安装文件的位置

已安装文件的位置根据平台而有所不同。

Microsoft Windows

程序的安装位置可以在安装时选择。安装程序创建环境变量 SQUISHCOCO，其中包含安装目录的路径。默认情况下，它为 C:\Program Files\squishcoco 或 C:\Program Files (x86)\squishcoco，具体取决于平台。在本文档中，我们使用表达式 <Windows Coco> 来引用它。

该目录包含以下文件和目录

• 标准的 Coco 可执行文件，如 CoverageBrowser、cmcsexeimport 等。
• 文档。
• 包装程序的前缀版本及其配置文件。编译器包装程序的前缀版本是一个以 cs 开头的文件，如 cscl.exe，它是 cl.exe 的包装程序。该程序的配置文件是 cl.cspro。
• 包含编译器包装程序特定版本的目录。

  例如，包含 Microsoft® Visual Studio® 包装程序的目录 visualstudio 和 visualstudio_x64，这些目录通常包含没有 cs 前缀的编译器包装程序：例如，在目录 visualstudio 中有一个程序 cl.exe，它包装了 Visual Studio 的程序 cl.exe。

• 包含教程和示例程序的目录，如 parser、textedit 和 tutorial。

Linux

可以在安装时选择安装位置。默认值为 /opt/SquishCoco/。该目录包含以下子目录

• bin/, lib/：Coco 可执行文件，包括编译器包装程序的前缀版本及其配置文件。
• wrapper/bin/：没有 cs 前缀的编译器包装程序。
• doc/：文档文件。
• samples/：教程的示例程序和文件。

macOS

程序安装于/Applications/SquishCoco。

此目录包含Coco的二进制文件，包括带有前缀的编译器封装程序及其配置文件。还包含文档。它有以下子目录

• wrapper/：没有cs前缀的封装程序文件。
• samples/：教程的示例程序和文件。

许可证的位置

Coco的专业版和非商业版使用不同的命名方案来定位包含许可证信息的文件和注册表键。以下描述主要针对专业版，括号中列出非商业版中变换的值。

节点锁定许可证

在搜索许可证时，Coco首先尝试找到节点锁定许可证。

1. 如果设置了环境变量SQUISHCOCO_LICENSEKEY_DIR，Coco将其内容视为目录名，并尝试在此处查找许可证文件。许可证文件名为.squishcoco-3-license。
2. 然后，它在下面描述的用户主目录中搜索许可证文件。
3. 如果Coco在Windows下运行，它将改为在注册表中的HKEY_CURRENT_USER\Software\squishcoco\LicenseKey下搜索。

可能存在许可证，但它已被停用。如果Coco找到了此类许可证，它将停止寻找其他节点锁定许可证，并尝试找到许可证服务器。

许可证服务器的地址

如果没有找到节点锁定许可证，Coco将尝试找到许可证服务器的位置。

1. 首先，如果存在并且值不为空字符串，它尝试从环境变量SQUISHCOCO_LICENSE_SERVER读取许可证服务器的说明。
2. 如果Coco在Windows下运行，它将在注册表中的HKEY_CURRENT_USER\Software\squishcoco\LicenseServer下搜索说明。
3. 然后，它尝试从位于用户主目录下的文件.squishcoco-3-licserver中读取说明（见下文）。
4. 然后，它尝试从Unix上的系统文件/etc/squishcoco-3-licserver或Windows上的%windir%\system32\drivers\etc\squishcoco-3-licserver中读取说明。

许可证服务器的说明包含一个主机名或IP地址，可能后跟一个冒号和一个端口号：myserver.com:49344。

用户主目录

在搜索用户主目录时，Coco评估以下环境变量，并取第一个已设置的变量。

1. HOMEPATH变量的内容。
2. 在Windows下，如果设置了HOMEPATH，则
   • 如果设置了HOMEDRIVE，则HOMEDRIVE + HOMEPATH的值。
   • 否则，HOMEPATH的内容。
3. HOME的内容。
4. 在Windows下，USERPROFILE的内容。

临时文件的位置

在编译过程中，CoverageScanner会创建一些临时文件，它们通常会在使用后自动删除。

默认情况下，临时文件将创建在系统临时文件目录中。这通常是 UNIX® 系统上的 /tmp，以及 Windows 上由环境变量 %TEMP% 指定的目录。可以通过将环境变量 SQUISHCOCO_TEMP_DIR 设置为其他目录的路径来更改此位置。在文件写入时，此目录必须已经存在，它不会自动创建。

可以使用命令行选项 --cs-keep-instrumentation-files 关闭临时文件的自动删除（见调试）。

程序设置的位置

如果程序有其他必须存储在文件中的永久设置，该文件位于以下目录

• Windows 上：%APPDATA%\ squishcoco
• Linux 上：$HOME/.config/squishcoco

安装日志文件的存储位置

Windows 安装程序在 %TEMP%\SquishCoco_logfile\vsaddin.log 生成日志文件。在安装问题时可以参考。