For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
데스크톱 앱 문제 해결
빌드를 막기 전에 누락된 도구 체인, 빈 창, 릴리스 서명 실패를 해결합니다.
설치 및 설정
Windows에서는 Windows SDK가 포함된 C++ 빌드 도구와 WebView2 런타임을 설치합니다. macOS에서는 Xcode 명령줄 도구를 설치합니다. Linux에서는 배포판에 맞는 WebKitGTK, 컴파일러, 트레이, 시스템 패키지를 설치합니다. rustup으로 Rust를 설치하고 터미널을 다시 연 뒤 Tauri를 시작하기 전에 cargo check를 실행하세요.
빈 창은 보통 SUPASTACK_APP_URL에 접근할 수 없거나 중지된 개발 서버를 가리킨다는 뜻입니다. 로드된 페이지가 네트워크를 잃으면 오프라인 배너가 나타납니다. 같은 머신의 브라우저에서 URL이 열리는지, 의도한 값으로 빌드했는지 확인하세요.
구현 워크플로
릴리스 실패는 보통 서명, 공증, 업데이터 블록에서 발생합니다. macOS에서는 인증서와 키체인, Windows에서는 서명 인증서와 타임스탬프 서버, 업데이터 공개 키와 엔드포인트 경로, 제품 식별자를 확인합니다. 릴리스 구성 검사를 다시 실행한 뒤 개발 빌드 위가 아니라 깨끗한 머신에 산출물을 설치하세요.
검증 및 문제 해결
앱이 시작되고 백엔드에 도달하며 깨끗하게 설치됩니다.