APK'lar ve Parçalar

Google Play Geliştirici API'si, uygulamalarınız için yeni APK'lar yüklemenize ve bunları farklı sürüm kanallarına yayınlamanıza olanak tanır. Bu, uygulamanızın onaylı kullanıcılara sunulan alfa ve beta sürümlerini dağıtmanıza olanak tanır. Bu aynı zamanda, otomatik olarak az sayıda uygulamanın kullanıcısına sunulan aşamalı sunum sürümünü dağıtmanıza da olanak tanır. Aşamalı sunum sürümünü yayınladıktan sonra, uygulamanın bu sürümünü alan kullanıcıların sayısını, sonunda "üretim" sürümü olarak dağıtana kadar kademeli olarak artırabilirsiniz.

APK'ları Ekleme ve Değiştirme

1. Edits.apks: install yöntemini çağırarak bir veya daha fazla APK yükleyin.

   Bu yöntem, APK'yı bir depolama "paketine" yükler ve burada kullanıcılara dağıtmak için bir "kanala" atanabilir. (Düzenleme silinir veya silinirse bu düzenlemeye yüklenen APK'lar da kaybolur.)

2. Edits.tracks: update yöntemini çağırarak "kanallardaki" APK'ları yayınlayın. APK'ları aşağıdaki kanallarda yayınlayabilirsiniz:

   • "alpha" ve "beta" gibi test kanalları

     Uygulamanın alfa ve beta sürümleri, alfa ve beta test gruplarına atadığınız kullanıcılara dağıtılır. Kullanıcıları bu gruplara Google Play Console'u kullanarak atarsınız.

   • Dahili test kanalı: "qa"

     Uygulamanızın dahili sürümleri, Google Play Console'da yapılandırıldığı şekilde dahili test kanalınıza dağıtılır.

   • Üretim kanalı: "production"

     "Üretim" kanalındaki sürümler tüm kullanıcılara dağıtılır. Sürümünüzü önce üretim kullanıcılarının küçük bir yüzdesine güvenli bir şekilde dağıtmak ve ardından sürüme olan güveniniz arttıkça bu yüzdeyi kademeli olarak artırmak için "üretim" kanalındaki aşamalı sürümlerden yararlanabilirsiniz.

   Basit mod kullanıcıları, herhangi bir kanala birden fazla APK yerleştirmemelidir. Birden fazla APK desteği kullanan gelişmiş mod kullanıcıları, her kanala sıfır, bir veya daha fazla APK yükleyebilir.

Form faktörü kanalları için kanal adı

Bir form faktörü takibinin izleme adının başında belirli bir tanımlayıcı bulunur.

Form Faktörü	Ön numara
Android Automotive OS	otomotiv
Wear OS	wear
Android TV	TV

Belirli bir form faktörü kanalı için kanal adı nasıl hesaplanır?

Üretim, açık test ve dahili test kanalı gibi yaygın kanal türlerinin iyi bilinen bir adı vardır.

İzleme Türü	Varsayılan Parça Adı
Prodüksiyon	üretilen belge(ler) : belge : belge üretimi
Açık Test	beta
Dahili Test	qa

Belirli bir form faktörü parçasının kanal adı şu şekilde hesaplanabilir: "[prefix]:defaultTrackName". Örneğin, Wear OS form faktöründe şu adlara sahip kanallar bulunur: "wear:production", "wear:beta" ve "wear:qa".

Kapalı test kanalları manuel olarak oluşturulur ve özel adlara sahiptir. Dolayısıyla, $name adlı bir form faktörü için kapalı test kanalının kanal adı "[prefix]:$name" olur.

APK İş Akışı Örneği

