本页内容

设置 Docker 设备的首选项

注意:需启用 Docker 插件才能使用该功能。

要设置 Docker 设备的首选项:

  1. 转至“Preferences ” > “Devices ” > “Devices ”。
  2. 在“Device ”中,选择一个 Docker 设备。

    “设备”首选项中的“设备”选项卡里的 Docker 设备

下表总结了您可以设置的偏好设置。

选项
Run as outside user在 Linux 和 macOS 上,设置在 Docker 容器中运行Qt Creator 的用户的用户 ID 和组 ID。此选项在 Windows 上不可用。
Do not modify entry point阻止Qt Creator 修改镜像的入口点。请确保镜像的入口点不会立即退出。
Enable flags needed for LLDB向容器添加以下标志,以允许 LLDB 运行:
--cap-add=SYS_PTRACE --security-opt seccomp=unconfined
Mount Command Bridge启用Qt Creator 与正在运行的容器之间的通信。默认情况下,Command Bridge 会挂载到容器中。如果您的 Docker 服务器无法访问Qt Creator 的安装目录,挂载可能会失败。在这种情况下,请关闭此选项以使用速度较慢的替代方案。
Network配置容器的网络设置。
Extra arguments启动容器时传递给 Docker CLI 的附加参数。
Container environment要在容器中设置的环境变量。
Paths to mount挂载到容器中的主机目录,例如项目目录。
Port mappings启动容器时要设置的主机到容器的端口映射。

您可以为 Docker 设备设置开发工具的路径。有关详细信息,请参阅“配置开发工具”

修改入口点

Docker 容器的入口点在容器设置中指定,并在启动容器时作为主进程运行。入口点可以是 shell、SSH 服务器或其他进程等。默认情况下,Qt Creator 会在启动容器之前修改入口点,以确保主进程为sh shell。

若要阻止Qt Creator 修改入口点,请选择Do not modify entry point 。但是,如果您指定的入口点不是 shell,Qt Creator 将无法启动该容器。

指定挂载路径

将项目文件复制到 Docker 容器中,或在“Paths to mount ”中指定这些文件的路径。共享挂载仅限于主机系统中那些在 Docker 容器内最终能映射到相同绝对路径的位置。在 Windows 系统上,网络挂载不能用作共享挂载。

Paths to mount 中的路径将与Docker容器进行一对一映射。选择“Insert ”可浏览要添加的目录。选择“Delete Line ”可删除所选路径,或选择“Clear ”删除所有路径。

自动检测套件项目

选择“Auto-detect Kit Items ”以查找套件项目并为 Docker 设备创建套件。您可以在设备的 PATH 中或指定目录中搜索套件项目。

在“Search locations ”中,请选择:

  • Search in PATH 在 PATH 中查找套件项目。
  • Search in Selected Directories 在所选目录中查找套件项目。
  • Search in PATH and Additional Directories 在 PATH 和所选目录中查找套件项目。

在目录中搜索时,请输入 Docker 镜像中用于扫描套件条目的目录路径列表,各路径之间用分号分隔。

要列出自动检测到的 kit 项目,请选择“List Auto-Detected Kit Items ”。要删除它们,请选择“Remove Auto-Detected Kit Items ”。

另请参阅 “启用和禁用插件”“如何:为 Docker 开发”“如何:管理套件”以及“为 Docker 开发”

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.