Ana içeriğe geç

Ekran Görüntüleri ve Uygulama Önizlemeleri

İndirme

ascelerate apps media download <bundle-id>
ascelerate apps media download <bundle-id> --folder my-media/ --version 2.1.0

Varsayılan olarak <bundle-id>-media/ dizinine indirir, yükleme tarafından beklenen aynı klasör yapısını kullanır.

Yükleme

# Bir klasörden yükleyin
ascelerate apps media upload <bundle-id> --folder media/

# Bir zip dosyasından yükleyin (ör. asc-screenshots'tan dışa aktarılmış)
ascelerate apps media upload <bundle-id> --folder screenshots.zip

# Belirli bir sürüme yükleyin
ascelerate apps media upload <bundle-id> --folder media/ --version 2.1.0

# Yüklemeden önce eşleşen setlerdeki mevcut medyayı değiştirin
ascelerate apps media upload <bundle-id> --folder media/ --replace

# İnteraktif mod: geçerli dizinden bir klasör veya zip seçin
ascelerate apps media upload <bundle-id>

--folder belirtilmediğinde, komut geçerli dizindeki tüm alt dizinleri ve .zip dosyalarını numaralı seçici olarak listeler. Zip dosyaları yüklemeden önce otomatik olarak açılır.

Klasör yapısı

Medya klasörünü locale ve display type alt klasörleriyle düzenleyin:

media/
├── en-US/
│ ├── APP_IPHONE_67/
│ │ ├── 01_home.png
│ │ ├── 02_settings.png
│ │ └── preview.mp4
│ └── APP_IPAD_PRO_3GEN_129/
│ └── 01_home.png
└── de-DE/
└── APP_IPHONE_67/
├── 01_home.png
└── 02_settings.png
  • 1. seviye: Locale (ör. en-US, de-DE, ja)
  • 2. seviye: Display type klasör adı (aşağıdaki tabloya bak)
  • 3. seviye: Medya dosyaları -- görseller (.png, .jpg, .jpeg) ekran görüntüsü olur, videolar (.mp4, .mov) uygulama önizlemesi olur
  • Dosyalar dosya adına göre alfabetik sırada yüklenir
  • Desteklenmeyen dosyalar uyarıyla atlanır

Display type'ları

App Store Connect, iPhone uygulamaları için APP_IPHONE_67 ve iPad uygulamaları için APP_IPAD_PRO_3GEN_129 ekran görüntülerini zorunlu tutar. Diğer tüm display type'lar isteğe bağlıdır.