Bu bölümde, Track API'nin tipik bir kullanım şekli açıklanmaktadır. Bu durumda, her kanal için APK'nın yeni sürümlerini yüklemek ve aşamalı sunum sürümü alması için bir dizi kullanıcı atamak istediğinizi varsayıyoruz. (Pratikte, bir geliştiricinin tüm bu işlemleri aynı işlemde yapması pek olası değildir. Bunun yerine, bir gün beta sürümünü güncelleyebilir, başka bir gün "üretim" için aşamalı bir sürüm oluşturabilirsiniz.)

1. Düzenleme İş Akışı bölümünde açıklanan şekilde yeni bir düzenleme açın.
2. Yüklemek istediğiniz her APK için Edits.apks: install yöntemini çağırın. APK'yı yöntemin istek gövdesine geçirin. (Bu işlem, APK'yı bir depolama alanına yerleştirir, ancak bir kanalda yayınlamaz veya dağıtmaz.) Yöntem, yüklediğiniz her APK için bir sürüm kodu döndürür. Bir kanalda yayınlarken APK'ya başvurmak için bu sürüm kodunu kullanırsınız.

3. APK'ları yayınlamak istediğiniz her kanal için Edits.tracks: update yöntemini çağırın. İstek gövdesinde, kullanıma sunmak istediğiniz sürümü içeren bir Edits.tracks kaynağı iletin. Örneğin, sürüm kodu 88 olan bir APK yayınlamak için:

   {
   "releases": [{
     "versionCodes": ["88"],
     "status": "completed"
   }]
   }
   

   Bu noktada APK'lar hâlâ kullanıcılar tarafından kullanılamaz. Diğer düzenlemelerde olduğu gibi, değişiklikler siz onları kaydedene kadar yayınlanmaz.

4. Değişiklikleri uygulamak için Düzenlemeler: kaydetme yöntemini çağırın. Bunu yapmanızdan sonra, her kanaldaki kullanıcılara APK'nın güncellenmiş sürümü verilir. (Tüm düzenlemelerde olduğu gibi, değişikliklerin geçerli olması birkaç saat sürebilir.)

Aşamalı Sunumlar

APK'nızın kademeli olarak dağıtmak istediğiniz yeni bir sürümü varsa bunu "aşamalı sunum" olarak yayınlamayı seçebilirsiniz. Bunu yaparsanız Google Play bunu, belirttiğiniz uygulama kullanıcılarının istenen bölümüne otomatik olarak dağıtır. "Kullanıma sunma" APK'sında herhangi bir sorun (ör. kilitlenmeler) yoksa bu sürümü alan kullanıcıların oranını artırabilirsiniz. Hazır olduğunuzda, bu APK'yı yeni üretim sürümü olarak dağıtabilirsiniz.

Bu bölümde bir APK'yı aşamalı olarak kullanıma sunmak ve ardından üretime yükseltmek için uygulamanız gereken adımlar açıklanmaktadır:

1. Düzenleme İş Akışı bölümünde açıklanan şekilde bir düzenleme oluşturun.

2. Edits.apks: install yöntemini kullanarak düzenlemeye yeni bir APK yükleyin.

3. Edits.tracks: update yöntemini kullanarak üretim kanalında "inProgress" aşamalı bir sürüm başlatın. Yeni APK'yı alması gereken kullanıcı oranını seçin. APK bu noktada hâlâ hiçbir son kullanıcı tarafından kullanılamamaktadır.

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.05,
     "status": "inProgress"
   }]
   }
   

4. Düzenlemeler: kaydetme yöntemini çağırarak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcı oranı yeni APK'yı alır.

Aşamalı sunumun başarısına bağlı olarak, bu sürüm için uygun olan kullanıcıların yüzdesini artırmak veya sürümü durdurmak isteyebilirsiniz.

Aşamalı sunum için kullanıcı oranını artırma

Önceki bölümde açıklandığı gibi %5'lik devam eden bir aşamalı sunumunuzun olduğu varsayıldığında, bu bölümde sürümün iyi gittiği durumlarda yüzdenin nasıl artırılacağı açıklanmaktadır:

