asc-screenshot-resize

asc スクリーンショットのサイズ変更

このスキルは、App Store Connect 用のスクリーンショットを準備するために使用します。このスキル内の固定サイズ表には依存しないでください。現在のサイズ一覧は CLI が管理します。

信頼できる情報源

まず asc で現在受け付けられているサイズを必ず確認してください。

asc screenshots sizes --output table
asc screenshots sizes --all --output table

アップロード前のローカル検証には、次を使用してください。

asc screenshots validate --path "./screenshots/iphone" --device-type "IPHONE_65" --output table
asc screenshots validate --path "./screenshots/ipad" --device-type "IPAD_PRO_3GEN_129" --output table

一般的なデバイスタイプの目安：

• 一般的な 6.5 インチ iPhone のスクリーンショットセットには IPHONE_65 を使用します。
• 一般的な 12.9／13 インチ iPad のスクリーンショットセットには IPAD_PRO_3GEN_129 を使用します。

6.9 インチ iPhone、Apple TV、Mac、Vision Pro、iMessage、Watch など、ほかのディスプレイタイプを対象とする場合は、asc screenshots sizes --all を実行してください。

ワークフロー

1. ファイル名を整える

macOS のスクリーンショットには、ツールで「有効なファイルではありません」というエラーを引き起こす、見えない Unicode 空白が含まれていることがあります。まとめて処理する前に、ファイル名を整えてください。

python3 -c "
import os
for f in os.listdir('.'):
    clean = f.replace('\u202f', ' ')
    if f != clean:
        os.rename(f, clean)
        print(f'Renamed: {clean}')
"

2. 寸法とメタデータを確認する

sips -g pixelWidth -g pixelHeight screenshot.png
sips -g hasAlpha -g space screenshot.png

App Store Connect は、アルファ透明度を含むスクリーンショットを拒否します。JPEG に変換してアルファを取り除いてください。

sips -s format jpeg input.png --out /tmp/asc-screenshot-no-alpha.jpg
sips -s format png /tmp/asc-screenshot-no-alpha.jpg --out output.png
rm /tmp/asc-screenshot-no-alpha.jpg

PNG からアルファをまとめて取り除きます。

for f in *.png; do
  if sips -g hasAlpha "$f" | grep -q "yes"; then
    sips -s format jpeg "$f" --out /tmp/asc-screenshot-no-alpha.jpg
    sips -s format png /tmp/asc-screenshot-no-alpha.jpg --out "$f"
    rm /tmp/asc-screenshot-no-alpha.jpg
    echo "Stripped alpha: $f"
  fi
done

3. asc で対象サイズを選んでからサイズを変更する

asc screenshots sizes --all の一覧から幅と高さを選びます。sips -z は高さ、幅の順に指定します。

# Example: portrait IPHONE_65 1284 x 2778
sips -z 2778 1284 input.png --out output.png

選択したサイズにまとめて変更します。

mkdir -p resized
for f in *.png; do
  sips -z 2778 1284 "$f" --out "resized/$f"
done

4. asc で出力を検証する

sips -g pixelWidth -g pixelHeight -g hasAlpha resized/*.png
asc screenshots validate --path "./resized" --device-type "IPHONE_65" --output table

5. 検証後にのみアップロードする

asc screenshots upload --version-localization "LOC_ID" --path "./resized" --device-type "IPHONE_65" --dry-run --output table
asc screenshots upload --version-localization "LOC_ID" --path "./resized" --device-type "IPHONE_65"

注意事項

• asc screenshots sizes --all を正式な情報源として扱ってください。Apple のサイズ要件は変更されることがあります。
• ユーザーが見た目への影響を受け入れない限り、縦横比が合わないスクリーンショットを引き伸ばさないでください。
• 元のファイルを保持するため、必ず別のファイルまたはディレクトリに出力してください。
• スクリーンショットは PNG または JPEG 形式で、アルファ透明度を含まない必要があります。
• 必要に応じて、Display P3 などの色空間を sRGB に変換してください。

sips -m "/System/Library/ColorSync/Profiles/sRGB IEC61966-2.1.icc" input.png --out output.png

• アップロード前の確認には、目視よりも asc screenshots validate を優先してください。