Ana içeriğe geç

Yapılandırma

1. API Anahtarı Oluşturma​

App Store Connect > Users and Access > Integrations > App Store Connect API sayfasına gidin ve yeni bir anahtar oluşturun. .p8 özel anahtar dosyasını indirin.

2. Yapılandırma​

ascelerate configure

Bu komut Key ID, Issuer ID ve .p8 dosyanızın yolunu soracaktır. Özel anahtar, sıkı dosya izinleriyle (yalnızca sahip erişimi) ~/.ascelerate/ dizinine kopyalanır.

Yapılandırma ~/.ascelerate/config.json dosyasında saklanır:

{
    "keyId": "KEY_ID",
    "issuerId": "ISSUER_ID",
    "privateKeyPath": "/Users/.../.ascelerate/AuthKey_XXXXXXXXXX.p8"
}

configure ayrıca isteğe bağlı bir satıcı numarası sorar (App Store Connect → Payments and Financial Reports). Bu yalnızca Satış ve Finans raporları için gereklidir ve bir vendorNumber alanı olarak saklanır; bunu atlayıp daha sonra ekleyebilir veya her komutta --vendor-number ile geçebilirsiniz.

Apple Ads için ascelerate ayrı kimlik bilgilerine ihtiyaç duyar. Bunları ascelerate ads configure ayarlar ve aynı dosyadaki bir ads bölümüne kaydeder; configure komutunu yeniden çalıştırdığınızda bu bilgiler korunur.

Tek bir çalıştırma için anahtar​

Bir komutu başka bir anahtarla (başka bir ekip için ya da CI ortamında) çalıştırmak için üç ortam değişkeninin üçünü de ayarlayın. Bu değişkenler o çalıştırma için config.json dosyasının önüne geçer; dosya olduğu gibi kalır:

export ASCELERATE_KEY_ID=KEY_ID
export ASCELERATE_ISSUER_ID=ISSUER_ID
export ASCELERATE_PRIVATE_KEY_PATH=~/keys/AuthKey_KEY_ID.p8
ascelerate apps list

builds archive ve builds upload bu anahtarı xcodebuild komutuna da iletir (-authenticationKeyPath, -authenticationKeyID, -authenticationKeyIssuerID); böylece profiller, Xcode'da oturum açmış Apple Kimliği yerine bu anahtarla alınır. Bunun için anahtarın sertifikaları, tanımlayıcıları ve profilleri yönetme yetkisi olmalıdır. Bir çalıştırmanın hangi anahtarı kullandığını ascelerate configure --show gösterir.

3. Doğrulama​

Her şeyin çalıştığını doğrulamak için hızlıca bir komut çalıştırın:

ascelerate apps list

Kimlik bilgileriniz doğruysa, tüm uygulamalarınızın listesini göreceksiniz.

İstek kotası​

App Store Connect API'nin saatlik 3600 istek kotası vardır (kayan pencere). Mevcut kullanımınızı istediğiniz zaman kontrol edebilirsiniz:

ascelerate rate-limit
Hourly limit: 3600 requests (rolling window)
Used:         57
Remaining:    3543 (98%)