공개: 플랫폼 결론과 릴리즈 노트 규칙 반영
Some checks are pending
ci / server (push) Waiting to run
ci / web (push) Waiting to run
ci / desktop-windows (push) Waiting to run

This commit is contained in:
Ian 2026-04-16 13:54:11 +09:00
commit 799b975406
55 changed files with 1440 additions and 115 deletions

View file

@ -19,10 +19,14 @@ release-assets/
SHA256SUMS.txt
screenshots/
windows/
index.html
KoTalk-windows-x64.zip
KoTalk-windows-x64-onefile.exe
KoTalk-windows-x64-installer.exe
SHA256SUMS.txt
version.json
android/
index.html
KoTalk-android-universal.apk
SHA256SUMS.txt
version.json
@ -35,6 +39,8 @@ release-assets/
windows/
x64/
KoTalk-windows-x64-v0.2.0-alpha.1.zip
KoTalk-windows-x64-onefile-v0.2.0-alpha.1.exe
KoTalk-windows-x64-installer-v0.2.0-alpha.1.exe
SHA256SUMS.txt
android/
universal/
@ -46,14 +52,16 @@ release-assets/
- 같은 버전은 같은 서버 API 계약과 같은 릴리즈 노트를 공유합니다.
- Windows와 Android는 같은 태그 아래 병렬 산출물로 게시합니다.
- Windows 기본 공개 형식은 `zip`, Android 기본 공개 형식은 `apk`입니다.
- Windows 기본 공개 형식은 `installer exe + onefile exe + zip`, Android 기본 공개 형식은 `apk`입니다.
- APK는 공개 채널에 올릴 때 반드시 서명본을 사용합니다.
- `latest/version.json`은 전체 플랫폼 상태를 담고, `latest/windows/version.json`, `latest/android/version.json`은 플랫폼별 상세 포인터를 담습니다.
- `screenshots/`는 다운로드 미러와 변경 노트에서 참조하는 정적 자산입니다. 공개 릴리즈 페이지의 Assets 첨부에는 넣지 않습니다.
- `RELEASE_NOTES.ko.md`도 자산 첨부 대신 릴리즈 본문으로 사용합니다.
## 다운로드 경로 규칙
- 최신 Windows: `https://download-vstalk.phy.kr/windows/latest`
- 최신 Android: `https://download-vstalk.phy.kr/android/latest`
- 최신 Windows landing: `https://download-vstalk.phy.kr/windows/latest`
- 최신 Android landing: `https://download-vstalk.phy.kr/android/latest`
- 전체 최신 메타데이터: `https://download-vstalk.phy.kr/latest/version.json`
- 버전별 Windows: `https://download-vstalk.phy.kr/releases/<version>/windows/x64/...`
- 버전별 Android: `https://download-vstalk.phy.kr/releases/<version>/android/universal/...`
@ -69,6 +77,8 @@ release-assets/
--version v0.2.0-alpha.1 \
--channel alpha \
--windows-zip artifacts/release/KoTalk-windows-x64-v0.2.0-alpha.1.zip \
--windows-portable-exe artifacts/release/KoTalk-windows-x64-onefile-v0.2.0-alpha.1.exe \
--windows-installer-exe artifacts/release/KoTalk-windows-x64-installer-v0.2.0-alpha.1.exe \
--android-apk artifacts/release/KoTalk-android-universal-v0.2.0-alpha.1.apk \
--screenshots artifacts/screenshots \
--force
@ -87,11 +97,14 @@ release-assets/
- Forge Releases: 버전별 원본 보관
- 다운로드 미러: 최신 포인터와 빠른 정적 다운로드
- 모바일 웹앱: `release-assets/`가 아니라 `vstalk.phy.kr` 배포 트랙에서 별도 운영
- 공개 원격 릴리즈 페이지에는 ZIP/APK뿐 아니라 `screenshots/` 아래 최신 캡처도 함께 게시합니다.
- 공개 원격 릴리즈 페이지 Assets는 EXE/ZIP/APK, 최상위 `SHA256SUMS.txt`, 최상위 `version.json`만 유지합니다.
- 최신 스크린샷은 `release-assets/releases/<version>/screenshots/`에 보관하고, 릴리즈 노트 본문에서 직접 참조합니다.
## 운영 메모
- 생성된 버전별 산출물은 워크트리에 유지하며, 최신 로컬 검수와 서버 업로드 기준으로 사용합니다.
- 공개 릴리즈마다 `RELEASE_NOTES.ko.md`, `SHA256SUMS.txt`, `version.json`을 함께 갱신합니다.
- 같은 버전에서 Windows만 있고 Android가 아직 없을 수는 있지만, 장기 원칙은 `같은 버전 아래 두 플랫폼 병렬 게시`입니다.
- Windows latest landing은 설치형, onefile, 압축본을 동시에 노출합니다.
- Android latest landing은 APK 하나만 직접 노출하고, iOS는 저장소 Assets에 포함하지 않습니다.
- 모바일 웹앱 정적 산출물은 `release-assets/`가 아니라 `/srv/vs-messanger/webapp/releases/<version>`에 배포합니다.