@kood/claude-code 0.6.6 → 0.7.0

package/templates/tauri/docs/guides/distribution.md

@@ -0,0 +1,261 @@
+# Distribution
+
+> Tauri v2 빌드, 코드 서명, 배포 가이드
+
+---
+
+## 빌드 명령어
+
+### 데스크톱
+
+```bash
+# 기본 빌드 (현재 플랫폼)
+npx tauri build
+
+# 특정 번들 포맷
+npx tauri build --bundles msi          # Windows MSI
+npx tauri build --bundles nsis         # Windows NSIS
+npx tauri build --bundles dmg          # macOS DMG
+npx tauri build --bundles app          # macOS App Bundle
+npx tauri build --bundles appimage     # Linux AppImage
+npx tauri build --bundles deb          # Linux Debian
+npx tauri build --bundles rpm          # Linux RPM
+
+# macOS Universal (ARM + Intel)
+npx tauri build --bundles app --target universal-apple-darwin
+
+# 디버그 빌드
+npx tauri build --debug
+
+# 빌드만 (번들링 스킵)
+npx tauri build --no-bundle
+```
+
+### 모바일
+
+```bash
+# Android
+npx tauri android build -- --aab        # AAB (Play Store)
+npx tauri android build -- --apk        # APK (사이드로딩)
+npx tauri android build -- --aab --target aarch64  # 특정 아키텍처
+
+# iOS
+npx tauri ios build                     # 일반 IPA
+npx tauri ios build --export-method app-store-connect  # App Store
+```
+
+---
+
+## Windows 배포
+
+### 인스톨러 형식
+
+| 형식 | 특징 |
+|------|------|
+| **NSIS** | 크로스 컴파일 가능, 커스텀 UI |
+| **MSI** | WiX 기반, Windows 전용 컴파일 |
+
+### WebView2 설치 모드
+
+```json
+// tauri.conf.json > bundle > windows
+{
+  "webviewInstallMode": {
+    "type": "downloadBootstrapper"
+  }
+}
+```
+
+| 모드 | 인터넷 | 크기 증가 | 설명 |
+|------|--------|----------|------|
+| `downloadBootstrapper` | 필요 | 없음 | 기본값, 최소 인스톨러 |
+| `embedBootstrapper` | 필요 | ~1.8MB | Windows 7 호환 |
+| `offlineInstaller` | 불필요 | ~127MB | 오프라인 환경 |
+| `skip` | - | 없음 | 비권장 |
+
+### NSIS 설정
+
+```json
+{
+  "bundle": {
+    "windows": {
+      "nsis": {
+        "oneClick": false,
+        "allowToChangeInstallationDirectory": true,
+        "createDesktopShortcut": true,
+        "createStartMenuShortcut": true,
+        "installMode": "both"
+      }
+    }
+  }
+}
+```
+
+### Windows 코드 서명
+
+```json
+// tauri.conf.json > bundle > windows
+{
+  "certificateThumbprint": "A1B1A2B2...",
+  "digestAlgorithm": "sha256",
+  "timestampUrl": "http://timestamp.comodoca.com"
+}
+```
+
+**인증서 준비:**
+```bash
+# PFX 변환
+openssl pkcs12 -export -in cert.cer -inkey private-key.key -out certificate.pfx
+
+# Thumbprint 확인: certmgr.msc > Details
+```
+
+---
+
+## macOS 배포
+
+### DMG 설정
+
+```json
+// tauri.conf.json > bundle > macOS > dmg
+{
+  "background": "./images/dmg-background.png",
+  "windowSize": { "width": 660, "height": 400 },
+  "appPosition": { "x": 180, "y": 220 },
+  "applicationFolderPosition": { "x": 480, "y": 220 }
+}
+```
+
+### macOS 코드 서명
+
+```bash
+# 서명 ID 확인
+security find-identity -v -p codesigning
+
+# 환경 변수 (CI/CD)
+export APPLE_CERTIFICATE=<base64-encoded-p12>
+export APPLE_CERTIFICATE_PASSWORD=<password>
+export APPLE_SIGNING_IDENTITY="Developer ID Application: Company (TEAM123)"
+
+# Notarization
+export APPLE_API_ISSUER=<issuer-id>
+export APPLE_API_KEY=<key-id>
+export APPLE_API_KEY_PATH=~/.appstoreconnect/private_keys/AuthKey_<KEY_ID>.p8
+```
+
+### macOS App Store 제출
+
+```bash
+# 1. Universal 빌드
+npx tauri build --bundles app --target universal-apple-darwin
+
+# 2. PKG 생성
+xcrun productbuild --component MyApp.app /Applications \
+  --sign "Mac Installer Distribution: Company (TEAM123)" MyApp.pkg
+
+# 3. 업로드
+xcrun altool --upload-app -f MyApp.pkg -t macos \
+  --apiKey $KEY_ID --apiIssuer $ISSUER_ID
+```
+
+**필수 Entitlements:**
+```xml
+<!-- Entitlements.plist -->
+<key>com.apple.security.app-sandbox</key>
+<true/>
+```
+
+---
+
+## Linux 배포
+
+| 포맷 | 명령어 | 대상 |
+|------|--------|------|
+| AppImage | `--bundles appimage` | 범용 |
+| Debian | `--bundles deb` | Ubuntu, Debian |
+| RPM | `--bundles rpm` | Fedora, RHEL |
+
+---
+
+## GitHub Actions CI/CD
+
+```yaml
+name: Build & Release
+on:
+  push:
+    branches: [release]
+
+jobs:
+  build:
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: macos-latest
+            args: '--target universal-apple-darwin'
+          - platform: ubuntu-22.04
+            args: ''
+          - platform: windows-latest
+            args: ''
+
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: aarch64-apple-darwin
+
+      - name: Install Linux deps
+        if: startsWith(matrix.platform, 'ubuntu-')
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libwebkit2gtk-4.1-dev \
+            libappindicator3-dev librsvg2-dev patchelf
+
+      - run: npm install
+
+      - uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
+        with:
+          tagName: v__VERSION__
+          releaseName: v__VERSION__
+          releaseDraft: true
+          args: ${{ matrix.args }}
+```
+
+---
+
+## 빌드 최적화
+
+### Cargo 프로필 설정
+
+```toml
+# src-tauri/Cargo.toml
+[profile.release]
+strip = true          # 디버그 심볼 제거
+lto = true            # Link-Time Optimization
+opt-level = "s"       # 사이즈 최적화 ("z"는 더 작지만 느림)
+codegen-units = 1     # 최적화 극대화 (빌드 느려짐)
+panic = "abort"       # 패닉 시 즉시 종료 (바이너리 축소)
+```
+
+### 번들 사이즈 참고
+
+| 구성 | 대략적 크기 |
+|------|-----------|
+| 최소 Tauri 앱 | ~600KB |
+| React + Vite | ~2-5MB |
+| + Plugin 몇 개 | ~5-15MB |
+| Electron 동급 앱 | ~150-300MB |

