Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/INTENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -347,7 +347,7 @@ macOS 26과 iOS 26은 같은 재질을 쓰지만 같은 방식으로 쓰지 않

### D18. Windows 렌더러는 Kotlin/Native로 만들고, MinGW는 Kotlin 오브젝트 안에 가둔다

> **현황(2026-10-17).** develop의 Windows 렌더러는 아직 GraalVM native-image입니다. Kotlin/Native 렌더러는 초안 PR #119(`feature/windows-kotlin-native`)와 그 위의 초안 PR #174에 있고 병합되지 않았습니다(이슈 #24, SPEC NFR-13).
> **현황(2026-10-26).** Kotlin/Native 렌더러는 PR #119(`feature/windows-kotlin-native`)와 그 위의 PR #174로 2026-10-24에 develop에 병합됐습니다(이슈 #24, SPEC NFR-13). 2026-10-26 소유자 결정: compose-rust가 Windows에 내는 렌더러는 이 정적 렌더러뿐이고 GraalVM은 배포에서 빠집니다(SPEC §5.6). GraalVM 단일 바이너리는 확장 플러그인 포크의 몫이고, "graal, kn 둘 다 돌아야 한다"는 조건도 그쪽 요구입니다. 기각한 것: compose-rust가 GraalVM 경로도 단일 실행 파일로 내는 안.

**소유자의 결정입니다(2026-10-03). 실험이 아니라 정식 통합입니다.**

Expand Down
16 changes: 10 additions & 6 deletions docs/SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -3730,10 +3730,10 @@ pr6 forwarder cost: 12.15 ns/call across the boundary, 0.44 ns/call in this modu
| NFR-10 | 렌더러 탐색 경로 | `COMPOSE_RUST_RENDERER_DIR` → 워크스페이스 빌드 결과물 → 버전·타깃별 캐시 → 릴리스 다운로드 순서로 찾음. 규격과 수용 기준은 §5.3. **2026-09-21 충족** | Done |
| NFR-11 | 배포 | 크레이트는 crates.io, 렌더러는 플랫폼별 체크섬 릴리스 아티팩트. 설치는 `Cargo.toml` 한 줄이 전부이고 빌드 스크립트가 아티팩트를 가져옵니다. 규격과 수용 기준은 §5.3 (INTENT D10). **2026-09-21 macOS에서 충족**, Linux는 "Native renderer test" 실행 38823417678의 "One executable on linux-x64"와 "One executable on linux-arm64" 잡이 릴리스 모양의 타르볼로 소비자 크레이트를 빌드해 실행하는 것까지 확인했습니다. Windows는 실행 확인 미완료 | Agreed |
| NFR-12 | 워크트리 빌드 격리 | 워크트리마다 자기 `target/`에 빌드하고, 다른 워크트리의 빌드 디렉터리를 가리키는 설정이 없음. 한 트리에서 컴파일된 codegen 바이너리가 다른 트리에 쓸 수 없음. 규격과 수용 기준은 §5.4 (INTENT D16). **2026-09-22 충족** | Done |
| NFR-13 | Windows 단일 실행 파일 | Windows 렌더러를 Kotlin/Native로 빌드해 앱 실행 파일 하나에 링크함. JVM이 없고, 앱을 빌드하는 사람에게 MinGW를 요구하지 않음. 규격과 수용 기준은 §5.6 (INTENT D18, 2026-10-03 소유자 결정) | Agreed, 진행 중: 초안 PR #119(`feature/windows-kotlin-native`)와 그 위의 초안 PR #174, 이슈 #24. 둘 다 develop에 병합되지 않았습니다 |
| NFR-14 | AWT 없는 데스크톱 렌더러가 기본 | 배포되는 데스크톱 렌더러가 AWT도 JVM도 쓰지 않음. macOS와 Linux는 Kotlin/Native 정적 라이브러리, Windows는 NFR-13. 앱이 아무것도 고르지 않아도 이 경로가 나옴. 규격과 수용 기준은 §5.5 (INTENT D4, 2026-10-03 소유자 결정) | Agreed, 진행 중: macOS와 Linux의 기본값은 PR #113(3be2ec74, 2026-10-04 병합)으로 Kotlin/Native 정적 렌더러이고 이슈 #22는 닫혔습니다. Windows는 PR #119, #174가 병합되기 전까지 GraalVM native-image AWT 경로로 남습니다. compose-rust가 내는 길은 Kotlin/Native뿐이라는 것이 소유자의 말입니다(2026-10-17) |
| NFR-13 | Windows 단일 실행 파일 | Windows 렌더러를 Kotlin/Native로 빌드해 앱 실행 파일 하나에 링크함. JVM이 없고, 앱을 빌드하는 사람에게 MinGW를 요구하지 않음. 규격과 수용 기준은 §5.6 (INTENT D18, 2026-10-03 소유자 결정) | Agreed, 진행 중: PR #119(`feature/windows-kotlin-native`)와 그 위의 PR #174가 2026-10-24에 develop에 병합됐습니다. 이슈 #24는 열려 있습니다. Windows는 이 정적 렌더러 하나만 배포합니다(§5.6) |
| NFR-14 | AWT 없는 데스크톱 렌더러가 기본 | 배포되는 데스크톱 렌더러가 AWT도 JVM도 쓰지 않음. macOS와 Linux는 Kotlin/Native 정적 라이브러리, Windows는 NFR-13. 앱이 아무것도 고르지 않아도 이 경로가 나옴. 규격과 수용 기준은 §5.5 (INTENT D4, 2026-10-03 소유자 결정) | Agreed, 진행 중: macOS와 Linux의 기본값은 PR #113(3be2ec74, 2026-10-04 병합)으로 Kotlin/Native 정적 렌더러이고 이슈 #22는 닫혔습니다. Windows의 PR #119, #174는 2026-10-24에 병합됐고, Windows 배포는 Kotlin/Native 정적 렌더러뿐입니다(§5.6). compose-rust가 내는 길은 Kotlin/Native뿐이라는 것이 소유자의 말입니다(2026-10-17) |
| NFR-15 | 데스크톱 애플리케이션은 실행 파일 하나 | compose-rust 애플리케이션이 macOS, Windows, Linux에서 실행 파일 하나이고, 시스템 라이브러리 외에 아무것도 불러오지 않음. 렌더러, Skia, ICU 데이터가 안에 있음. 1.0.0 요구사항. 규격과 수용 기준은 §5.7 (INTENT D17, 2026-10-03 소유자 결정) | Agreed |
| NFR-16 | 렌더러를 스키마 해시로 찾음 | 같은 크레이트 버전에서 스키마가 다른 git 리비전도 빌드됨. 버전 릴리스의 스키마 해시가 크레이트와 다르면 스키마 해시로 게시된 렌더러에서 찾고, 캐시 키는 스키마 해시임. 규격과 수용 기준은 §5.3.8 | Draft |
| NFR-16 | 렌더러를 스키마 해시로 찾음 | 같은 크레이트 버전에서 스키마가 다른 git 리비전도 빌드됨. 버전 릴리스의 스키마 해시가 크레이트와 다르면 스키마 해시로 게시된 렌더러에서 찾고, 캐시 키는 스키마 해시임. 규격과 수용 기준은 §5.3.8 (소유자 결정, 2026-10-26) | Agreed |

