업데이트 / Updates

개요

TeX64는 인앱 업데이트와 수동 다운로드를 모두 지원합니다. 선호하는 방법으로 언제든지 최신 버전으로 업데이트할 수 있습니다.

인앱 업데이트 흐름

TeX64 내부에서 직접 업데이트할 수 있습니다. 가장 쉽고 권장되는 방법입니다.

1. 설정을 열고 "계정" 페이지를 선택합니다
2. 업데이트 영역에서 현재 버전과 최신 버전을 확인합니다
3. "업데이트 확인" 버튼을 클릭하여 새 버전을 확인합니다
4. 새 버전이 있는 경우 "업데이트 적용" 버튼이 표시됩니다. 헤더 바에도 같은 원클릭 Update 버튼이 표시될 수 있습니다.
5. "업데이트 적용"을 클릭하여 업데이트 패키지를 다운로드하고 검증합니다
6. 다운로드가 준비되면 TeX64가 운영 체제에 맞는 설치 프로그램을 시작합니다. 화면의 안내에 따라 설치합니다
7. 필요한 경우 설치 후 TeX64를 다시 열고 설정 > 계정에서 버전을 확인합니다

수동 업데이트

인앱 업데이트가 동작하지 않거나 수동 제어를 선호하는 경우, 다운로드 페이지에서 직접 다운로드해 설치할 수 있습니다.

1. /download 페이지에 접속
2. Mac 아키텍처에 맞는 최신 빌드 선택(Apple Silicon / Intel Mac)
3. macOS용 DMG 다운로드
4. DMG를 열어 TeX64.app을 응용 프로그램 폴더로 드래그&드롭
5. 기존 버전을 교체할지 묻는 경우 "교체"를 선택
6. TeX64를 완전히 재시작
7. 설정 > 계정에서 버전 확인

직접 다운로드 링크

아래 링크에서 직접 다운로드할 수 있습니다. 아키텍처와 파일 형식을 선택하세요.

• Apple Silicon — DMG (권장):
  /download/latest
• Apple Silicon — ZIP:
  /download/latest?kind=zip
• Intel (x64) — DMG:
  /download/latest?arch=x64
• Intel (x64) — ZIP:
  /download/latest?arch=x64&kind=zip

Manifest API

빌드 시스템이나 사용자 스크립트에서 업데이트 정보를 자동으로 가져올 수 있습니다. Manifest API는 다음 엔드포인트에서 제공됩니다:

이 엔드포인트는 최신 버전, 다운로드 URL, SHA256 체크섬, 필수 플래그, 릴리스 노트 URL 등을 반환합니다. CI/CD 파이프라인이나 사용자 정의 업데이트 스크립트에 활용할 수 있습니다.

API 매개변수

Manifest API는 플랫폼, 아키텍처, 채널 필터링을 지원합니다:

• Platform: macOS (darwin)
• Architecture: arm64(Apple Silicon) 또는 x64(Intel)
• Channel: stable 또는 beta

API 응답

API는 다음 정보를 포함하는 응답을 반환합니다:

• latestVersion：최신 버전 번호
• required：필수 업데이트 여부
• notesUrl：릴리스 노트 URL
• artifactUrl：다운로드 URL
• artifactSha256：무결성 검증을 위한 SHA256 체크섬
• signature：디지털 서명 (선택)

업데이트 후

업데이트가 완료되면 다음 절차로 정상 동작을 확인합니다:

1. 설치 프로그램이 끝난 뒤 TeX64가 실행 중이 아니면 다시 엽니다
2. 설정 > 계정을 열어 현재/최신 버전 번호를 확인
3. 설정 > 환경을 열어 lualatex, latexmk, synctex 등이 정상 동작하는지 점검
4. 샘플 프로젝트를 빌드하여 정상 동작 확인

지원 버전

TeX64는 다음 환경에서 실행할 수 있습니다:

• macOS: 12.x (Monterey) 이상
• Architecture: Apple Silicon (arm64) 및 Intel (x64)
• 파일 형식: DMG (권장) 및 ZIP

Manifest API(/api/v2/updates/manifest)도 동일한 버전 요구 사항을 따릅니다.

업데이트가 실패한 경우

업데이트가 실패한 경우 다음 단계를 시도하세요:

1. /download 에서 최신 DMG를 수동으로 다운로드
2. TeX64를 완전히 종료(필요 시 Option+Command+Esc로 강제 종료)
3. 응용 프로그램 폴더에서 기존 TeX64.app 삭제
4. DMG 파일을 열어 새 TeX64.app을 응용 프로그램 폴더로 복사
5. TeX64를 실행하여 동작 확인
6. 설정 > 환경에서 환경 점검을 다시 실행

자주 발생하는 문제

인터넷 연결

업데이트 다운로드에는 안정적인 인터넷 연결이 필요합니다. 연결이 불안정하다면 /download 에서 수동 다운로드를 시도하세요.

디스크 용량

다운로드와 설치를 위해 충분한 여유 공간이 필요합니다. 최소 500 MB의 여유 공간을 확보하세요.

보안 소프트웨어

백신이나 방화벽 소프트웨어가 다운로드나 설치를 차단하지 않는지 확인하세요. 필요하다면 일시적으로 비활성화한 뒤 다시 시도하세요.

Gatekeeper

macOS Gatekeeper가 TeX64 실행을 차단하는 경우, Control+클릭하여 "열기"를 선택하거나 시스템 설정의 보안 및 개인 정보 보호에서 허용하세요.