> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 패키징 및 출시

installer를 만들고 빌드 완료와 출시 증거를 구분합니다.

## 초보자 연습

전제 조건: Rust 및 운영 체제 빌드 도구를 포함한 데스크톱 로컬 설정을 완료합니다. 설치 프로그램을 구축하기 전에 Tauri 개발 프로세스를 중지하십시오. 웹 백엔드를 실행 상태로 둡니다. 저장소 루트에서 아래의 각 검사를 실행하고 다음 검사를 실행하기 전에 완료될 때까지 기다립니다. 필터링된 패키지 명령은 데스크탑 전용 및 모든 플랫폼 체크아웃에서 작동합니다.

빠른 용어: 작업 영역은 한 팀의 별도 사용자, 데이터 및 설정입니다. 서버는 신뢰할 수 있는 백엔드입니다. 제공업체 키를 브라우저 및 전화 코드에 보관하세요. 마이그레이션은 테이블을 생성하거나 업데이트하는 버전이 지정된 데이터베이스 변경입니다. AI 모델은 응답하는 엔진입니다. 모델 카탈로그는 서버의 사용 가능한 모델 ID 및 가격 목록입니다. 공급자는 AI, 이메일, 청구 서비스와 같은 외부 서비스입니다. 자격은 작업 영역에서 기능을 사용할 수 있도록 하는 부여입니다. 웹훅은 한 서비스가 다른 서비스의 URL에 보내는 메시지입니다.

1. 로컬 지점에서 코딩 에이전트에게 `apps/desktop/src-tauri/tauri.conf.json`를 검사하고 제품 식별자, 앱 이름, 아이콘 및 백엔드 URL를 자신이 소유한 값으로 설정하도록 요청합니다. 릴리스 빌드에는 공개 HTTPS 백엔드 URL를 사용하세요.

2. 리포지토리 루트에서 아래 데스크탑 패키지 검사를 실행합니다. check:release-config 전에 데스크탑 로컬 설정에서 운영 체제 명령을 사용하여 이 터미널에서 SUPASTACK_APP_URL를 설정하십시오. 공개 HTTPS 백엔드가 실행 중이어야 하며 앱 식별자는 사용자 고유의 것이어야 합니다.

3. 성공적인 빌드는 설치 프로그램에 서명, 공증 또는 게시하지 않습니다. Rust 또는 시스템 라이브러리가 누락된 경우 데스크톱 로컬 설정을 완료하세요.

사용자 정의 코드의 경우 제공된 `prompts/README.md`로 시작하고 가장 가까운 프롬프트(앱 화면의 경우 `prompts/new-app-screen.md`, 공개 페이지의 경우 `prompts/new-landing-page.md`)를 복사합니다. 서버, 데이터베이스 또는 공급자 작업의 경우 코딩 에이전트에게 이 가이드의 작업을 제공하고 `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` 및 일치하는 `.ai/` 미러를 읽도록 요청하세요. 여기에 이름이 지정된 정확한 소스 파일을 검사하십시오. 편집하기 전에 파일을 나열하고 확인합니다. 작업 공간 소유권과 서버 전용 비밀을 보존합니다. 차이점을 보여주세요. 원하는 동작, 입력 및 출력 필드, 허용된 역할, 예상되는 성공 및 오류, 테스트 계정, 공급자 또는 장치를 알려주십시오. 샘플 값을 사용하십시오. 절대 진짜 비밀을 붙여넣지 마세요.

[시작하기 전에](https://supastack.dev/ko/docs/web/before-you-start.md)

[단말기 기본사항](https://supastack.dev/ko/docs/web/terminal-basics.md)

[데스크탑 로컬 설정](https://supastack.dev/ko/docs/desktop/ship-in-5-minutes.md)

[에이전트 프롬프트 및 프로젝트 메모리](https://supastack.dev/ko/docs/web/agents.md)

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## 제품 셸 구성

`src-tauri/tauri.conf.json`, Cargo 메타데이터, 기능 및 플랫폼 식별자를 검토합니다. 공유 자산 프로세스를 통해 앱 아이콘을 교체하고 빌드/런타임 시 의도한 백엔드 URL를 설정합니다. 호스팅된 웹앱은 이미 배포되어 연결 가능해야 합니다.


## 네이티브 빌드 게이트 실행

이러한 패키지 명령은 Rust 유형 검사 및 테스트를 실행하고, 릴리스 설정을 검증하고, Tauri 설치 프로그램을 빌드합니다. 서명 및 배포 구성은 대상 플랫폼과 계정/인증서에 따라 다릅니다. 서명 자료를 소스에 저장하지 마십시오.

```
corepack pnpm --filter @supastack/desktop typecheck
corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop build
```


## 대상 OS에서 설치 프로그램을 확인합니다.

새로 설치, 실행, 백엔드 연결 가능성, 인증, 메뉴/트레이, 단축키 등록, 두 번째 인스턴스, 딥 링크, 오프라인 재시도 및 제거를 확인하세요. 지원되는 각 OS를 별도로 확인하세요. 로컬 빌드는 서명 또는 공증된 상업용 배포를 증명하지 않습니다. 서명 구성, 업데이터 피드 및 릴리스 자동화는 포함되지 않습니다.

[네이티브 승인 체크리스트](https://supastack.dev/ko/docs/desktop/run.md)

[공유 백엔드 배포](https://supastack.dev/ko/docs/web/deployment.md)


## 설치 및 설정

설치 프로그램을 준비하기 전에 corepack pnpm --filter @supastack/desktop check:release-config를 실행하세요. SUPASTACK_APP_URL가 공용 호스트에서 자격 증명이 없는 HTTPS인지, Tauri 식별자가 제품별로 고유한지 확인합니다. 검사는 선택 사항이며 로컬 개발을 차단하지 않습니다.

corepack pnpm --filter @supastack/desktop build는 tauri 빌드를 실행합니다. tauri.conf.json의 번들 대상은 호스트 OS에서 사용 가능한 설치 프로그램 형식을 생성합니다. 즉, 제공하는 각 OS에 빌드하세요. apps/desktop/src-tauri/target/release/bundle/. 아래에 있는 유물

productName, 버전 및 식별자는 tauri.conf.json에 있습니다. 릴리스를 자르기 전에 버전을 확인하세요. icon-source.png에서 src-tauri/icons를 다시 작성하는 corepack pnpm --filter @supastack/desktop icons를 사용하여 아이콘을 다시 생성합니다.

```
corepack pnpm --filter @supastack/desktop check:release-config
corepack pnpm --filter @supastack/desktop icons
corepack pnpm --filter @supastack/desktop build
# artifacts: apps/desktop/src-tauri/target/release/bundle/
```


## 구현 워크플로

서명되지 않은 installer는 로컬 설치가 가능하지만 OS 신뢰 경고를 표시합니다. 코드 서명과 Apple 공증은 제품별 release 설정에서 처리하고 인증서를 repository가 아닌 비밀 저장소에 보관하세요.

release build에 프로덕션 SUPASTACK_APP_URL을 포함해 설치된 shell이 localhost가 아니라 배포된 Web 앱을 열게 하세요.


## 검증 및 문제 해결

각 대상 OS에 bundle을 설치하고 build, OS, 앱 URL을 기록하세요. 시작, 대상 배포 로드, tray, 단축키, 로그인 유지를 확인합니다. tauri build 완료만으로 출시가 검증되지는 않습니다.


설정을 계속하려면 [코드 서명](https://supastack.dev/ko/docs/desktop/signing.md) 가이드를 읽어보세요.


## 다음

[코드 서명](https://supastack.dev/ko/docs/desktop/signing.md)