### 5.1 프레임 예산 (NFR-9)

Expand Down Expand Up @@ -3933,14 +3933,15 @@ Windows와 Linux는 이 저장소에 실행할 기계가 없어 자동 테스트

**배경.** 크레이트 버전은 릴리스 사이에서 같은 채로 스키마가 바뀝니다. 릴리스 뒤의 git 리비전을 고정한 소비자(예: dioxus-compose의 `d820585`, 크레이트 0.0.2, 스키마 `0x2106ffd038ad189b`)가 버전만으로 렌더러를 고르면 v0.0.2 렌더러(스키마 `0x284215b3caced78f`)를 받아 `check_schema_agreement`에서 죽습니다. 맞는 렌더러가 어디에도 없으므로 소비자가 빌드할 방법이 없습니다(#293).

**정한 것 (초안).**
**정한 것 (Agreed, 소유자 결정 2026-10-26).**

1. **해시 표기.** `{hash}`는 `compose-rust/schema-hash.txt`의 값에서 `0x`를 떼고 소문자 16진수 16자리로 씁니다(예: `62b9a55ed371acad`). 접두사 없는 쪽이 파일 이름에 안전하기 때문입니다(소유자 결정). 로그와 오류 메시지에는 `0x`를 붙여 `schema-hash.txt`와 같은 모양으로 찍습니다.
2. **스키마 아티팩트.** 파일 이름은 `compose-rust-renderer-schema-{hash}-{target}.tar.gz`와 `.sha256`입니다. 내용과 체크섬 형식은 5.3.1의 버전 아티팩트와 같고, `schema-hash.txt`가 들어 있습니다. 모든 렌더러 아티팩트가 `schema-hash.txt`를 싣는 것은 이미 사실입니다.
3. **게시 위치: 고정 이름 릴리스 하나(소유자 결정).** GitHub 릴리스 `renderer-dev` 하나에 자산을 스키마 해시 이름으로 쌓습니다. 주소는 `https://github.com/DarkPyonix/compose-rust/releases/download/renderer-dev/compose-rust-renderer-schema-{hash}-{target}.tar.gz`입니다. 해시마다 태그나 릴리스를 만들지 않습니다. 이 릴리스는 프리릴리스로 표시하며 **crates.io에 올리지 않고 `main`에 닿지 않습니다.** 버전 태그 `v*`와 이름이 겹치지 않아 릴리스 절차(AGENTS.md의 Releasing)를 건드리지 않습니다.
4. **게시 자동화와 릴리스의 존재.** GitHub 릴리스는 태그가 있어야 하므로 `renderer-dev` 태그 하나가 있습니다. 이 태그는 소유자가 한 번 만들었고(2026-10-25) 옮기거나 지우지 않습니다. 워크플로는 태그도 릴리스도 만들지 않습니다. 소유자가 이 릴리스를 만들기 전에는 올리기 단계가 알림을 남기고 건너뛰며 실패하지 않습니다. `develop`에 합쳐진 변경이 `schema-hash.txt`를 바꾸면 네 타깃의 렌더러를 빌드해 `gh release upload renderer-dev --clobber`로 자산을 올리거나 바꿉니다. 올릴 때 정리도 합니다. 가장 최근 해시 20개와 릴리스된 버전 태그(`v*`) 각각의 해시는 남기고 나머지 자산을 지웁니다. 파일은 `.github/workflows/publish-schema-renderer.yml`, 이름은 "Publish schema renderer"이며 무거운 워크플로이므로 `KNOWN_HEAVY`에 넣습니다. 같은 해시의 자산이 이미 있으면 다시 만들지 않습니다. 이 태그는 "태그는 `main`의 병합 커밋에만 붙인다"는 규칙의 유일한 예외이며, AGENTS.md의 Releasing에 그 예외가 적혀 있습니다.
5. **빌드 스크립트의 탐색.** 5.3.2의 순서를 따릅니다. 1(`COMPOSE_RUST_RENDERER_DIR`)과 2(워크스페이스 결과물)는 그대로입니다. 3의 캐시는 `.../renderer/schema-{hash}/{target}`입니다. 4의 다운로드는 먼저 버전 릴리스를 받고, 받은 아티팩트의 `schema-hash.txt`가 크레이트의 해시와 같으면 그것을 씁니다. 다르면 스키마 렌더러를 시도합니다. 둘 다 맞지 않으면 5.3.6의 불일치 실패입니다. 버전 릴리스가 맞는 흔한 경우에는 요청이 늘지 않습니다.
6. **`COMPOSE_RUST_RENDERER_URL`(선택).** 설정하면 `https://github.com/DarkPyonix/compose-rust/releases`를 대신하는 기준 주소로 쓰며, 그 아래에서 `download/v{version}/...`과 스키마 렌더러를 같은 규칙으로 찾습니다. 미러와 오프라인 CI를 위한 것이고 설치에 필요하지 않습니다. NFR-10은 그대로이며 설정하지 않은 빌드가 기본입니다.
7. **승격: develop CI가 빌드하고 릴리스는 승격합니다.** [user] "그래 그렇게 해" (2026-10-26), "develop CI가 렌더러를 빌드하고 릴리스가 그것을 승격한다"는 안에 대한 승인입니다. develop CI는 스키마 해시마다 렌더러 자산 다섯 개를 `renderer-dev` 프리릴리스에 `--clobber`로 올립니다. 가장 최근 해시 20개와 `v*` 태그가 쓰는 해시는 남깁니다. 릴리스가 없으면 건너뜁니다. 파일 이름의 해시는 `0x` 없는 소문자 16진수입니다. `v*` 태그 릴리스 워크플로는 태그 커밋의 렌더러를 `renderer-dev`에서 찾아 sha256을 검증하고, 빌드하지 않고 `v0.0.x` 릴리스로 승격합니다. 없으면 지금처럼 빌드합니다. 목적은 릴리스를 약 1.5시간에서 몇 분으로 줄이는 것입니다(v0.0.3의 Windows 정적 빌드 하나가 51분이었습니다).

**검토한 대안.**

Expand All @@ -3963,8 +3964,9 @@ Windows와 Linux는 이 저장소에 실행할 기계가 없어 자동 테스트
7. nfr16_publish_skips_without_release: `renderer-dev` 릴리스가 없으면 올리기 단계는 알림을 내고 0으로 끝나며 아무것도 만들지 않습니다.
8. nfr16_hash_spelling: 파일 이름에는 `0x` 없는 소문자 16진수가, 로그와 오류 메시지에는 `0x` 붙은 해시가 나옵니다.
9. nfr16_no_env_var_needed: 위 변수가 하나도 없는 환경에서 NFR-10의 수용 기준 1에서 6이 그대로 통과합니다.
10. nfr16_promote_without_build: `renderer-dev`에 태그 커밋의 해시 자산 다섯 개가 있고 sha256이 맞으면 릴리스 워크플로가 빌드 없이 `v0.0.x` 릴리스로 올립니다. sha256이 다르거나 자산이 없으면 빌드로 돌아갑니다.

**상태: Draft.** 코드는 이 항목이 Agreed가 된 뒤에 따라옵니다.
**상태: Agreed (2026-10-26).** 승격(7)과 기준 10의 코드는 아직 없습니다.

### 5.4 워크트리 빌드 격리 (NFR-12)

Expand Down Expand Up @@ -4025,10 +4027,12 @@ Cargo는 path 패키지의 유닛 해시에 패키지 경로를 넣지 않습니

### 5.6 Windows 단일 실행 파일 (NFR-13)

> **현황(2026-10-17).** develop의 Windows 렌더러는 아직 GraalVM native-image입니다. Kotlin/Native `mingwX64` 렌더러는 초안 PR #119(`feature/windows-kotlin-native`)와 그 위의 초안 PR #174에 있고 병합되지 않았습니다(#24).
> **현황(2026-10-26).** Kotlin/Native `mingwX64` 렌더러는 PR #119(`feature/windows-kotlin-native`)와 그 위의 PR #174로 2026-10-24에 develop에 병합됐습니다(이슈 #24는 열려 있음).

**2026-10-03 소유자 결정(INTENT D18). 실험이 아니라 정식 통합입니다.** Windows 렌더러는 Kotlin/Native(`mingwX64`)로 빌드한 정적 라이브러리(`renderer/windows/`, `staticlib-windows/`)이고, Rust 앱의 MSVC 실행 파일에 링크됩니다. Skia와 skiko의 C++ 부분은 MSVC로 빌드해 같은 실행 파일에 들어갑니다. Compose와 skiko의 `mingwX64` 타깃은 Compose 포크의 커밋입니다(INTENT D19). 경계와 그 이유는 INTENT D18에 있습니다.

**2026-10-26 소유자 결정: Windows 배포는 Kotlin/Native 정적 렌더러뿐입니다.** compose-rust가 Windows에 내는 렌더러는 `mingwX64` 정적 라이브러리(MSVC로 링크) 하나이고, Windows 앱은 macOS처럼 실행 파일 하나입니다. DLL, `icudtl.dat`, `include`가 없습니다. 자산 이름 `compose-rust-renderer-v<ver>-windows-x64.tar.gz`는 그대로 두고, 다음 버전부터 macOS, Linux와 같은 정적 키트를 뜻합니다. 대상은 Windows 10 이상이며 `D3DCOMPILER_47`을 불러오는 것은 허용합니다. GraalVM은 compose-rust의 배포에서 빠집니다. GraalVM 단일 바이너리는 확장 플러그인 포크(`thisisthepy/compose-multiplatform-extended`, 그쪽 #48 게이트)의 몫입니다. 실제 하드웨어 확인은 소유자의 Windows PC에서 하고, CI는 WARP를 씁니다. [user] "아니지 compose-rust는 kn만 사용하는거잖아" (2026-10-17), "그리고 Graal도 애초에 단일 바이너리로 나와야 하는데 그게 아니던데? dll, dat 그대로 있잖아. 분명 하나로 합치는걸 하자고 한지가 언젠데." (2026-10-26). `win32_window.c`는 그대로 둡니다(소유자의 C 하나 결정, 2026-10-04). 옮기는 일은 #26입니다.

**MinGW는 렌더러 아티팩트를 만드는 빌드 안에만 있습니다.** 앱을 빌드하는 사람의 툴체인은 Rust의 기본 Windows 타깃(`x86_64-pc-windows-msvc`)과 MSVC 링커이고, MinGW 툴체인, MinGW DLL, `windows-gnu` 타깃 어느 것도 요구하지 않습니다. 렌더러 아티팩트에 들어가는 MinGW 오브젝트는 MSVC 링커가 뜻을 바꾸지 않고 읽도록 고쳐진 것입니다(생성자 섹션, 되감기 정보).

수용 기준:
Expand Down
Loading