APK'lar ve Parçalar

Google Play Developer API, 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, uygulamanın az sayıda kullanıcısına otomatik olarak sunulan aşamalı sunum sürümünü de dağıtmanıza olanak tanır. Aşamalı sunum sürümünü yayınladıktan sonra, bu sürümü "üretim" sürümü olarak dağıtana kadar uygulamanın bu sürümünü alan kullanıcıların sayısını 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 "takip"e atanabilir. (Düzenleme silinir veya silinirse bu düzenlemeye yüklenen APK'lar da kaybolur.)

  2. Edits.tracks: update çağrısı yaparak "tracks" ile 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 testi 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ığı şekliyle 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 yayına duyduğunuz güven 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 izleme adı

Bir form faktörü izlemenin kanal adının önüne belirli bir tanımlayıcı eklenir.

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

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

Üretim, açık test ve dahili test kanalı gibi yaygın kanal türleri iyi bilinen bir kanal adına sahiptir.

İ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ü kanalının kanal adı şu şekilde hesaplanabilir: "[prefix]:defaultTrackName". Örneğin, Wear OS form faktöründe şu adlara sahip kanallar olacaktır: "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ü alacak 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" üzerine aşamalı bir sürüm oluşturabilir ve bu şekilde böyle devam edebilirsiniz.)

  1. Düzenlemeler İş 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 iletin. (Bu işlem, APK'yı bir depolama alanına yerleştirir, ancak bir kanala bırakmaz veya dağıtmaz.) Yöntem, yüklediğiniz her APK için bir sürüm kodu döndürür. Bir kanalda yayınladığınızda APK'ya başvurmak için bu sürüm kodunu kullanırsınız.
  3. APK'yı 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, 88 sürüm koduna sahip bir APK yayınlamak için:

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

    Bu noktada APK'lar hâlâ kullanıcılar tarafından kullanılamıyor. Diğer düzenlemelerde olduğu gibi, değişiklikler siz 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çerlilik kazanması birkaç saat sürebilir.)

Aşamalı Sunumlar

APK'nızın kademeli olarak dağıtmak istediğiniz yeni bir sürümü olduğunda bunu "aşamalı sunum" sürümü olarak yayınlamayı seçebilirsiniz. Bunu yaparsanız Google Play, uygulamayı, uygulama kullanıcılarının belirttiğiniz seçtiğiniz belirli bir bölümüne otomatik olarak dağıtır. "Kullanıma sunulan" APK'da 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üzenlemeler İş Akışı bölümünde açıklandığı ş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. Bu noktada APK, son kullanıcılar tarafından hâlâ kullanılamıyor.

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

  4. Düzenlemeler: kaydetme çağrısı yaparak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK kullanıcılara sunulacak. 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üzenlemeler İş Akışı bölümünde açıklandığı ş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 çağrısı yaparak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK kullanıcılara sunulacak. Seçtiğiniz kullanıcı oranı yeni APK'yı alır.

Aşamalı sunumu durdurma

Önceki bölümde açıklandığı gibi, devam eden %5'lik bir aşamalı sunumun olduğu varsayıldığında, bu bölümde bir sorun keşfettiğinizde aşamalı sunumu nasıl durduracağınız açıklanmaktadır:

  1. Düzenlemeler İş Akışı bölümünde açıklandığı ş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 çağrısı yaparak 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 bu işlemi, durumunu tekrar "inProgress" şeklinde ayarlayarak yapabilirsiniz.

Aşamalı sunumu tamamlama

Aşamalı sunumunuzdan memnun olduğunuzda ve sürümü kullanıcıların% 100'üne sunmak istediğinizde, sürüm durumunu "completed" olarak ayarlayabilirsiniz:

  1. Düzenlemeler İş Akışı bölümünde açıklandığı ş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": "completed"
    }]
    }
    

  3. Düzenlemeler: kaydetme çağrısı yaparak etkin düzenlemedeki değişiklikleri kaydedin. Önümüzdeki birkaç saat içinde yeni APK kullanıcılara sunulacak. 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. Bir kanalda taslak sürüm oluşturmak için:

  1. Düzenlemeler İş 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 iletin. 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şvuruda bulunmak 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üzde 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."}
      ]
  }]
}