asc screenshot resize

このスキルを使用して、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

一般的な現在の device-type アンカー:

• IPHONE_65 - よく使われる 6.5 インチ iPhone スクリーンショットセット用
• IPAD_PRO_3GEN_129 - よく使われる 12.9/13 インチ iPad スクリーンショットセット用

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 は高さが最初で、その次に幅です:

# 例: ポートレート 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 を優先してください。