이 페이지에서

개발 컨테이너 사용

개발 컨테이너(개발 컨테이너)를 사용하여 개발자 및 자동화된 빌드 또는 테스트 시스템 전반에서 프로젝트의 일관된 개발 환경을 정의하고 구성할 수 있습니다.

애플리케이션을 실행하거나 코드베이스로 작업할 때 필요한 도구, 라이브러리 또는 런타임을 분리하거나 지속적인 통합 및 테스트를 위해 로컬 또는 클라우드에서 원격으로 개발 컨테이너를 실행할 수 있습니다.

개발 컨테이너 환경에는 일반적으로 최종 배포에는 필요하지 않은 개발 중에 필요한 도구와 유틸리티가 포함되므로 배포 환경과 다를 수 있습니다.

전체 사양 및 devcontainer.json 파일 형식은 개발 컨테이너 설명서를 참조하세요.

참고: 개발 컨테이너를 사용하려면 개발 컨테이너 지원 플러그인을 활성화하세요.

개발 컨테이너 구성

Qt Creator 에 대한 개발 컨테이너를 구성하려면 다음과 같이 하세요:

  1. 프로젝트 디렉토리에 devcontainer.json 파일을 만듭니다.
  2. devcontainer.json 파일의 customizations 아래에 qt-creator 섹션을 추가합니다.
  3. 이 항목에 설명된 사용자 지정 옵션을 사용하여 개발 컨테이너를 사용자 지정합니다.

개발 컨테이너의 사용자 지정 옵션

다음 표는 devcontainer.json 파일에서 Qt Creator 사용자 지정에 사용할 수 있는 옵션을 보여줍니다.

속성유형설명
auto-detect-kitsbooleantrue 로 설정하면 개발 컨테이너에서 키트를 자동으로 감지하려고 시도합니다.
run-processes-in-terminalboolean터미널 창에서 일부 개발 컨테이너 설정 프로세스를 실행하려면 true 로 설정합니다. 현재 docker build 에만 사용됩니다.
copy-cmd-bridgeboolean원격 장치와의 통신을 위한 서비스인 Command Bridge Helper를 마운트하지 않고 개발 컨테이너에 복사하려면 true 로 설정합니다. 개발 컨테이너가 호스트 파일 시스템을 마운트할 수 없는 경우에 유용합니다.
mount-libexecbooleanlibexec 디렉터리를 개발 컨테이너에 마운트하려면 true 로 설정합니다. 명령 브리지 도우미에 사용됩니다.
libexec-mount-pointstring개발 컨테이너의 libexec 디렉터리에 대한 마운트 지점을 지정합니다. 명령 브리지 도우미에 사용됩니다.
kits객체 배열개발 컨테이너에서 사용할 사용자 지정 키트를 지정합니다.

일반적인 로컬 개발을 위한 구성

다음 예제 devcontainer.json 파일은 일반적인 로컬 개발 워크플로우에 맞게 개발 컨테이너를 구성하는 방법을 보여줍니다. 이 파일은 키트를 자동으로 감지하고 libexec 디렉터리를 컨테이너에 마운트하며 마운트 지점을 지정합니다.

이 설정은 Qt Creator 에서 사용 가능한 빌드 키트를 자동으로 찾고 libexec 디렉터리의 필수 헬퍼 도구에 컨테이너 내부에서 액세스할 수 있도록 하려는 경우에 유용합니다.

{
    "customizations": {
        "qt-creator": {
            "device": {
                "auto-detect-kits": true,
                "run-processes-in-terminal": false,
                "copy-cmd-bridge": false,
                "mount-libexec": true,
                "libexec-mount-point": "/devcontainer/libexec"
            }
        }
    }
}

사용자 지정 키트 및 도구 체인 구성

다음 예제 devcontainer.json 파일은 컨테이너 내에서 특정 Qt 버전, 컴파일러 또는 툴체인을 사용해야 할 때 개발 컨테이너를 구성하는 방법을 보여줍니다. 이는 교차 컴파일, 여러 빌드 구성 지원 또는 팀 간에 일관된 개발 환경을 보장하는 데 유용합니다.

이 구성 파일은 자동 키트 감지를 비활성화하고 대신 kits 속성을 사용하여 사용자 지정 키트를 정의합니다. 이 키트는 개발 컨테이너 내에서 Qt Creator 에서 사용할 Qt 버전, 컴파일러 경로, CMake 바이너리 및 생성기, 디버거를 지정합니다.

{
    "customizations": {
        "qt-creator": {
            "auto-detect-kits": false,
            "kits": [
                {
                    "name": "My DevContainer Kit",
                    "qt": "/6.7.0/gcc_64/bin/qmake6",
                    "compiler": {
                        "Cxx": "/usr/bin/c++",
                        "C": "/usr/bin/gcc"
                    },
                    "cmake": {
                        "binary": "/usr/bin/cmake",
                        "generator": "Unix Makefiles"
                    },
                    "debugger": "/usr/bin/lldb"
                }
            ]
        }
    }
}

플러그인 활성화 및 비활성화방법도참조하세요 : 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.