1. Düzenleme İş Akışı bölümünde açıklanan şekilde bir düzenleme oluşturun.

2. Üretim kanalındaki "inProgress" aşamalı sürümünü Edits.tracks: update yöntemini kullanarak değiştirin. Yeni APK'yı alması gereken kullanıcıların oranını artırın:

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.1,
     "status": "inProgress"
   }]
   }
   

3. Düzenlemeler: kaydetme yöntemini çağırarak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcı oranı yeni APK'yı alır.

Aşamalı sunumu durdurma

Bir önceki bölümde açıklandığı gibi %5 oranında devam eden aşamalı bir sunumunuz varsa, bu bölümde bir sorunla karşılaştığınızda aşamalı sunumun nasıl durdurulacağı açıklanmaktadır:

1. Düzenleme İş Akışı bölümünde açıklanan şekilde bir düzenleme oluşturun.

2. Üretim kanalındaki "inProgress" aşamalı sürümünü Edits.tracks: update yöntemini kullanarak değiştirin. Durumu "halted" olarak ayarlayın.

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "halted"
   }]
   }
   

3. Düzenlemeler: kaydetme yöntemini çağırarak etkin düzenlemedeki değişiklikleri kaydedin. Sürümünüz artık yeni kullanıcılara sunulmayacak.

Durdurulmuş bir sürümü daha sonra devam ettirmeye karar verirseniz, durumunu tekrar "inProgress" olarak ayarlayarak bunu yapabilirsiniz.

Aşamalı sunumu tamamlama

Aşamalı sunumunuzdan memnunsanız ve sürümü kullanıcıların% 100'üne sunmak istiyorsanız sürüm durumunu "completed" olarak ayarlayabilirsiniz:

1. Düzenleme İş Akışı bölümünde açıklanan şekilde bir düzenleme oluşturun.

2. Üretim kanalındaki "inProgress" aşamalı sürümünü Edits.tracks: update yöntemini kullanarak değiştirin. Durumu "completed" olarak ayarlayın.

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "completed"
   }]
   }
   

3. Düzenlemeler: kaydetme yöntemini çağırarak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcı oranı yeni APK'yı alır.

Taslak sürümler

Taslak sürümler, APK'ları otomatik olarak yüklemenize ve API aracılığıyla bir sürüm oluşturmanıza olanak tanır. Bu sürüm daha sonra Google Play Console aracılığıyla dağıtılabilir. Kanalda taslak sürüm oluşturmak için:

1. Düzenleme İş Akışı bölümünde açıklanan şekilde yeni bir düzenleme açın.
2. Yüklemek istediğiniz her APK için Edits.apks: install yöntemini çağırın. APK'yı yöntemin istek gövdesine geçirin. Yöntem, yüklediğiniz her APK için bir sürüm kodu döndürür; bir sürüme atadığınızda APK'ya başvurmak için bu sürüm kodunu kullanırsınız.

3. Yayın yapmak istediğiniz her parça için Edits.tracks: update yöntemini çağırın. İstek gövdesinde, oluşturmak istediğiniz taslak sürümü içeren bir Edits.tracks kaynağı iletin. Örneğin:

   {
   "releases": [{
     "name": "My draft release",
     "versionCodes": ["88"],
     "status": "draft"
   }]
   }
   

4. Değişiklikleri uygulamak için Düzenlemeler: kaydetme yöntemini çağırın. Taslak sürümünüz artık Google Play Console veya API aracılığıyla incelenebilir ve kullanıma sunulabilir.

Sürüm notlarını belirtme

Uygulamanızın yeni bir sürümünü yayınlarken, sürümünüzle ilgili sürüm notlarını belirterek kullanıcılara yenilikleri vurgulayabilirsiniz.

Bunu yapmak için Edits.tracks: update yöntemine bir Edits.tracks kaynağı sağlarken "releaseNotes" alanını kullanın.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}