Skip to content

RmlUi 소스 구조 ​

packages/sfml.js-rmlui는 네이티브 바인딩, TypeScript 인터페이스와 테스트를 책임별로 배치합니다. 새 구현은 담당 모듈에 두고 관련 헤더와 구현 파일을 함께 둡니다.

디렉터리책임
runtime/초기화, Context, 런타임 상태, 기능 조회, 콜백 수명, Plugin, Debugger
dom/documents/문서, Factory, 속성 모음, XML 파싱
dom/elements/Element, 레이아웃, 스크롤, 요소 인스턴스화, SVG, Lottie
dom/controls/폼, 텍스트 컨트롤, 선택 항목, 패널
data/데이터 모델, 타입 등록, 주소, 멤버, 일괄 처리, 진단
events/이벤트, 리스너, 디스패치, 인스턴스화
style/properties/Property, 파서, 명세, 스타일시트
style/effects/데코레이터, 필터, 효과 값과 콜백
style/values/계산된 스타일, 스타일 구조체, 변환, 매핑된 뷰
animation/애니메이션, 전환, Tween, 값 콜백
rendering/렌더링 관리, 지오메트리, 텍스처, 레이어, 리소스, SFML 렌더러
fonts/폰트 로드, FreeType/HarfBuzz/비트맵 엔진, 측정, 글리프, 폰트 효과
scripting/스크립트 인터페이스, 호스트, 스크립트 객체
scripting/lua/Lua 호스트, 모델, 값, 함수, 인스턴스화
platform/SFML 시스템 연동, 입력, 텍스트 입력, 창 밀도
io/파일 인터페이스, 스트림
values/Variant, 수치 값, 문자열, URL, 공용 타입

이 디렉터리들은 native/와 src/ 아래에 있습니다. 한 계층에서만 필요한 구현은 해당 계층에 둡니다. src/internal/은 네이티브 로더, 래퍼 할당, 공유 메모리 변환 등 모듈 간 내부 프로토콜을 보관합니다.

src/index.ts는 npm 공개 진입점이고 native/addon.cc는 네이티브 모듈 등록 진입점입니다. 패키지 빌드 설정은 루트의 binding.gyp, package.json, tsconfig.json에 둡니다.

생성 파일은 src/generated/와 native/generated/에 있습니다. 생성 로직을 바꾸려면 tools/codegen/의 생성기를 수정한 뒤 다시 생성합니다.

도구 디렉터리책임
tools/build/패키지 네이티브 빌드, Lua C++ 컴파일, 컴파일 데이터베이스 수정. 저장소 LSP 데이터베이스 병합은 소속 Rush 작업 공간에서만 수행
tools/codegen/업스트림 헤더에서 입력, 이벤트, 속성 ID, 스타일 바인딩 생성
tools/dependencies/의존성 버전, 검증, 다운로드, 빌드 소스 목록
tools/dependencies/patches/RmlUi, Lua, Debugger, 수치, 문자열, rlottie 패치
tools/performance/성능 측정, 네이티브 호출 횟수
tools/testing/런타임 테스트 재귀 수집·실행, 클립보드 보존, npm 소스 패키지 파일 목록과 빌드 의존성 검증

test/는 런타임 및 타입 테스트를 모듈별로 배치합니다. test/native/는 C++ 대조 프로그램과 빌드 스크립트를 모듈별로 배치합니다. 스크립트는 현재 패키지의 기존 오브젝트 파일을 재사용하며, 호출자가 기존 임시 출력 디렉터리를 지정합니다.

packages/sfmljs-rmlui-vscode/tools/testing/는 기존 VS Code에서 확장 통합 검증을 실행합니다. 같은 패키지의 tools/packaging/는 VSIX에 포함된 클라이언트, 언어 서버, 언어 리소스와 네 언어 README를 검증합니다. 저장소 공용 Windows 도구 체인 초기화는 tools/ci/에 있으며 기존 Node.js CI와 전용 RmlUi CI가 공유합니다.

third_party/는 업스트림 디렉터리 구조를 유지합니다. build/와 dist/는 기존 빌드 디렉터리를 재사용합니다. 소스 이동 후에는 새 경로의 산출물이 있는 이전 산출물만 제거합니다.

디렉터리 이동은 RmlUi 6.3 전체 인수 완료를 뜻하지 않습니다. audit/6.3/의 기존 증거는 수집 당시 경로와 해시를 유지합니다. 이전 경로는 소스 이동 대응표에서 확인하세요.

Icons made by Lorc, Delapouite & Skoll game-icons.net · CC BY 3.0