본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

Delphi 폼에 진짜 터미널을 넣는 컴포넌트 — SCShell

Delphi 프로그램 안에 cmd, PowerShell, WSL 같은 셸을 띄우는 Windows 터미널 컴포넌트입니다. ConPTY와 alacritty_terminal을 쓴 Rust DLL에 VCL 컨트롤을 씌웠습니다.

풀빛컴퓨팅3분 읽기#오픈소스#Delphi#Rust#터미널

관리 도구나 개발 도구를 Delphi로 만들다 보면 프로그램 안에 명령 창을 하나 넣고 싶어집니다. 별도 콘솔 창을 띄우면 화면이 따로 놀고, 출력만 받아 메모에 붙이면 색상이나 커서 이동 같은 터미널 동작이 깨집니다.

SCShell은 폼에 올려놓는 터미널 컴포넌트입니다. Rust로 만든 DLL이 ConPTY로 실제 셸(cmd, PowerShell, pwsh, WSL 등)을 실행하고, 터미널 처리는 Alacritty 터미널의 alacritty_terminal에 맡깁니다. Delphi 쪽에서는 TWinControl을 상속한 TSCRataShell을 폼에 놓고 씁니다.

SCShell 실행 화면

무엇을 하나

항목 내용
셸 실행 Windows 10 1903 이상의 CreatePseudoConsole(ConPTY)
터미널 처리 alt screen, 스크롤백, 24비트 색상, 커서 저장·복원, 스크롤 영역, bracketed paste 등
한글 IME 조합 창 위치 맞춤, 셀 단위 글꼴 매칭, 자모 분리·조합 취소
VCL 표준 동작 Align, Anchors, Font, TabOrder
자식 프로세스 정리 Job Object의 KILL_ON_JOB_CLOSE로 호스트가 끝나면 셸도 함께 정리
배포 CRT를 정적으로 링크해 DLL 하나만 배포. 32비트·64비트 모두 sc_shell.dll

Rust 쪽에서 panic이 나도 catch_unwind로 FFI 경계에서 막아 Delphi 프로그램까지 번지지 않게 했습니다.

써 보기

uses
  SCShell.Ctrl;

procedure TFormMain.FormCreate(Sender: TObject);
begin
  FShell := TSCRataShell.Create(Self);
  FShell.Parent := Self;
  FShell.Align := alClient;
  FShell.ShellPath := 'C:\Windows\System32\cmd.exe';
  FShell.OnExit := HandleShellExit;
  FShell.Start;
end;

procedure TFormMain.HandleShellExit(Sender: TObject; AExitCode: Integer);
begin
  StatusBar.Caption := Format('Exited: %d', [AExitCode]);
end;

셸 경로와 인자, 작업 폴더, 환경 변수, 스크롤백 줄 수(기본 10000)를 속성으로 정합니다. Start, Stop, Restart, SendText로 셸을 다루고, OnExit, OnTitleChange, OnBell 이벤트를 받습니다.

samples\ 폴더에는 단계별 예제 네 개가 있습니다.

예제 내용
01_minimal 폼 하나에 셸 하나를 채운 최소 예제
02_menu_driven 셸 종류 전환, 복사·붙여넣기, 찾기, VI 모드, 상태 표시줄까지 메뉴로 부르는 예제
03_tabs 탭마다 셸을 하나씩 여는 멀티 탭 터미널
04_scripted 호스트 프로그램이 SendText로 셸에 명령을 보내 자동으로 실행하는 예제

예제에서는 터미널 단축키가 그대로 동작합니다. Ctrl+Shift+C/V로 복사·붙여넣기, Ctrl+Shift+F로 찾기, Ctrl+Shift+Space로 VI 모드를 켜고, Alt+드래그로 사각 영역을 선택합니다.

빌드

Rust 1.80 이상과 Delphi 13(Studio 37.0)이 필요합니다.

# 전체 빌드 (Rust DLL 32+64 + Delphi 데모)
.\tools\build.ps1 -All

# Rust DLL만 (32+64)
.\tools\build.ps1 -Rust

# Delphi 데모만
.\tools\build.ps1 -Delphi

결과물은 bin/sc_shell.dll(64비트), bin/win32/sc_shell.dll(32비트), bin/DemoShell.exe입니다.

어떻게 만들었나

Delphi 쪽은 DLL을 동적으로 불러 C ABI로 부르는 바인딩(SCShell.pas), GDI 페인터(SCShell.Painter.pas), 컴포넌트(SCShell.Ctrl.pas)로 나뉩니다. Rust DLL은 ConPTY와 Job Object(pty/), 읽기·쓰기 스레드(io.rs), alacritty 터미널 래퍼(term.rs), 셀 그리드 스냅샷과 변경분 계산(render/), Win32 가상 키를 VT 시퀀스로 바꾸는 keymap.rs로 나뉩니다. 설계 문서는 docs/design/에 정리해 두었습니다.

알아 둘 점

  • Windows 10 1903 이상에서 동작합니다.
  • 라이선스는 MIT이고, alacritty_terminal(MIT) 같은 의존 라이브러리의 라이선스를 따릅니다.

소스와 데모 스크린샷은 GitHub 저장소에 있습니다.

함께 읽으면 좋은 글