Açık Kaynak · MITv0.1.0

Uygulama Yayınlarını Terminalden Çıkarın

searvia, App Store ve Google Play yayınları için TypeScript ile yazılmış açık kaynak bir komut satırı aracı. Mağaza metinlerinizi kodunuzun yanında düz dosyalarda tutar, yayımlamadan önce denetler ve yayının tamamını tek komutla incelemeye gönderir.

Kurmadan Çalıştırın
npx searvia --help

Node.js 20 ya da daha yenisi gerekir. Hesap gerekmez; kendi App Store Connect API anahtarınızı ve Google Play hizmet hesabınızı kullanır.

GitHub'daki Depoya Bakın

Ne Yapar

  • Mağaza Metinlerini İndirin ve Gönderin

    İki mağazadaki her dilin adını, alt başlığını, anahtar kelimelerini, açıklamalarını ve sürüm notlarını fastlane uyumlu klasörlere indirin, düzenleyicinizde düzenleyip geri gönderin.

  • Çevrimdışı ASO Denetimi

    Her dili ağa çıkmadan denetler: 100 baytlık anahtar kelime alanı, adda ve alt başlıkta zaten geçen tekrar kelimeler, karakter sınırları ve boş alanlar.

  • Ekran Görüntüsü Yükleme

    Ekran görüntülerini ve önizlemeleri dil ve cihaz başına yükler; önce Apple'ın ve Google'ın kesin piksel boyutlarını denetler, sırayı korur.

  • Derleme Yükleme

    Android App Bundle'ı bir Play kanalına, iOS derlemesini App Store Connect'e yükler ve işlenmesini bekler.

  • Tek Komutla İncelemeye

    App Store sürümünü açar, derlemeyi bağlar, ihracat uyumunu cevaplar ve gönderir; ya da bir Play sürümünü kademeli yayınla yükseltir.

  • İsteğe Bağlı Searvia Bağlantısı

    Searvia API anahtarıyla denetime kelime sıralarını, popülerliği ve yapay zekâ meta veri önerilerini ekler; Searvia uygulamasıyla aynı API ve MCP araçlarını kullanır.

Komutlar

terminal
npx searvia init              # detects fastlane folders and keys
npx searvia pull              # store text → ./fastlane/metadata
npx searvia audit             # offline ASO checks, no keys needed
npx searvia push              # shows the changes; add --yes to apply
npx searvia screenshots upload --yes
npx searvia build upload --ipa App.ipa --yes
npx searvia release --platform ios --ipa App.ipa --yes

Mağazaya yazan her komut önce değişiklikleri gösterir, yalnız --yes ile uygular. Tüm seçenekler için npx searvia <komut> --help yazın.

Zaten Bildiğiniz Dosyalar

fastlane uyumlu klasörler
fastlane/metadata/
  en-US/
    name.txt
    subtitle.txt
    keywords.txt
    description.txt
    release_notes.txt
  android/en-US/
    title.txt
    short_description.txt
    full_description.txt
    changelogs/default.txt

CI'da Kullanın

Anahtarlar ortam değişkenlerinden gelir; aynı komutlar GitHub Actions, GitLab CI ya da Bitrise'da çalışır. Başarısız bir denetim, mağazaya bir şey gitmeden işlem hattını durdurur.

.github/workflows/release.yml
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 20 }
      - run: npx searvia audit
      - run: npx searvia push
        env:
          ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
          ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
          ASC_PRIVATE_KEY: ${{ secrets.ASC_PRIVATE_KEY }}
          PLAY_SERVICE_ACCOUNT: ${{ secrets.PLAY_SERVICE_ACCOUNT }}
          SEARVIA_API_KEY: ${{ secrets.SEARVIA_API_KEY }}  # optional

Ekrandan mı yapmak istersiniz?

Aynı yayın akışı Searvia uygulamasında da var: iki mağaza için canlı kontrol listesi, ekran görüntüsü yükleme, derleme seçimi ve incelemeye gönderme; Apple'ın inceleme durumu değişince bildirim.