# Sürüm Yayınlama

https://dev.wisecp.com/tr/pazar-yeri-surum-yayinlama

Yayındaki bir ürünün yeni sürümünü çıkarın: sürüm neyi taşır, nasıl incelenir ve ürünü kurmuş sistemler bunu nasıl öğrenir.

## Genel Bakış

Ürün kaydı bir kez incelenir. Ürün ise değişmeye devam eder, bu yüzden ilkinden sonraki her sürüm ayrı bir kayıt olarak gider: bir numara, bir değişiklik listesi ve paketin tamamı. Moderatörlere teslim edilir ve kendi başına onaylanır.

Yayına alan şey onaydır. Moderatör onaylayana kadar yayındaki üründe hiçbir şey değişmez ve hiçbir sisteme haber verilmez. Onaydan sonra kayıt yeni sürümü söyler ve katalog yeni paketi verir.

## Ön Koşullar

- **Yayında bir ürün kaydı**: Yalnız yayındaki ürünün bir sonraki sürümü olur. Taslak hâlâ ilk gönderimindedir; reddedilmiş ya da emekli kaydın güncelleyecek bir şeyi yoktur.
- **Yayındakinden büyük bir numara**: Karşılaştırma metin olarak değil parça parça yapılır, yani 1.10.0 sürümü 1.9.0 sürümünden büyüktür. Daha önce kullanılmış numara da geri çevrilir.
- **Ürünün tamamı**: Paket eksiksiz bir derlemedir, yama değil. Müşteri tarafında ürünün dizininin yerine geçer.
- **Satır satır yazılabilir bir değişiklik listesi**: En çok 40 satır, her satır en çok 300 karakter ve her satır bir türe bağlı.

## Yapı

Sürüm editörü ürün editörüyle aynı biçimdedir: hazırlık göstergeli bölümler ve gönderimde bölümleri sunucuda yeniden sayan bir işlem.

| Bölüm | Neyle tamamlanır |
| --- | --- |
| Detaylar | Ürün, sürüm numarası ve en az bir değişiklik satırı |
| Paket | O sürümün eksiksiz derlemesi |
| Lisanslama | Kayıttan miras alınır, siz değiştirmedikçe zaten tamamdır. Ürünün fiyatından bağımsız sorulur |
| İnceleme | Ürün kaydındaki gibi onaylar |

Her değişiklik satırının bir türü vardır ve listeyi gösteren her ekran satırları bu türe göre gruplar: **özellikler**, **iyileştirmeler**, **güvenlik**, **düzeltmeler**, **değişenler**. Tek bir serbest paragraf kimsenin taramadığı bir metindir; türlü liste ise bir bakışta güvenlik düzeltmesi olup olmadığını söyler.

## Adım Adım

### Sürümü hazırlayın

1. Geliştirici portalında **Sürümler** sayfasını açın ve yeni bir sürüm başlatın. Ürünü seçin; seçici yalnız yayındaki kayıtları sunar.
2. Sürüm numarasını girin. Yayındaki numara alanın yanında görünür, böylece "daha büyük olmalı" kuralı sayfada bir olgudur.
3. Değişiklikleri satır satır yazın ve her satıra türünü verin.
4. O sürümün paketini yükleyin; bu derleme uyumluluk aralığını değiştirdiyse aralığı da güncelleyin.

### Lisans tanımını gözden geçirin

