빌드 문서 개요

문서의 범위

이 섹션은 밥똥이리호요 런처 앱, Wine 런타임, DXMT 런타임을 직접 만들거나, 릴리즈 구조를 이해하려는 유지보수자를 위한 문서입니다. 런처를 설치해서 게임만 실행하려는 사용자는 이 섹션을 따라 빌드할 필요가 없습니다.

BDIH-Launcher

Electron, React, TypeScript 기반의 macOS 런처 앱을 빌드하고 패키징하는 저장소입니다.

wine-build

WineHQ 11.0, WineHQ 11.11, CrossOver 26.1.0 기반 Wine 런타임을 빌드하고 패키징하는 저장소입니다.

dxmt-er-build

DXMT v0.80에 이터널리턴 전용 그래픽 보정 패치를 적용해 런타임을 만드는 저장소입니다.

읽는 순서

1. 빌드 문서 개요에서 전체 구조와 원칙을 확인합니다.
2. BDIH Launcher 빌드에서 런처 앱의 로컬 빌드, 패키징, 테스트, 배포 정책을 확인합니다.
3. Wine 런타임 빌드에서 WineHQ와 CrossOver 계열 런타임을 어떻게 만드는지 확인합니다.
4. DXMT 빌드에서 이터널리턴용 DXMT 패치와 패키징 흐름을 확인합니다.
5. 릴리즈와 메타데이터에서 런처가 읽는 manifest, artifact 구조, 라이선스 기준을 확인합니다.

기준 저장소

빌드 명령과 패치 적용 순서는 각 저장소의 스크립트가 기준입니다. 문서가 스크립트와 다르게 보이면 스크립트를 먼저 확인해야 합니다.

• Wine 런타임: Bob-Ddong-Iri-Hoyo/wine-build
• DXMT 런타임: Bob-Ddong-Iri-Hoyo/dxmt-er-build
• 런처 앱: Bob-Ddong-Iri-Hoyo/BDIH-Launcher

주의

이 문서의 명령은 각 저장소의 루트에서 실행하는 것을 기준으로 합니다. 이 사이트 저장소에서 그대로 실행하는 명령이 아닙니다.

빌드 원칙

소스 변경은 추적 가능한 patch set과 스크립트에 남겨야 합니다. artifacts/ 아래의 임시 결과물이나 실험용 로그는 릴리즈 기준이 아닙니다.

DXMT는 기본적으로 Wine 패키지에 포함하지 않고 외부 런타임으로 관리합니다. 이렇게 하면 Wine을 다시 빌드하지 않고도 DXMT 런타임만 교체하거나 롤백할 수 있습니다.

릴리즈 빌드에는 임시 진단용 카운터, 추적 코드, 로컬 실험 패치를 남기지 않는 것을 원칙으로 합니다. 성능을 비교할 때 사용하는 debug build와 사용자에게 배포하는 release build는 분리해서 다루어야 합니다.

현재 기준

구성 요소	기준
런처 앱	Electron 41, React 19, TypeScript 6, Webpack 5
WineHQ 현재 계열	wine-winehq-11.11
WineHQ 비교/호환 계열	wine-winehq-11
CrossOver 계열	wine-crossover-26.1.0
DXMT	v0.80
이터널리턴용 DXMT 패치	sanitizeOutput 전용 패치

WineHQ 11.11은 현재 WineHQ 계열의 기준 빌드입니다. WineHQ 11.0은 비교와 호환성을 위한 fallback 라인입니다. CrossOver 26.1.0은 이터널리턴 검증을 중심으로 다루는 별도 계열입니다.

빌드 실패를 볼 때

빌드가 실패하면 먼저 다음 항목을 확인합니다.

• 실행한 명령이 대상 저장소의 루트에서 실행되었는지 확인합니다.
• Wine 버전, DXMT 태그, patch set, toolchain 버전이 문서의 기준과 맞는지 확인합니다.
• clean.sh로 같은 patch set이 깨끗하게 다시 적용되는지 확인합니다.
• 이미 만들어진 prefix나 오래된 DLL이 새 런타임과 섞여 있지 않은지 확인합니다.

호환 계층 프로젝트는 의존성 버전과 로컬 prefix 상태의 영향을 크게 받습니다. 작은 버전 차이나 오래된 prefix-local DLL도 빌드 성공 이후의 런타임 문제로 이어질 수 있습니다.