콘텐츠로 이동
Hagicode Docs
블로그

데스크탑 노드 환경

페이지 편집

HagiCode Desktop은 데스크탑 관리 노드 툴체인과 함께 제공됩니다. 컴퓨터의 전역 노드 설치를 인계받지 않습니다. 그 목적은 데스크탑 시작 및 런타임 관련 흐름에 안정적이고 검증 가능한 런타임 기반을 제공하는 것입니다.

이 FAQ를 읽으십시오. portable-fixed/toolchain 진단에서는 어떤 것이 무엇인지 알아야 합니다. node Desktop이 사용 중이거나 시스템 Node 버전이 Desktop 런타임 동작을 직접 정의하지 않는 이유가 궁금합니다.

데스크탑이 노드를 번들로 묶는 이유

섹션 제목: “데스크탑이 노드를 번들로 묶는 이유”

Desktop은 운영 체제, 설치 채널 및 사용자 환경 전반에 걸쳐 동일한 지원 흐름을 실행해야 합니다. 사용자의 기존 노드 설치에만 의존하는 경우 지원팀은 오래된 버전, 누락된 npm, 잘못된 경로 순서, 오염된 글로벌 패키지 및 조직별 레지스트리 정책을 모두 한 번에 처리해야 합니다.

Desktop에서는 이를 시스템 전체 환경을 재사용하는 대신 관리형 CLI를 위한 격리된 Node/npm 런타임으로 보다 구체적으로 설명합니다. 이 디자인에는 다음과 같은 주요 이점이 있습니다.

  • 일관된 버전: 데스크톱은 사용자의 로컬 주요 버전을 추측하는 대신 고정된 Node 22 런타임 계약을 사용합니다.
  • 제어된 시작 흐름: 데스크톱 관리 명령은 패키지된 명령을 선호할 수 있습니다. node 그리고 npm 항목.
  • 명확한 구성 경계: CLI 관련 구성은 호스트 전체 글로벌 구성과 별도로 유지되므로 업데이트, 전환 및 복구가 시스템 환경 차이로 인해 중단될 가능성이 적습니다.
  • 충돌 감소: 번들 경로는 Desktop에서 생성된 명령 환경에 적용되며 터미널에서 사용자의 전역 노드를 대체하지 않습니다.
  • 비침해적인 호스트 동작: 이러한 격리를 통해 사용자의 기존 Node/npm 환경에 도구 체인 상태가 기록되는 것을 방지하고 Desktop을 제거해도 시스템에 이미 존재하는 Node, npm 또는 구성이 방해받지 않습니다.

Desktop이 노드 경로를 선택하는 방법

섹션 제목: “Desktop이 노드 경로를 선택하는 방법”

Desktop을 정상적으로 실행하면 Desktop은 먼저 시스템에서 Node 설치를 읽는 대신 앱과 함께 설치된 Node 도구 체인을 선호합니다. 이렇게 하면 터미널의 Node 버전이 Desktop이 실행되는 동안 예상하는 Node 버전과 별도로 유지됩니다.

번들 도구 체인이 활성화되면 Desktop에서 생성된 명령 환경은 번들 도구 체인 경로를 도구 모음 앞에 배치합니다. PATH. 결과적으로 시스템에 다른 Node 버전이 설치되어 있어도 데스크톱 관리 흐름은 먼저 데스크톱의 번들 Node 및 npm으로 확인됩니다.

이는 Desktop에서 생성된 런타임 환경에만 영향을 미칩니다. 당신이 실행하는 경우 node, npm, 또는 시스템 터미널에서 직접 다른 명령을 실행해도 일반 시스템 환경과 셸 구성이 계속 사용됩니다.

Desktop에서 시작된 진단 또는 하위 프로세스 환경에서는 다음과 같은 변수가 표시될 수 있습니다.

Terminal window
HAGICODE_PORTABLE_TOOLCHAIN_ROOT=/path/to/portable-fixed/toolchain

이 변수는 데스크탑 관리 런타임 환경이 번들 도구 체인 루트를 인식했음을 의미합니다. 이 경로가 보인다고 해서 데스크탑이 시스템 노드를 변경했다는 의미는 아닙니다. 이는 데스크톱이 자체 런타임 범위 내에서 앱과 함께 제공되는 노드 환경을 사용하고 있음을 의미할 뿐입니다.

Desktop이 관리형 npm 패키지를 설치하는 위치

섹션 제목: “Desktop이 관리형 npm 패키지를 설치하는 위치”

Desktop은 런타임 파일과 변경 가능한 npm 패키지 파일을 다른 위치에 보관합니다. 다음과 같은 번들 툴체인 경로 portable-fixed/toolchain/node 데스크톱 관리의 변경 불가능한 소스입니다. node 그리고 npm 명령. 관리형 글로벌 패키지는 대신 Electron 사용자 데이터 디렉터리에 설치됩니다.

userData/node22/npmGlobal

Desktop이 나중에 Node 24로 이동하면 다음과 같은 별도의 패키지 트리를 사용합니다. userData/node24/npmGlobal. Node 22용으로 설치된 패키지는 디스크에 남아 있지만 새 Node-major 접두사에 다시 설치될 때까지 Node 24용으로 설치된 것으로 간주되지 않습니다.

데스크톱 종속성 상태는 활성 상태만 확인합니다. userData/node<major>/npmGlobal 접두사. 해당 접두사 외부의 패키지 파일은 종속성 관리에서 무시됩니다.