1. Sürüm, ücretli ya da ücretsiz olsun, kaydının lisans tanımını taşır. Dokunmazsanız bölüm zaten tamamdır.
2. Adres ya da kimlik bilgileri değiştiyse burada güncelleyin ve testi burada çalıştırın. Alanlar ve bağlama: [Pazar Yeri Ürününü Lisanslama](https://dev.wisecp.com/tr/pazar-yeri-urun-lisanslama).
3. Değiştirdiğiniz tanım bu sürümde bekler. Kayda ancak moderatör onayladığında geçer, böylece anahtar ile onu taşıyan paket birlikte gider.

### Gönderin ve bekleyin

1. Sürümü gönderin. *Gönderildi* durumuna geçer, paket dondurulur ve editör yalnızca bilgi amaçlı açılır.
2. Geri çekme, yalnızca gönderilmiş durumdayken açıktır. Moderatör sürümü üstlendiğinde durum *İnceleniyor* olur ve geri çekme kapanır.
3. Ret bir gerekçe taşır ve hesabınıza bildirim olarak gelir. Gerekçeyi giderip yeniden gönderin.

### Onaydan sonra

1. Kayıt artık bu sürümü söyler ve sizinkinden derlenmiş paketi verir.
2. Ürünü kurmuş sistemler günde bir kez sorar ve güncelleme onlara sunulur.
3. Hiçbir şey kendiliğinden kurulmaz. Operatör değişiklik listesini okur ve kararı verir.

## Referans

Onayın sürümden ürün kaydına aynı anda taşıdıkları.

- **Sürüm**: Kayıt bu numarayı söylemeye başlar ve karşılaştırma bundan sonra buna göre yapılır.
- **Paket**: İndirme de güncelleme akışı da bu derlemeyi vermeye başlar.
- **Uyumluluk aralığı**: Yalnız bu sürüm bir aralık belirlediyse taşınır. Böylece kayıt, verdiği dosyada olmayan bir gereksinimi hiç ilan etmez.
- **Lisans tanımı**: Yalnız bu sürüm bir tanım beklettiyse taşınır. Yayındaki bir kaydın onaylı tanımı yalnızca böyle değişir.

Güncelleme yalnız üç koşul birlikte sağlandığında sunulur. Biri düşerse cevap hata değil "yayınlanmış bir şey yok" olur, çünkü alıcının bir kusuru yoktur.

| Koşul | Nedeni |
| --- | --- |
| Ürün kaydı yayında | Emekli ya da reddedilmiş ürünün kimseye göndereceği bir şey yoktur. |
| Geliştirici hesabı aktif | Burada kapatılmış bir stüdyo müşteri panellerine kod göndermez. |
| Arkasındaki müşteri hesabı aktif | Siz de burada bir müşterisiniz ve kapanmış hesap artık dosya teslim etmez. |

## Örnek

Kurulmuş bir pazar yeri ürünü, hangi kayıttan geldiğini söyleyen bir künye taşır. Dizin adı sizin seçiminizdir ve iki stüdyo aynı adı seçebilir, bu yüzden kimlik olarak kayıt numarası gider.

```json
{"type": "marketplace", "id": 42, "version": "1.2.0", "last_updated": "2026-08-06"}
```

Sistem bu numarayı sorar ve o kayıt için yayınlanmış olanı okur.

```bash
GET /api/v1/marketplace/releases/42?version=1.2.0&lang=tr
```

## Tuzaklar

> **Yama bir sürüm değildir**
> 
> Paket ürünün dizininin yerine geçer. Yalnız değişen dosyaları gönderirseniz koymadığınız her şey müşterinin kopyasından silinir.

> **Gönderilmiş sürüm dondurulur**
> 
> Karar beklerken paket değiştirilemez. Sürümü yalnızca gönderilmiş durumdayken geri çekebilir, aksi hâlde cevabı beklersiniz.

> **Şema değişiklikleriniz kendini uygulamalı**
> 
> Güncelleme yolunda sizin bir betiğiniz çalışmaz. Göçler normal bir kod yolundan, güvenli biçimde ve her istekte uygulanır.

## İlgili Makaleler

- [Ürün Yayınlama](https://dev.wisecp.com/tr/pazar-yerinde-urun-yayinlama)
- [Pazar Yeri Ürününü Lisanslama](https://dev.wisecp.com/tr/pazar-yeri-urun-lisanslama)
- [Modül Güncellemesi Yayınlama](https://dev.wisecp.com/tr/modul-guncellemesi-yayinlama)
- [Modülü Dağıtıma Hazırlama](https://dev.wisecp.com/tr/modulu-dagitima-hazirlama)