Klasör adıCihazEkran görüntüleriÖnizlemeler
APP_IPHONE_67iPhone 6.7" (iPhone 16 Pro Max, 15 Pro Max, 14 Pro Max)ZorunluEvet
APP_IPAD_PRO_3GEN_129iPad Pro 12.9" (3. nesil+)ZorunluEvet
Tüm isteğe bağlı display type'lar
Klasör adıCihazEkran görüntüleriÖnizlemeler
APP_IPHONE_61iPhone 6.1" (iPhone 16 Pro, 15 Pro, 14 Pro)EvetEvet
APP_IPHONE_65iPhone 6.5" (iPhone 11 Pro Max, XS Max)EvetEvet
APP_IPHONE_58iPhone 5.8" (iPhone 11 Pro, X, XS)EvetEvet
APP_IPHONE_55iPhone 5.5" (iPhone 8 Plus, 7 Plus, 6s Plus)EvetEvet
APP_IPHONE_47iPhone 4.7" (iPhone SE 3. nesil, 8, 7, 6s)EvetEvet
APP_IPHONE_40iPhone 4" (iPhone SE 1. nesil, 5s, 5c)EvetEvet
APP_IPHONE_35iPhone 3.5" (iPhone 4s ve öncesi)EvetEvet
APP_IPAD_PRO_3GEN_11iPad Pro 11"EvetEvet
APP_IPAD_PRO_129iPad Pro 12.9" (1./2. nesil)EvetEvet
APP_IPAD_105iPad 10.5" (iPad Air 3. nesil, iPad Pro 10.5")EvetEvet
APP_IPAD_97iPad 9.7" (iPad 6. nesil ve öncesi)EvetEvet
APP_DESKTOPMacEvetEvet
APP_APPLE_TVApple TVEvetEvet
APP_APPLE_VISION_PROApple Vision ProEvetEvet
APP_WATCH_ULTRAApple Watch UltraEvetHayır
APP_WATCH_SERIES_10Apple Watch Series 10EvetHayır
APP_WATCH_SERIES_7Apple Watch Series 7EvetHayır
APP_WATCH_SERIES_4Apple Watch Series 4EvetHayır
APP_WATCH_SERIES_3Apple Watch Series 3EvetHayır
IMESSAGE_APP_IPHONE_67iMessage iPhone 6.7"EvetHayır
IMESSAGE_APP_IPHONE_61iMessage iPhone 6.1"EvetHayır
IMESSAGE_APP_IPHONE_65iMessage iPhone 6.5"EvetHayır
IMESSAGE_APP_IPHONE_58iMessage iPhone 5.8"EvetHayır
IMESSAGE_APP_IPHONE_55iMessage iPhone 5.5"EvetHayır
IMESSAGE_APP_IPHONE_47iMessage iPhone 4.7"EvetHayır
IMESSAGE_APP_IPHONE_40iMessage iPhone 4"EvetHayır
IMESSAGE_APP_IPAD_PRO_3GEN_129iMessage iPad Pro 12.9" (3. nesil+)EvetHayır
IMESSAGE_APP_IPAD_PRO_3GEN_11iMessage iPad Pro 11"EvetHayır
IMESSAGE_APP_IPAD_PRO_129iMessage iPad Pro 12.9" (1./2. nesil)EvetHayır
IMESSAGE_APP_IPAD_105iMessage iPad 10.5"EvetHayır
IMESSAGE_APP_IPAD_97iMessage iPad 9.7"EvetHayır
not

Watch ve iMessage display type'lar yalnızca ekran görüntülerini destekler -- bu klasörlerdeki video dosyaları uyarıyla atlanır. --replace flag'i, yenilerini yüklemeden önce eşleşen her setteki tüm mevcut varlıkları siler.

asc-screenshots ile kullanım

asc-screenshots, yapay zeka kodlama ajanları için üretime hazır App Store ekran görüntüleri oluşturan yardımcı bir skill'dir. Cihaz çerçeveleriyle reklam tarzı ekran görüntüsü düzenleri oluşturan bir Next.js sayfası yaratır ve bunları asc'nin beklediği klasör yapısında zip dosyası olarak dışa aktarır:

en-US/APP_IPHONE_67/01_hero.png
en-US/APP_IPAD_PRO_3GEN_129/01_hero.png
de-DE/APP_IPHONE_67/01_hero.png

Dışa aktarılan zip'i doğrudan yükleyin:

ascelerate apps media upload <bundle-id> --folder screenshots.zip --replace

Takılmış medyayı doğrulama ve yeniden deneme

Bazen ekran görüntüleri veya önizlemeler yüklemeden sonra "işleniyor" durumunda takılabilir. Durumu kontrol etmek ve isteğe bağlı olarak takılmış öğeleri yeniden denemek için media verify kullanın:

# Tüm ekran görüntüleri ve önizlemelerin durumunu kontrol edin
ascelerate apps media verify <bundle-id>

# Belirli bir sürümü kontrol edin
ascelerate apps media verify <bundle-id> --version 2.1.0

# Medya klasöründeki yerel dosyaları kullanarak takılmış öğeleri yeniden deneyin
ascelerate apps media verify <bundle-id> --folder media/

--folder olmadan komut salt okunur bir durum raporu gösterir. Tüm öğeleri tamamlanmış olan setler tek satırlık özet gösterir; takılmış öğeleri olan setler her dosyayı ve durumunu genişleterek gösterir. --folder ile takılmış öğeleri silip eşleşen yerel dosyalardan tekrar yüklemeyi teklif eder ve orijinal sıra düzenini korur.