kotalk/DEVELOPMENT.md

Development Guide

Naming Note

공개 브랜드는 KoTalk이지만, 현재 저장소의 프로젝트 파일과 네임스페이스는 아직 PhysOn.*를 사용합니다. 문서 개편이 먼저 진행 중이며, 코드 네임스페이스 정렬은 별도 작업으로 다룹니다.

Requirements

• .NET 8 SDK
• Git
• Node.js 20+
• Windows portable 빌드를 만들려면 win-x64 publish 가능한 .NET 환경

Android 채널을 다룰 때는 아래가 추가로 필요합니다.

• OpenJDK 17+
• .NET Android workload
• Android SDK / cmdline-tools

Quick Start

git clone <repository-url>
cd vs-messanger
dotnet build PhysOn.sln -c Debug

Run The API

dotnet run --project src/PhysOn.Api --urls http://127.0.0.1:5082

기본 확인 URL:

• http://127.0.0.1:5082/health
• http://127.0.0.1:5082/

접근 게이트나 시드 값은 공개 문서에 고정하지 않습니다. 필요한 값은 로컬 환경 변수나 비공개 배포 설정에서 넣어야 합니다.

Run The Desktop Client

dotnet run --project src/PhysOn.Desktop

기본 입력값:

• 서버 주소: http://127.0.0.1:5082

Run The Mobile Web Client

cd src/PhysOn.Web
npm install
npm run dev

기본 개발 주소:

• 웹앱: http://127.0.0.1:4173
• API 프록시 기본값: http://127.0.0.1:5082

Test

dotnet test tests/PhysOn.Api.IntegrationTests/PhysOn.Api.IntegrationTests.csproj

필요 시 전체 확인:

dotnet build PhysOn.sln -c Debug
dotnet test PhysOn.sln -c Debug

Release Builds

Windows:

./scripts/release/build-windows-distributions.sh \
  --version 2026.04.16-alpha.6

생성물:

• KoTalk-windows-x64-<version>.zip
• KoTalk-windows-x64-onefile-<version>.exe
• KoTalk-windows-x64-installer-<version>.exe

Android:

./scripts/release/build-android-apk.sh \
  --version 2026.04.16-alpha.6

공개 산출물 네이밍은 KoTalk-* 기준으로 정리하는 방향이고, 현재 내부 스크립트와 프로젝트명은 별도 정렬 단계에 있습니다.

Release Metadata

./scripts/release/release-prepare-assets.sh \
  --version 2026.04.16-alpha.6 \
  --channel alpha \
  --windows-zip artifacts/builds/2026.04.16-alpha.6/KoTalk-windows-x64-2026.04.16-alpha.6.zip \
  --windows-portable-exe artifacts/builds/2026.04.16-alpha.6/KoTalk-windows-x64-onefile-2026.04.16-alpha.6.exe \
  --windows-installer-exe artifacts/builds/2026.04.16-alpha.6/KoTalk-windows-x64-installer-2026.04.16-alpha.6.exe \
  --android-apk artifacts/builds/2026.04.16-alpha.6/KoTalk-android-universal-2026.04.16-alpha.6.apk \
  --screenshots artifacts/screenshots \
  --force

Deployment Notes

• 공개 웹 진입점: vstalk.phy.kr
• 공식 다운로드 미러: download-vstalk.phy.kr
• 저장소 릴리즈 경로: RELEASING.md

실제 호스트 주소, 관리자 계정, 배포용 비밀값은 공개 문서에 적지 않습니다.

Troubleshooting

Desktop window does not open on Linux/WSL

• X 서버 또는 데스크톱 세션이 있는지 확인합니다.
• GUI가 없는 환경이면 API와 테스트만 먼저 확인합니다.

Download links do not open

• download-vstalk.phy.kr DNS와 HTTPS 상태를 확인합니다.
• 저장소 릴리즈 경로가 최신인지 함께 확인합니다.

Web app does not open

• vstalk.phy.kr DNS와 프록시 상태를 확인합니다.
• 정적 파일 배포 루트가 맞는지 확인합니다.