#Screenshot Tools (한국어)

App Store 로컬라이제이션을 위한 앱 스크린샷 번역 및 리사이징 도구입니다.

#개요

스크린샷 워크플로우는 두 개의 별도 도구로 구성됩니다:

1. translate-screenshots: Gemini API를 사용하여 스크린샷의 텍스트 번역
2. resize-screenshots: 번역된 스크린샷을 App Store 규격으로 리사이징

이렇게 분리하면:

• 최종 처리 전에 원본 번역 이미지 검토 가능
• 재번역 없이 리사이징만 다시 실행 (API 비용 절약)
• 로케일별로 다른 리사이징 설정 사용 가능

#워크플로우

1. translate-screenshots → raw/ 폴더에 저장
2. resize-screenshots   → raw/에서 읽어서 최종 위치에 저장

#디렉토리 구조

public/products/{app-slug}/screenshots/
├── en-US/                    # 소스 (기본 로케일)
│   └── phone/
│       ├── 1.png
│       └── 2.png
├── ko-KR/
│   └── phone/
│       ├── raw/              # 번역됨 (리사이징 안됨)
│       │   ├── 1.png
│       │   └── 2.png
│       ├── 1.png             # 최종 (리사이징됨)
│       └── 2.png
└── ja-JP/
    └── phone/
        ├── raw/
        └── ...

#translate-screenshots

Gemini API를 사용하여 앱 스크린샷의 텍스트를 여러 언어로 번역합니다.

#요구사항

• GEMINI_API_KEY 또는 GOOGLE_API_KEY 환경 변수
• 소스 스크린샷: public/products/{slug}/screenshots/{locale}/phone/ 및 /tablet/
• 로케일 파일: public/products/{slug}/locales/

#모델 선택

• imageModel: "flash" (기본값): gemini-3.1-flash-image-preview 사용 (속도/비용 효율)
• imageModel: "pro": gemini-3-pro-image-preview 사용 (지시 충실도 우선)

#입력 파라미터

#사용 예시

{
  "appName": "my-app",
  "targetLocales": ["ko-KR", "ja-JP"],
  "deviceTypes": ["phone"],
  "preserveWords": ["MyApp", "Pro"],
  "imageModel": "pro"
}

#지원 언어

Gemini API 지원: 영어, 아랍어, 독일어, 스페인어, 프랑스어, 힌디어, 인도네시아어, 이탈리아어, 일본어, 한국어, 포르투갈어, 러시아어, 우크라이나어, 베트남어, 중국어

#resize-screenshots

번역된 스크린샷을 App Store 규격으로 리사이징합니다.

#목표 크기

#입력 파라미터

#배경색

리사이즈 도구는 빈 공간을 배경색으로 채웁니다. config.json에서 설정할 수 있습니다:

{
  "metadata": {
    "screenshotBgColor": "#FFFFFF"
  }
}

지정하지 않으면 이미지 모서리에서 주요 색상을 자동 감지합니다.

#사용 예시

{
  "appName": "my-app",
  "targetLocales": ["ko-KR"],
  "deviceTypes": ["phone"]
}

#설정

#config.json

제품의 config.json에 스크린샷 설정을 추가합니다:

{
  "slug": "my-app",
  "metadata": {
    "screenshotBgColor": "#000000"
  }
}