安装

入门

本章描述了在您的机器上安装和设置 Coco 的步骤。

如果您已购买 Coco 浮动许可证，这些许可证由一个共同的 许可证服务器 管理。

Coco 许可证服务器只需安装一次。安装并设置后，您可以在 Coco 安装期间使用许可证服务器的 IP 地址和端口号，而不是许可证密钥。

选择许可证

有两种许可证类型：节点许可证和浮动许可证。

节点许可证 与特定机器和特定用户账户绑定。在此账户下，您可以运行尽可能多的 Coco 进程。请注意，如果您从持续集成服务器运行 Coco，服务器有单独的账户，因此 Coco 需要额外的节点许可证。

浮动许可证 与进程相关联，而不是与计算机相关联。需要尽可能多的浮动许可证，因为同时运行的 Coco 进程数量。Coco 进程可以是：

1. CoverageScanner 或编译器包装程序的一个实例
2. CoverageBrowser 的一个实例
3. 命令行工具（cmmerge、cmcsexeimport 和 cmreport）的每个实例

由于需要一 CoverageScanner 实例的运行，因此 Coco 对每个经过仪器化的编译器调用都单独计数。但是，具有并行编译的构建不应用真正的麻烦，因为无法获得许可证的进程将等待一个被释放。

浮动许可证由许可证服务器管理。服务器必须在可以从Coco运行的机器上访问的网络可达的机器上运行。Qt将为您提供一份许可证文件，该文件确定了可以同时激活的最大Coco进程数。许可证服务器本身不计入需要许可证的进程。

Coco 安装

您可以从Qt账户下载区域下载Coco安装程序https://account.qt.io/s/downloads。

Coco支持的各种平台的安装程序具有共同的命名方案，但它们的执行方式不同。命名方案是SquishCocoSetup_<x.y.z><platform>.<suffix>，其中<x.y.z>是程序版本，<platform>描述了操作系统和其他安装细节，而<suffix>是一个与操作系统相关的后缀。在非商业版本中，将SquishCoco替换为SquishCocoNoncommercial。

• Microsoft^® Windows：安装程序是文件SquishCocoSetup_<x.y.z>_Windows_x86.exe或SquishCocoSetup_<x.y.z>_Windows_x64.exe，必须执行。
• Linux™：安装程序是文件SquishCocoSetup_<x.y.z>_<platform>.run，必须使用bash执行，例如

  $ bash SquishCocoSetup_3.3.2_Linux_x86_64.run

  请注意，安装程序的CentOS版本也适用于RedHat Linux™。

• macOS：安装包是SquishCocoSetup_x.y.z_<platform>.pkg格式的文件。单击它，将启动安装程序。

如果账户中没有有效的许可证，则安装程序将在安装结束时运行许可证向导来配置许可证。

安装许可证服务器

如果您选择了浮动许可证，您需要在您的本地网络上选择一个运行许可证服务器程序的机器。

许可证服务器需要配置文件才能运行。它指定了提供的许可证数量、运行其上的机器以及服务器使用的端口。要获取配置文件，必须首先安装Coco。

在许可证服务器机器上安装Coco。安装后，将启动cocolicwizard。忽略它。相反，从命令行外壳中运行命令cocolicserver --server-identifier。

• Microsoft^® Windows：在命令窗口中，切换到项目文件夹，并输入

  %SQUISHCOCO%\cocolicserver.exe --server-identifier

• Linux™：打开命令外壳，并输入

  $ /opt/SquishCoco/bin/cocolicserver --server-identifier

• macOS：打开命令外壳，并输入

  $ /Applications/SquishCoco/cocolicserver --server-identifier

该程序将输出一个类似于这样但更长的机器ID

SUQ9YTNmZjk3MDBhMjAwNTU3ZjUzMDFiZTAwClVTU=

将其复制到您的剪贴板。这将允许您激活您的浮动许可证并获得运行许可证服务器的配置文件。

在https://account.qt.io/s/my-licenses上查找您的Coco订阅。选择它，然后转到许可证详情。在右侧，您将找到一个许可证自助激活窗口。将之前步骤中获得的机器ID粘贴此处。

在这里还可以指定许可证服务器的侦听端口。默认为49344。在不太可能的情况下，此端口号已被占用，您可以在此处指定不同的端口号。

输入值后，单击激活。将激活按钮变为下载按钮。单击下载Coco浮动许可证文件。

运行许可证服务器

配置文件通常称为 cocoserver.cfg。有了它，许可证服务器就可以运行。在最简单的情况下，编写如下

$ /opt/SquishCoco/bin/cocolicserver -c /path/to/cocoserver.cfg

服务器随后向同一网络中的其他计算机提供许可证。现在，主机的IP地址和服务器监听端口号可以作为 host:port 提供给Coco安装程序或Coco许可证向导。

有关 cocolicserver 的其他选项，请参阅 cocolicserver - 许可证服务器。

更新

可以使用 cocolic 或 cocolicwizard 指定新许可证或许可证服务器。

要更新到Coco的新版本，请下载并安装它。然后它将覆盖之前的版本。许可证不会受到影响，您可以继续使用。

如果安装了新的编译器，则应再次运行Coco安装程序，以便Coco了解新的编译器。这包括Microsoft^® Visual Studio^®的新版本。如果在Coco安装过程中存在Visual Studio 2013，并且添加了Visual Studio 2015，则需要运行Coco安装程序。

如果更新了编译器，则Coco应该基本上无需更改即可运行。