App Store 스크린샷 현지화
승인된 아트워크는 보존하고 마케팅 카피만 현지화합니다. 설치된 폰트로 확정적으로 최종 텍스트를 렌더링하고, 승인된 카피 영역 내에서만 합성하며, 원격 전송을 위해 asc 리뷰/적용을 사용합니다.
워크플로우
- 소스 PNG, 순서, 치수, 기기 패밀리, 기존 원격 스크린샷을 목록화합니다.
- 시장에 맞는 카피를 작성합니다. 판매 아이디어를 보존하고, 어색한 문구가 나오면 직역하지 않습니다. 줄바꿈은 의도적으로 유지합니다.
- 편집 전에 모든 소스 이미지를 검사합니다.
- 소스 마케팅 카피만 제거하여 깨끗한 마스터를 준비합니다. 기존 승인된 깨끗한 마스터를 선호합니다. 정리가 필요한 경우, 빡빡한 마스크를 사용하고 외부의 모든 픽셀을 보존합니다.
scripts/render_localized_text.py로 정확한 현지화된 카피를 렌더링합니다. 글리프 커버리지가 확인된 설치 폰트를 사용하며, 최종 텍스트를 그리기 위해 이미지 생성을 절대 사용하지 않습니다.- 빡빡한 텍스트 영역 상자를 정의하고 최종 비트맵이 승인된 소스와 해당 상자 내에서만 다른지 확인합니다.
- 레이블이 지정된 콘택트 시트를 검토한 다음, 모든 CJK 제목을 100% 배율로 검사하여 정확한 글리프, 철자, 줄바꿈, 계층 구조 및 정리 이음새를 확인합니다.
- 치수, RGB 불투명도, 파일 개수, 순서, 정확한 매니페스트 카피, 허용된 각 영역 외부의 변경된 픽셀 0개를 검증합니다.
- ASC 리뷰 아티팩트를 생성하고, 검사하고, 승인하고, 계획된 그룹이 의도된 로케일/디스플레이 유형 매트릭스와 정확히 일치하는 경우에만 plan/apply로 업로드합니다. 명시적 승인 없이 원격 스크린샷을 절대 삭제하거나 교체하지 않습니다.
- 원격 스크린샷을 다시 나열하고 로케일, 기기 패밀리, 개수 및 처리 상태를 확인합니다.
이미지 생성 경계
최종 현지화된 카피를 렌더링하도록 이미지 모델에 요청하지 마십시오. 생성 텍스트에는 프롬프트에 동일한 단어가 정확히 명시된 경우에도 대체된 글리프, 잔여물 또는 환각 문자가 포함될 수 있습니다.
로컬에서 깨끗한 배경 패치를 생성할 수 없는 경우에만 이미지 생성을 사용하고, 교체가 아닌 제거를 요청하십시오:
사용 사례: precise-object-edit
자산 유형: 현지화된 App Store 스크린샷을 위한 깨끗한 마스터
입력 이미지: 편집 대상
기본 요청: 기존 마케팅 카피만 제거하고 배경을 재구성하십시오.
제약 조건: 배경, 기기 목업, 원근감, 조명, 모든 제품 화면 픽셀, 색상, 자르기, 종횡비를 보존하십시오. 제품 UI를 번역하거나 다시 그리지 마십시오.
피해야 할 사항: 텍스트, 문자, 기호, 워터마크, 리디자인, 기기 변경, UI 변경, 제품 이미지 변경.
구성이나 보호된 아트워크가 변경되면 결과를 거부하십시오. 전체 생성된 비트맵을 사용하지 말고, 허용된 영역 내에서 검토된 정리 패치만 합성하십시오.
확정적 구성
소스 카피가 질감 배경에 가벼운 경우 로컬에서 깨끗한 마스터를 준비하십시오:
python scripts/prepare_clean_master.py \
--source /path/to/approved.png \
--output /path/to/clean-master.png \
--box x,y,width,height
JSON 매니페스트에서 정확한 텍스트를 렌더링하십시오:
python scripts/render_localized_text.py --manifest /path/to/text-manifest.json
python scripts/verify_localized_text.py --manifest /path/to/text-manifest.json
references/manifest.md의 스키마를 사용하여 JSON 매니페스트를 만든 다음 실행하십시오:
python scripts/compose_localized_patch.py --manifest /path/to/manifest.json
이 스크립트는 생성된 편집본을 정확한 소스 치수로 크기 조정하고, 허용된 직사각형과 페더링된 가장자리 내에서만 혼합하며, 불투명 RGB PNG를 쓰고, 허용된 영역 외부에서 디코딩된 픽셀이 소스와 동일한지 확인합니다.
모델 드리프트를 숨기기 위해 상자를 넓히지 마십시오. 마케팅 카피 주위로 조이십시오. 허용된 영역에 제품 UI를 절대 포함하지 마십시오.
App Store QA
- 다른 Apple 디스플레이 유형을 대상으로 하지 않는 한 소스 치수를 보존하십시오.
- 불투명 RGB 출력을 요구하고, 알파가 포함된 PNG는 거부하십시오.
- 스토어프론트 및 디스플레이 유형별로 하나의 정렬된 세트를 유지하십시오.
- 시장에 적합한 폰트/글리프를 사용하고 CJK 출력을 육안으로 검사하십시오.
- 모든 제목을 썸네일 배율로, 모든 부제목을 100% 배율로 확인하십시오.
- 보이는 카피를 검토된 매니페스트와 문자 그대로 비교하십시오. OCR은 라틴 문자 QA를 도울 수 있지만 시각적 CJK 검사를 대체하지는 않습니다.
- 잔여 소스 문자, 중복 획, 대체 글리프, 토후 상자, 예상치 못한 구두점 또는 모델 생성 텍스트를 거부하십시오.
- 외부 영역 픽셀 변경 0개를 하드 불변 값으로 처리하십시오.
ASC 업로드 안전성
업로드 전에 설치된 asc-shots-pipeline 및 asc-cli-usage 스킬을 읽으십시오. asc screenshots --help 및 명령별 --help로 현재 플래그를 확인하십시오.
선호:
asc screenshots review-generate --framed-dir OUTPUT_ROOT --output-dir REVIEW_DIR
asc screenshots review-open --output-dir REVIEW_DIR
asc screenshots review-approve --all-ready --output-dir REVIEW_DIR
asc screenshots plan --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --output json
asc screenshots apply --app APP_ID --version VERSION --review-output-dir REVIEW_DIR --confirm --output json
plan/apply가 의도된 로케일 매핑을 표현할 수 없는 경우, 정확한 버전-로컬라이제이션 ID를 확인하고 해당 로케일에 대해서만 asc screenshots upload를 사용하십시오. 전후에 스크린샷을 나열하십시오. 업로드가 기존 스크린샷을 대체한다고 가정하지 말고, 먼저 CLI 동작 및 Apple 제한을 검사하십시오.
일부 치수는 여러 Apple 디스플레이 유형에서 허용됩니다. 예를 들어, 1290x2796은 APP_IPHONE_67 및 APP_IPHONE_69 모두로 검증될 수 있습니다. plan 출력이 디스플레이 유형 간에 동일한 파일을 중복하는 경우 적용하지 마십시오. 일치하는 드라이 런 후에 명시적 --device-type으로 앱 범위 업로드를 실행하십시오:
asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67 --dry-run
asc screenshots upload --app APP_ID --version-id VERSION_ID --path OUTPUT_ROOT --device-type APP_IPHONE_67
리소스
scripts/compose_localized_patch.py: 픽셀 잠금 구성 및 검증.references/manifest.md: 매니페스트 스키마 및 예제.