package/templates/tauri/docs/guides/getting-started.md

@@ -0,0 +1,302 @@
+# Getting Started
+
+> Tauri v2 + React + TypeScript + Vite 프로젝트 시작 가이드
+
+---
+
+## Prerequisites
+
+### 모든 플랫폼 공통
+
+```bash
+# Rust 설치
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+
+# Node.js (LTS)
+# https://nodejs.org/ 에서 설치
+```
+
+### macOS
+
+```bash
+# Xcode Command Line Tools
+xcode-select --install
+# 또는 App Store에서 Xcode 설치 (iOS 개발 시 필수)
+```
+
+### Windows
+
+1. **Visual Studio Build Tools** 설치
+   - "Desktop development with C++" 워크로드 선택
+   - MSVC 툴체인 기본 선택 확인
+2. **WebView2 Runtime** (Windows 10 v1803+ 기본 포함)
+3. **VBSCRIPT** feature (MSI 패키지 빌드 시)
+
+### Linux (Debian/Ubuntu)
+
+```bash
+sudo apt update
+sudo apt install -y libwebkit2gtk-4.1-dev build-essential curl wget \
+  libssl-dev libgtk-3-dev librsvg2-dev libappindicator3-dev patchelf
+```
+
+---
+
+## 프로젝트 생성
+
+### 방법 1: create-tauri-app (권장)
+
+```bash
+# npm
+npm create tauri-app@latest
+
+# 대화형 프롬프트:
+# - Project name: my-app
+# - Identifier: com.example.myapp
+# - Frontend language: TypeScript / JavaScript
+# - Package manager: npm (또는 pnpm, yarn)
+# - UI template: React
+# - UI flavor: TypeScript
+```
+
+### 방법 2: 기존 Vite 프로젝트에 추가
+
+```bash
+# 1. Vite + React + TS 프로젝트 생성
+npm create vite@latest my-app -- --template react-ts
+cd my-app
+npm install
+
+# 2. Tauri CLI 설치
+npm add -D @tauri-apps/cli@latest
+
+# 3. Tauri 초기화
+npx tauri init
+# - App name: my-app
+# - Window title: My App
+# - Web assets location: ../dist
+# - Dev server URL: http://localhost:5173
+# - Dev command: npm run dev
+# - Build command: npm run build
+
+# 4. Tauri API 패키지
+npm add @tauri-apps/api
+```
+
+---
+
+## 개발 시작
+
+```bash
+# 개발 서버 + Tauri 앱 실행
+npx tauri dev
+
+# 또는 package.json에 스크립트 추가
+# "tauri": "tauri"
+npm run tauri dev
+```
+
+**개발 모드 특징:**
+- Vite HMR (프론트엔드 변경 → 즉시 반영)
+- Rust 코드 변경 → 자동 재컴파일
+- DevTools 접근 가능
+
+---
+
+## 프로젝트 구조
+
+```
+my-app/
+├── src/                         # React + TypeScript (프론트엔드)
+│   ├── main.tsx                 # React 엔트리
+│   ├── App.tsx                  # 루트 컴포넌트
+│   ├── App.css
+│   └── components/
+├── src-tauri/                   # Rust (백엔드)
+│   ├── src/
+│   │   ├── main.rs              # 데스크톱 엔트리
+│   │   └── lib.rs               # 공유 로직 (모바일 지원)
+│   ├── capabilities/
+│   │   └── default.json         # 기본 권한
+│   ├── icons/                   # 앱 아이콘
+│   ├── Cargo.toml               # Rust 의존성
+│   ├── tauri.conf.json          # Tauri 설정
+│   └── build.rs                 # 빌드 스크립트
+├── public/                      # 정적 파일
+├── index.html
+├── package.json
+├── tsconfig.json
+└── vite.config.ts
+```
+
+---
+
+## Vite 설정
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+const host = process.env.TAURI_DEV_HOST;
+
+export default defineConfig({
+  plugins: [react()],
+  clearScreen: false,
+  server: {
+    port: 5173,
+    strictPort: true,              // Tauri가 기대하는 포트 보장
+    host: host || false,           // 모바일 물리 디바이스 개발 시
+    hmr: host
+      ? { protocol: 'ws', host, port: 1421 }
+      : undefined,
+    watch: {
+      ignored: ['**/src-tauri/**'], // Rust 재빌드 트리거 방지
+    },
+  },
+  envPrefix: ['VITE_', 'TAURI_ENV_*'],
+  build: {
+    target: process.env.TAURI_ENV_PLATFORM === 'windows'
+      ? 'chrome105'
+      : 'safari13',
+    minify: !process.env.TAURI_ENV_DEBUG ? 'esbuild' : false,
+    sourcemap: !!process.env.TAURI_ENV_DEBUG,
+  },
+});
+```
+
+---
+
+## Tauri 설정 (tauri.conf.json)
+
+```json
+{
+  "productName": "my-app",
+  "version": "0.1.0",
+  "identifier": "com.example.myapp",
+  "build": {
+    "beforeDevCommand": "npm run dev",
+    "beforeBuildCommand": "npm run build",
+    "devUrl": "http://localhost:5173",
+    "frontendDist": "../dist"
+  },
+  "app": {
+    "windows": [
+      {
+        "title": "My App",
+        "width": 1024,
+        "height": 768,
+        "resizable": true,
+        "fullscreen": false
+      }
+    ],
+    "security": {
+      "csp": {
+        "default-src": "'self' customprotocol: asset:",
+        "connect-src": "ipc: http://ipc.localhost",
+        "img-src": "'self' asset: http://asset.localhost blob: data:",
+        "style-src": "'unsafe-inline' 'self'"
+      }
+    }
+  },
+  "bundle": {
+    "active": true,
+    "icon": [
+      "icons/32x32.png",
+      "icons/128x128.png",
+      "icons/128x128@2x.png",
+      "icons/icon.icns",
+      "icons/icon.ico"
+    ]
+  }
+}
+```
+
+---
+
+## 첫 번째 Command 만들기
+
+### 1. Rust Command 정의
+
+```rust
+// src-tauri/src/lib.rs
+#[tauri::command]
+fn greet(name: &str) -> String {
+    format!("Hello, {}! You've been greeted from Rust!", name)
+}
+
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .invoke_handler(tauri::generate_handler![greet])
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}
+```
+
+```rust
+// src-tauri/src/main.rs
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    my_app_lib::run()
+}
+```
+
+### 2. 프론트엔드에서 호출
+
+```tsx
+// src/App.tsx
+import { useState } from 'react';
+import { invoke } from '@tauri-apps/api/core';
+
+function App() {
+  const [greeting, setGreeting] = useState('');
+  const [name, setName] = useState('');
+
+  async function handleGreet() {
+    const result = await invoke<string>('greet', { name });
+    setGreeting(result);
+  }
+
+  return (
+    <div>
+      <input value={name} onChange={(e) => setName(e.target.value)} />
+      <button onClick={handleGreet}>Greet</button>
+      <p>{greeting}</p>
+    </div>
+  );
+}
+
+export default App;
+```
+
+### 3. Capability 추가 (필요 시)
+
+```json
+// src-tauri/capabilities/default.json
+{
+  "identifier": "default",
+  "description": "기본 앱 권한",
+  "windows": ["main"],
+  "permissions": [
+    "core:default"
+  ]
+}
+```
+
+---
+
+## CLI 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `npx tauri dev` | 개발 모드 실행 |
+| `npx tauri build` | 프로덕션 빌드 |
+| `npx tauri icon <path>` | 앱 아이콘 생성 |
+| `npx tauri info` | 시스템 정보 출력 |
+| `npx tauri init` | Tauri 프로젝트 초기화 |
+| `npx tauri android init` | Android 프로젝트 초기화 |
+| `npx tauri ios init` | iOS 프로젝트 초기화 |
+| `npx tauri android dev` | Android 개발 모드 |
+| `npx tauri ios dev` | iOS 개발 모드 |