Releases: postmelee/alhangeul-macos
Releases · postmelee/alhangeul-macos
Alhangeul v0.1.5 (rhwp v0.7.15)
Alhangeul v0.1.5
이번 버전의 주요 변경 사항
변경 요약
rhwp v0.7.15를 반영해 수식, 미주, HWPX 저장/내보내기 호환성 관련 개선을 포함했습니다.- 앱 화면, Finder Quick Look 미리보기, Finder 썸네일은 같은
rhwp v0.7.15기반 문서 처리 개선을 사용합니다. - HWPX 저장/내보내기에서 그림 회전·반전, 대각선 셀 테두리, 빈 필드 순서 보존 관련 호환성을 보강했습니다.
- Finder Quick Look 미리보기, 썸네일, PDF/공유 경로에서 일부 양식 컨트롤, 문서 안에 포함된 리소스, 이미지 채움 방식 표시를 보강했습니다.
- 앱 실행 후 Sparkle 업데이트 확인이 백그라운드에서 시작되도록 보강했습니다.
- bundled viewer/editor의 문단 정보 대화상자가 왼쪽 여백과 내어쓰기 값을 더 분명히 구분하도록 개선했습니다.
- 공식 DMG는 Intel Mac과 Apple Silicon Mac을 모두 지원하는 signed/notarized universal DMG입니다.
포함된 rhwp 변화
- 포함된
rhwpcore:v0.7.15(aa925a5954f0fd26dfcef2166cbce7877c481f44) - bundled
rhwp-studio:v0.7.15(aa925a5954f0fd26dfcef2166cbce7877c481f44) - 수식 TAC-only line wrapping과 indent, 강제 줄바꿈 뒤 cursor movement, 미주 안 수식 script 렌더링/간격/위첨자 정렬 보정이 포함됩니다.
- HWPX picture serialization의 flip/rotation/isEmbeded, 대각선 셀 테두리
hh:slash/hh:backSlash, zero-length field ordering 보존이 보강됩니다. rhwp-studio문단 정보 대화상자는 왼쪽 여백과 내어쓰기 binding을 분리합니다.- upstream release에는 browser extension service worker document fetch path 보안 강화가 포함되지만, 알한글 macOS 앱은 별도 브라우저 확장 권한이나 네트워크 경로를 추가하지 않습니다.
알한글 앱 변화
- Finder Quick Look 미리보기, Finder 썸네일, PDF/공유 출력 경로에서 일부 양식 컨트롤, 문서 안에 포함된 리소스, 이미지 채움 방식 표시를 보강했습니다.
- 앱 실행 후 Sparkle 업데이트 확인이 백그라운드에서 시작되도록 보강해 사용자가 최신 릴리즈를 더 빨리 확인할 수 있게 했습니다.
- 앱 viewer/editor 화면은 bundled
rhwp-studio v0.7.15를 사용하며, upstream 문서 처리 개선을 같은 버전 기준으로 반영합니다.
다운로드 및 설치
다운로드
- DMG:
alhangeul-macos-0.1.5.dmg - SHA256:
d347c13b80aeaa006776db7ae2b00f8a2d11836c94757165f4bb87a331dd585b - SHA256 file:
alhangeul-macos-0.1.5.dmg.sha256
지원 환경
- macOS 12 이상을 지원합니다.
- Intel Mac과 Apple Silicon Mac 모두 같은 DMG 파일을 사용합니다.
설치 후 첫 실행
- DMG를 열고
Alhangeul.app을Applications폴더로 드래그해 설치합니다. - GitHub Release에 게시된 signed/notarized public DMG만 사용자 배포 산출물로 사용합니다.
- 설치 후
Applications폴더의Alhangeul.app을 한 번 실행합니다. - 첫 실행 후 macOS가 Quick Look preview와 Finder thumbnail extension을 발견하고 등록할 수 있습니다.
- Finder에서
.hwp또는.hwpx파일을 선택한 뒤 Space로 Quick Look preview를 확인하고, icon view에서 thumbnail 갱신을 확인합니다.
업데이트 확인
- 앱 메뉴에서
알한글 > 업데이트 확인...을 선택해 Sparkle 업데이트를 수동 확인할 수 있습니다. - 업데이트 feed:
https://postmelee.github.io/alhangeul-macos/appcast.xml - 버전별 Pages 릴리즈 노트: https://postmelee.github.io/alhangeul-macos/updates/v0.1.5.html
Homebrew
- Homebrew Cask 반영 전에는 위 GitHub Release DMG를 직접 내려받아 설치하세요.
알려진 제한 사항
- 앱 viewer/editor 화면은 bundled
rhwp-studio를 WKWebView에서 실행합니다. - PDF 내보내기, Quick Look preview, Finder thumbnail은 Rust bridge와 Swift native renderer 계열 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 인쇄는
rhwp-studiopage payload를 별도 WKWebView/PDFKit/AppKit 출력 경로로 처리합니다. - Quick Look/Thumbnail smoke 통과는 extension 등록과 기본 렌더 성공 확인이며, 모든 문서가 앱 화면과 같은 시각 결과로 보인다는 보장은 아닙니다.
- 손상·대용량·미지원 문서 fallback은 복구가 아니라 앱과 extension이 raw error, hang, crash로 끝나지 않게 하는 안전장치입니다.
- native renderer의 style, image effect/fill, text layout, RawSvg/OLE 등 parity 개선은 v0.5 이후 Swift native viewer 범위에서 계속 다룹니다.
이번 릴리즈 관련 PR과 Issue
릴리즈 요약에 반영된 PR
- #324: Task #323: 앱 실행 시 Sparkle 백그라운드 업데이트 확인 실행 - 앱 실행 후 Sparkle 업데이트 확인이 백그라운드에서 시작되도록 반영했습니다.
- #326: Task #122: Swift native renderer 이미지 fill mode parity 보강 - Quick Look, 썸네일, PDF/공유 경로의 이미지 채움 방식 표시 보강 근거입니다.
- #329: Task #121: RawSvg/OLE·차트 리소스 렌더링 보강 - 문서 안에 포함된 리소스 표시 보강 근거입니다.
- #334: Task #110: FormObject 정적 프리뷰 보강 - 일부 양식 컨트롤의 정적 프리뷰 표시 보강 근거입니다.
- #349: Sync rhwp upstream v0.7.15 -
rhwpcore와 bundledrhwp-studio v0.7.15반영 근거입니다.
해결된 Issue
- #110: Swift native renderer Placeholder/FormObject 정적 프리뷰 보강 - PR #334 반영으로 FormObject 정적 프리뷰 보강 완료를 확정했습니다.
- #121: Swift native renderer RawSvg/OLE·차트 리소스 렌더링 보강 - PR #329 대상 타스크 Issue로, 문서 안에 포함된 리소스 표시 보강을 완료했습니다.
- #122: Swift native renderer 이미지 fill mode·타일·배치 렌더링 parity 보강 - PR #326 대상 타스크 Issue로, 이미지 채움 방식 표시 보강을 완료했습니다.
- #323: 앱 실행 시 Sparkle 백그라운드 업데이트 확인 실행 - PR #324 대상 타스크 Issue로, 앱 실행 후 업데이트 확인 경로 보강을 완료했습니다.
참고/연관 Issue
- 없음
상세 기록
- 릴리즈 상세 기록:
mydocs/release/v0.1.5.md - 릴리즈 기록 index:
mydocs/release/index.md - 사용자용 Pages 릴리즈 노트: https://postmelee.github.io/alhangeul-macos/updates/v0.1.5.html
- GitHub Release: https://github.com/postmelee/alhangeul-macos/releases/tag/v0.1.5
- Third Party notices:
THIRD_PARTY_LICENSES.md - Font notices:
Sources/HostApp/Resources/rhwp-studio/fonts/FONTS.md
Release metadata
| 항목 | 값 |
|---|---|
| App version | v0.1.5 |
| rhwp core release tag | v0.7.15 |
| rhwp core commit | aa925a5954f0fd26dfcef2166cbce7877c481f44 |
| bundled rhwp-studio release tag | v0.7.15 |
| bundled rhwp-studio commit | aa925a5954f0fd26dfcef2166cbce7877c481f44 |
| core lock | rhwp-core.lock |
| studio manifest | Sources/HostApp/Resources/rhwp-studio/manifest.json |
Alhangeul v0.1.4 (rhwp v0.7.13)
Alhangeul v0.1.4
요약
- Quick Look 미리보기와 Finder 썸네일에서 일부 HWP 문서의 특수 문자, 기호, 서명 표식이 깨진 네모로 보이던 문제를 보정했습니다.
- 일부 문서에서 글자 뒤에 의도하지 않은 배경색이나 음영 박스가 보이던 문제를 줄였습니다.
- HWPX 렌더링과 HWP 저장 호환성, 표/셀 속성, 메모, 목차 필드, 페이지 번호 처리 관련
rhwp v0.7.13개선을 포함했습니다. - 앱 본체, Quick Look preview extension, Finder thumbnail extension은
0.1.4 (10)입니다. - signed/notarized universal DMG를 GitHub Release, Pages, Sparkle stable appcast, Homebrew Cask에 같은 public DMG 기준으로 게시했습니다.
다운로드
- DMG: https://github.com/postmelee/alhangeul-macos/releases/download/v0.1.4/alhangeul-macos-0.1.4.dmg
- SHA256:
cf04cb23e9bd072d9852cc404d092824446c7177ffb23a9bf16d1d1438317c6b - 지원 OS: macOS 12 Monterey 이상
- 지원 아키텍처:
arm64 + x86_64universal app/extension bundle
포함된 rhwp
rhwpcore:v0.7.13(b3e16ef212af81ef37d973ddb86d6816d3804642)- bundled
rhwp-studio:v0.7.13(b3e16ef212af81ef37d973ddb86d6816d3804642)
기술 세부
아래 항목은 검증과 후속 유지보수를 위한 개발자용 세부 정보입니다. 사용자-facing 요약은 위의 요약 섹션과 Pages 릴리즈 노트에 일반화된 표현으로 유지했습니다.
samples/복학원서.hwp에서 확인한 CoreGraphics 경로의 PUA 표시 문제를 보정했습니다.- Quick Look preview와 Finder thumbnail의 native/CoreGraphics renderer path에서
U+F012B는(인)으로 표시하고,U+F081Cfiller는 그리지 않도록 처리했습니다. TextStyle.shadeColor == 0xFFFFFFFF는 실제 text shade/background가 아니라 no-shade sentinel로 해석하도록 보정했습니다.- 구현 경로는
Sources/RhwpCoreBridge/CGTreeRenderer.swift입니다. - HostApp viewer/editor는 WKWebView 기반 bundled
rhwp-studio경로를 사용하며, Quick Look/Thumbnail은 native/CoreGraphics 경로를 사용합니다.
검증
- Release workflow: https://github.com/postmelee/alhangeul-macos/actions/runs/26710019767
- GitHub Release state: public, non-prerelease
shasum -a 256 -c: OKhdiutil verify: VALID- DMG notarization staple: OK
- DMG Gatekeeper assessment: accepted,
source=Notarized Developer ID - mounted app version/build:
0.1.4 (10) - mounted app arch:
x86_64 arm64 - mounted app codesign verification: OK
- mounted app Gatekeeper assessment: accepted,
source=Notarized Developer ID - Pages: https://postmelee.github.io/alhangeul-macos/
- Sparkle appcast: https://postmelee.github.io/alhangeul-macos/appcast.xml
Homebrew Cask
Homebrew Cask는 postmelee/homebrew-tap에 v0.1.4 public DMG URL/SHA256 기준으로 반영했습니다.
- 설치 명령:
brew install --cask postmelee/tap/alhangeul - Cask version:
0.1.4 - Cask SHA256:
cf04cb23e9bd072d9852cc404d092824446c7177ffb23a9bf16d1d1438317c6b - Tap commit:
5c3d4ee
검증 결과: brew style --cask alhangeul, brew audit --cask alhangeul, brew audit --cask --new alhangeul, brew install --cask postmelee/tap/alhangeul, brew uninstall --cask alhangeul 모두 통과했습니다.
알려진 제한
- 앱 viewer/editor는 bundled
rhwp-studio를 WKWebView에서 실행합니다. - Quick Look preview와 Finder thumbnail은 Rust bridge와 Swift native renderer 계열 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 일부 문서에서는 글꼴, 배치, 페이지 표현이 원본 한글 프로그램과 다르게 보일 수 있습니다.
Alhangeul v0.1.3 (rhwp v0.7.12)
Alhangeul v0.1.3 (rhwp v0.7.12)
사용자용 요약
rhwpcore와 bundledrhwp-studio를v0.7.12기준으로 갱신했습니다.- HWP/HWPX parser, viewer, WMF, HWP3, 렌더링 관련 upstream 수정이 앱과 Finder 통합 경로에 포함됩니다.
- 앱 본체, Quick Look preview extension, Finder thumbnail extension의 release version은
0.1.3 (9)입니다. - 공식 DMG는 Intel Mac과 Apple Silicon Mac에서 같은 파일을 사용하는 signed/notarized universal DMG입니다.
설치 방법
- DMG:
alhangeul-macos-0.1.3.dmg - macOS 12 Monterey 이상을 지원합니다.
- DMG를 열고
Alhangeul.app을Applications폴더로 드래그해 설치합니다. - 설치 후
Applications폴더의Alhangeul.app을 한 번 실행하면 macOS가 Quick Look preview와 Finder thumbnail extension을 발견하고 등록할 수 있습니다.
이번 버전의 주요 변경 사항
전체 요약
- upstream
rhwp v0.7.12를 앱 저장소의 Rust core dependency, lock file, bundledrhwp-studioasset provenance에 반영했습니다. - Finder Quick Look, Finder thumbnail, 앱 viewer가 새 bundled core/studio 기준을 사용하도록 검증했습니다.
v0.1.3release workflow 기본값을previous_release_ref=v0.1.2,expected_rhwp_tag=v0.7.12로 맞췄습니다.- Pages 릴리즈 노트와 Sparkle stable appcast를 v0.1.3 public DMG 기준으로 배포했습니다.
포함된 rhwp 변화
- 포함된
rhwpcore:v0.7.12(1899ef9bc2dfd1c6c0c4d18b192d253a2d0a1fb5) - bundled
rhwp-studio:v0.7.12(1899ef9bc2dfd1c6c0c4d18b192d253a2d0a1fb5) - upstream release body는 비어 있지만, tag와 diff 기준으로 parser/viewer 결함 수정, WMF, HWP3, LTO 관련 변경이 포함됩니다.
- Rust FFI에는 native PNG 렌더링용
rhwp_render_page_pngsymbol이 추가됐고, generated header와 ABI lock 기준을 갱신했습니다.
알한글 앱 변화
rhwp-core.lock,RustBridge/Cargo.toml,RustBridge/Cargo.lock, bundledrhwp-studio/manifest.json이 모두v0.7.12/1899ef9...기준을 가리킵니다.- 앱 본체와 Quick Look/Thumbnail extension metadata를
0.1.3 (9)로 맞췄습니다. - About 창과 내부 provenance 표시가 bundled
rhwp v0.7.12기준을 읽을 수 있도록 manifest를 갱신했습니다. - Pages 릴리즈 노트, README 최신 릴리즈 요약, third-party notices를
rhwp v0.7.12기준으로 정리했습니다.
다운로드 산출물과 SHA256
- GitHub Release: https://github.com/postmelee/alhangeul-macos/releases/tag/v0.1.3
- DMG URL: https://github.com/postmelee/alhangeul-macos/releases/download/v0.1.3/alhangeul-macos-0.1.3.dmg
- SHA256 file:
alhangeul-macos-0.1.3.dmg.sha256 - SHA256:
78b365b72857776057c6159d58cf6f61e6b17869f2cd484ac83ea3c0cca59806 - DMG size:
151551151bytes - 지원 아키텍처:
arm64 + x86_64universal app/extension bundle
검증 결과
- Release Publish workflow: https://github.com/postmelee/alhangeul-macos/actions/runs/26023538276
- 기준 tag:
v0.1.3->f6a9cd2bbc9a390284b0a68ba1360be8cc19a442 - release workflow에서 tag/ref 검증, release delta checklist 생성,
rhwp-core.lock의v0.7.12검증, upstream latest release 확인을 통과했습니다. - Rust source provenance, Cargo lock, generated header, FFI symbol lock 검증을 통과했습니다.
- signed/notarized DMG 생성, app/DMG staple, Gatekeeper 검증, SHA256 검증을 통과했습니다.
- GitHub Release asset 게시와 non-draft/non-prerelease release state 검증을 통과했습니다.
- Sparkle appcast는
shortVersionString=0.1.3,version=9, tag-fixed DMG URL, EdDSA signature를 제공합니다. - GitHub Pages 배포가 성공했고,
https://postmelee.github.io/alhangeul-macos/updates/v0.1.3.html에서 사용자용 릴리즈 노트를 확인할 수 있습니다.
Homebrew Cask
v0.1.3 DMG 설치가 공식 배포 경로입니다. Homebrew tap의 v0.1.3 SHA 반영과 tap context install/uninstall smoke는 별도 후속 작업에서 확인합니다.
알려진 제한 사항
- 앱 viewer/editor 화면은 bundled
rhwp-studio를 WKWebView에서 실행합니다. - Quick Look preview와 Finder thumbnail은 native renderer 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 일부 문서에서는 글꼴, 배치, 페이지 표현이 원본 한글 프로그램과 다르게 보일 수 있습니다.
- HWPX 문서는 현재 직접 저장이 제한되어 HWP export 경로를 사용합니다.
- native renderer의 style, image effect/fill, text layout, RawSvg/OLE 등 parity 개선은 v0.5 이후 Swift native viewer 범위에서 계속 다룹니다.
Release metadata
| 항목 | 값 |
|---|---|
| App version | v0.1.3 |
| CFBundleShortVersionString | 0.1.3 |
| CFBundleVersion | 9 |
| rhwp core release tag | v0.7.12 |
| rhwp core commit | 1899ef9bc2dfd1c6c0c4d18b192d253a2d0a1fb5 |
| bundled rhwp-studio release tag | v0.7.12 |
| bundled rhwp-studio commit | 1899ef9bc2dfd1c6c0c4d18b192d253a2d0a1fb5 |
| core lock | rhwp-core.lock |
| studio manifest | Sources/HostApp/Resources/rhwp-studio/manifest.json |
Third Party notices
THIRD_PARTY_LICENSES.mdSources/HostApp/Resources/Legal/THIRD_PARTY_LICENSES.mdSources/HostApp/Resources/rhwp-studio/fonts/FONTS.md
Alhangeul v0.1.2
Alhangeul v0.1.2
사용자용 요약
- macOS 12 이상에서 HWP/HWPX 문서를 Finder Quick Look, Finder thumbnail, 알한글 앱으로 확인할 수 있습니다.
- 공식 DMG는 Intel Mac과 Apple Silicon Mac을 모두 지원하는 단일 universal DMG입니다.
- 이번 릴리스의 상세 변경과 검증 기록은
mydocs/release/v0.1.2.md와 release delta checklist를 기준으로 관리합니다. - 설치, 첫 실행, 업데이트 확인, 알려진 제한 사항을 먼저 확인한 뒤 DMG를 내려받으세요.
설치 방법
- DMG:
alhangeul-macos-0.1.2.dmg - macOS 12 이상을 지원합니다.
- Intel Mac과 Apple Silicon Mac 모두 같은 DMG 파일을 사용합니다.
- DMG를 열고
Alhangeul.app을Applications폴더로 드래그해 설치합니다. - GitHub Release에 게시된 signed/notarized public DMG만 사용자 배포 산출물로 사용합니다.
지원 환경과 아키텍처
- 지원 OS: macOS 12 Monterey 이상
- 지원 Mac: Intel Mac, Apple Silicon Mac
- 배포 방식: 아키텍처별 DMG를 나누지 않고
alhangeul-macos-0.1.2.dmg단일 파일을 제공합니다. - release build는 앱 본체와 Quick Look/Thumbnail extension 실행 파일의
arm64 + x86_64slice를 검증해야 합니다. - 실제 Intel Mac 실기기 smoke는 실행한 경우에만 성공으로 기록하고, 미실행 시에는 release detail doc에 이유를 남깁니다.
설치 후 첫 실행과 Quick Look/Thumbnail 활성화 안내
- 설치 후
Applications폴더의Alhangeul.app을 한 번 실행합니다. - 첫 실행 후 macOS가 Quick Look preview와 Finder thumbnail extension을 발견하고 등록할 수 있습니다.
- Finder에서
.hwp또는.hwpx파일을 선택한 뒤 Space로 Quick Look preview를 확인하고, icon view에서 thumbnail 갱신을 확인합니다.
업데이트 확인 방법
- 앱 메뉴에서
알한글 > 업데이트 확인...을 선택해 Sparkle 업데이트를 수동 확인할 수 있습니다. - 업데이트 feed:
https://postmelee.github.io/alhangeul-macos/appcast.xml - 버전별 Pages 릴리즈 노트: https://postmelee.github.io/alhangeul-macos/updates/v0.1.2.html
이번 버전의 주요 변경 사항
- 직전 공개 릴리즈 대비 사용자-facing 변경은 release delta checklist를 기준으로 정리합니다.
- 연결된 Issue/PR과 기여자는
mydocs/release/v0.1.2.md의 릴리즈 상세 기록을 기준으로 확인합니다. - 문서 전용 변경과 설치본 smoke가 필요한 변경은 release delta checklist에서 구분합니다.
다운로드 산출물과 SHA256
- GitHub Release: https://github.com/postmelee/alhangeul-macos/releases/tag/v0.1.2
- DMG:
alhangeul-macos-0.1.2.dmg - DMG URL: https://github.com/postmelee/alhangeul-macos/releases/download/v0.1.2/alhangeul-macos-0.1.2.dmg
- 지원 아키텍처:
arm64 + x86_64universal app/extension bundle - SHA256 file:
alhangeul-macos-0.1.2.dmg.sha256 - SHA256:
37a27321f03a84b8b28749b5f839ea5c5833975d20f2479e3b79ebd665811ead
Homebrew Cask
- Homebrew Cask는 public DMG URL/SHA256과 tap context 검증을 통과했습니다.
- 설치 명령:
brew install --cask postmelee/tap/alhangeul - Homebrew Cask도 아키텍처별 URL을 나누지 않고 같은 public universal DMG URL과 SHA256을 사용합니다.
Release metadata
| 항목 | 값 |
|---|---|
| App version | v0.1.2 |
| rhwp core release tag | v0.7.11 |
| rhwp core commit | a9dcdee32b17a7f9a20c609a5ed547e62fb8ebae |
| bundled rhwp-studio release tag | v0.7.11 |
| bundled rhwp-studio commit | a9dcdee32b17a7f9a20c609a5ed547e62fb8ebae |
| core lock | rhwp-core.lock |
| studio manifest | Sources/HostApp/Resources/rhwp-studio/manifest.json |
검증 결과
- release publish workflow에서 서명, 공증, staple, Gatekeeper assessment, checksum 검증을 통과한 public DMG만 배포합니다.
hdiutil verify, SHA256 대조, app bundle signing/notarization/staple 검증 결과를 최종 확인합니다.Alhangeul.app,AlhangeulPreview.appex,AlhangeulThumbnail.appex의 실행 파일이arm64 + x86_64universal인지 확인합니다.- Finder Quick Look preview, Finder thumbnail, 앱 실행, 문서 열기, 창 resize/확대, Sparkle 수동 업데이트 확인 smoke 결과는
mydocs/release/v0.1.2.md에 기록합니다. - 실행하지 않은 수동 확인 항목은 성공으로 쓰지 않고 #188 final smoke 또는 후속 확인으로 분리합니다.
릴리즈 delta 기반 추가 확인 항목
- 기준 범위는 직전 공개 release tag부터 현재 release candidate commit까지입니다.
- merged PR, 연결된 Issue, commit range, 변경 파일 목록을 수집한 뒤 영향 영역별 smoke 항목을 보정합니다.
- 영향 영역 후보: HostApp viewer, Quick Look preview, Finder thumbnail, 저장/다른 이름 저장, PDF/인쇄/공유, Sparkle/appcast/Pages, DMG/signing/notarization, Homebrew Cask, rhwp core/viewer asset provenance, 문서 전용 변경.
- 자동 생성된 checklist는 초안이며 release owner가 누락/과잉 항목을 보정합니다.
알려진 제한 사항과 후속 이슈
- 앱 viewer/editor 화면은 bundled
rhwp-studio를 WKWebView에서 실행합니다. - PDF 내보내기, Quick Look preview, Finder thumbnail은 Rust bridge와 Swift native renderer 계열 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 인쇄는
rhwp-studiopage payload를 별도 WKWebView/PDFKit/AppKit 출력 경로로 처리합니다. - Quick Look/Thumbnail smoke 통과는 extension 등록과 기본 렌더 성공 확인이며, 모든 문서가 앱 화면과 같은 시각 결과로 보인다는 보장은 아닙니다.
- 손상·대용량·미지원 문서 fallback은 복구가 아니라 앱과 extension이 raw error, hang, crash로 끝나지 않게 하는 안전장치입니다.
- native renderer의 style, image effect/fill, text layout, RawSvg/OLE 등 parity 개선은 v0.5 이후 Swift native viewer 범위에서 계속 다룹니다.
- 후속 이슈는
mydocs/release/v0.1.2.md와 GitHub Issue 상태를 기준으로 관리합니다.
Third Party notices
THIRD_PARTY_LICENSES.mdSources/HostApp/Resources/rhwp-studio/fonts/FONTS.md
Alhangeul v0.1.1
Alhangeul v0.1.1
사용자용 요약
- macOS 12 이상에서 HWP/HWPX 문서를 Finder Quick Look, Finder thumbnail, 알한글 앱으로 확인할 수 있습니다.
- 공식 DMG는 Intel Mac과 Apple Silicon Mac을 모두 지원하는 단일 universal DMG입니다.
- 이번 릴리스의 상세 변경과 검증 기록은
mydocs/release/v0.1.1.md와 release delta checklist를 기준으로 관리합니다. - 설치, 첫 실행, 업데이트 확인, 알려진 제한 사항을 먼저 확인한 뒤 DMG를 내려받으세요.
설치 방법
- DMG:
alhangeul-macos-0.1.1.dmg - macOS 12 이상을 지원합니다.
- Intel Mac과 Apple Silicon Mac 모두 같은 DMG 파일을 사용합니다.
- DMG를 열고
Alhangeul.app을Applications폴더로 드래그해 설치합니다. - GitHub Release에 게시된 signed/notarized public DMG만 사용자 배포 산출물로 사용합니다.
지원 환경과 아키텍처
- 지원 OS: macOS 12 Monterey 이상
- 지원 Mac: Intel Mac, Apple Silicon Mac
- 배포 방식: 아키텍처별 DMG를 나누지 않고
alhangeul-macos-0.1.1.dmg단일 파일을 제공합니다. - release build는 앱 본체와 Quick Look/Thumbnail extension 실행 파일의
arm64 + x86_64slice를 검증해야 합니다. - 실제 Intel Mac 실기기 smoke는 실행한 경우에만 성공으로 기록하고, 미실행 시에는 release detail doc에 이유를 남깁니다.
설치 후 첫 실행과 Quick Look/Thumbnail 활성화 안내
- 설치 후
Applications폴더의Alhangeul.app을 한 번 실행합니다. - 첫 실행 후 macOS가 Quick Look preview와 Finder thumbnail extension을 발견하고 등록할 수 있습니다.
- Finder에서
.hwp또는.hwpx파일을 선택한 뒤 Space로 Quick Look preview를 확인하고, icon view에서 thumbnail 갱신을 확인합니다.
업데이트 확인 방법
- 앱 메뉴에서
알한글 > 업데이트 확인...을 선택해 Sparkle 업데이트를 수동 확인할 수 있습니다. - 업데이트 feed:
https://postmelee.github.io/alhangeul-macos/appcast.xml - 버전별 Pages 릴리즈 노트: https://postmelee.github.io/alhangeul-macos/updates/v0.1.1.html
이번 버전의 주요 변경 사항
- 직전 공개 릴리즈 대비 사용자-facing 변경은 release delta checklist를 기준으로 정리합니다.
- 연결된 Issue/PR과 기여자는
mydocs/release/v0.1.1.md의 릴리즈 상세 기록을 기준으로 확인합니다. - 문서 전용 변경과 설치본 smoke가 필요한 변경은 release delta checklist에서 구분합니다.
다운로드 산출물과 SHA256
- GitHub Release: https://github.com/postmelee/alhangeul-macos/releases/tag/v0.1.1
- DMG:
alhangeul-macos-0.1.1.dmg - DMG URL: https://github.com/postmelee/alhangeul-macos/releases/download/v0.1.1/alhangeul-macos-0.1.1.dmg
- 지원 아키텍처:
arm64 + x86_64universal app/extension bundle - SHA256 file:
alhangeul-macos-0.1.1.dmg.sha256 - SHA256:
12c5755fa0ac75dd13f813c6e65f0fc37a7e43e07080317c7df54b06e9c60e16
Homebrew Cask
- Homebrew Cask는 public DMG URL/SHA256과 tap context 검증이 끝난 뒤 안내합니다.
- 검증 전 공식 설치 경로는 위 GitHub Release DMG입니다.
- Homebrew Cask도 아키텍처별 URL을 나누지 않고 같은 public universal DMG URL과 SHA256을 사용합니다.
- 공개 완료 후 설치 명령은
brew install --cask postmelee/tap/alhangeul-macos기준으로 README, Pages, GitHub Release/릴리즈 노트에 반영합니다.
포함된 rhwp core와 viewer asset provenance
- rhwp core release tag:
v0.7.10 - rhwp core commit:
62a458aa317e962cd3d0eec6096728c172d57110 - rhwp-studio release tag:
v0.7.10 - rhwp-studio commit:
62a458aa317e962cd3d0eec6096728c172d57110 - manifest:
Sources/HostApp/Resources/rhwp-studio/manifest.json - release detail doc:
mydocs/release/v0.1.1.md
검증 결과
- release publish workflow에서 서명, 공증, staple, Gatekeeper assessment, checksum 검증을 통과한 public DMG만 배포합니다.
hdiutil verify, SHA256 대조, app bundle signing/notarization/staple 검증 결과를 최종 확인합니다.Alhangeul.app,AlhangeulPreview.appex,AlhangeulThumbnail.appex의 실행 파일이arm64 + x86_64universal인지 확인합니다.- Finder Quick Look preview, Finder thumbnail, 앱 실행, 문서 열기, 창 resize/확대, Sparkle 수동 업데이트 확인 smoke 결과는
mydocs/release/v0.1.1.md에 기록합니다. - 실행하지 않은 수동 확인 항목은 성공으로 쓰지 않고 #188 final smoke 또는 후속 확인으로 분리합니다.
릴리즈 delta 기반 추가 확인 항목
- 기준 범위는 직전 공개 release tag부터 현재 release candidate commit까지입니다.
- merged PR, 연결된 Issue, commit range, 변경 파일 목록을 수집한 뒤 영향 영역별 smoke 항목을 보정합니다.
- 영향 영역 후보: HostApp viewer, Quick Look preview, Finder thumbnail, 저장/다른 이름 저장, PDF/인쇄/공유, Sparkle/appcast/Pages, DMG/signing/notarization, Homebrew Cask, rhwp core/viewer asset provenance, 문서 전용 변경.
- 자동 생성된 checklist는 초안이며 release owner가 누락/과잉 항목을 보정합니다.
알려진 제한 사항과 후속 이슈
- 앱 viewer/editor 화면은 bundled
rhwp-studio를 WKWebView에서 실행합니다. - PDF 내보내기, Quick Look preview, Finder thumbnail은 Rust bridge와 Swift native renderer 계열 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 인쇄는
rhwp-studiopage payload를 별도 WKWebView/PDFKit/AppKit 출력 경로로 처리합니다. - Quick Look/Thumbnail smoke 통과는 extension 등록과 기본 렌더 성공 확인이며, 모든 문서가 앱 화면과 같은 시각 결과로 보인다는 보장은 아닙니다.
- 손상·대용량·미지원 문서 fallback은 복구가 아니라 앱과 extension이 raw error, hang, crash로 끝나지 않게 하는 안전장치입니다.
- native renderer의 style, image effect/fill, text layout, RawSvg/OLE 등 parity 개선은 v0.5 이후 Swift native viewer 범위에서 계속 다룹니다.
- 후속 이슈는
mydocs/release/v0.1.1.md와 GitHub Issue 상태를 기준으로 관리합니다.
Third Party notices
THIRD_PARTY_LICENSES.mdSources/HostApp/Resources/rhwp-studio/fonts/FONTS.md
Alhangeul v0.1.0
Alhangeul v0.1.0
설치
- macOS 12 이상을 지원합니다.
- 아래 DMG를 내려받아
Alhangeul.app을 Applications 폴더로 옮겨 설치합니다.
산출물
- DMG:
alhangeul-macos-0.1.0.dmg - SHA256:
98d4e1807dfece2acd08510441c0f1a41cad9a8f5bbe1b82cf9ed4d3abb0f3c4
포함된 rhwp core
- release tag:
v0.7.10 - commit:
62a458aa317e962cd3d0eec6096728c172d57110
포함된 viewer asset provenance
- rhwp-studio release tag:
v0.7.10 - rhwp-studio commit:
62a458aa317e962cd3d0eec6096728c172d57110 - manifest:
Sources/HostApp/Resources/rhwp-studio/manifest.json
Third Party notices
THIRD_PARTY_LICENSES.mdSources/HostApp/Resources/rhwp-studio/fonts/FONTS.md
렌더링 경로와 알려진 제한 사항
- 앱 viewer/editor 화면은 bundled
rhwp-studio를 WKWebView에서 실행합니다. - PDF 내보내기, Quick Look preview, Finder thumbnail은 Rust bridge와 Swift native renderer 계열 경로를 사용하므로 앱 화면과 표시가 다를 수 있습니다.
- 인쇄는
rhwp-studiopage payload를 별도 WKWebView/PDFKit/AppKit 출력 경로로 처리합니다. - Quick Look/Thumbnail smoke 통과는 extension 등록과 기본 렌더 성공 확인이며, 모든 문서가 앱 화면과 같은 시각 결과로 보인다는 보장은 아닙니다.
- 손상·대용량·미지원 문서 fallback은 복구가 아니라 앱과 extension이 raw error, hang, crash로 끝나지 않게 하는 안전장치입니다.
- native renderer의 style, image effect/fill, text layout, RawSvg/OLE 등 parity 개선은 v0.5 이후 Swift native viewer 범위에서 계속 다룹니다.
검증
- 이 DMG는 release publish workflow에서 서명, 공증, staple, Gatekeeper assessment, checksum 검증을 통과한 산출물입니다.
- 상세 smoke test 결과, preview 수동 확인 여부, 알려진 제한 사항은 해당 릴리스의 최종 보고서를 기준으로 확인합니다.