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 kanallara yayınlamanıza imkan verir. Bu sayede, uygulamanızın alfa ve beta sürümlerini onaylanan kullanıcılar için kullanılabilir hale getirebilirsiniz. Bu işlem ayrıca otomatik olarak az sayıda uygulama kullanıcısının kullanımına sunulan aşamalı sunum sürümünü dağıtmanıza olanak tanır. Aşamalı sunum sürümünü yayınladıktan sonra, son sürümü "Üretim" sürümü olarak dağıtana kadar uygulamanın bu sürümünü edinen 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ı kullanıcılara dağıtmak için "kanal"a atanabileceği bir depolama & APK'sına yükler. (Düzenleme silinir veya silinirse bu düzenlemeye yüklenen APK'lar da kaybolur.)

  2. Edits.tracks: update çağrısı yaparak APK'lardaki APK'ları serbest bırakın. Aşağıdaki kanallarda APK'ları serbest bırakabilirsiniz:

    • "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ı Google Play Console'u kullanarak bu gruplara atarsınız.

    • Dahili test kanalı: "internal"

      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, ardından üretim sürecindeki güveniniz arttıkça bu yüzdeyi aşamalı olarak artırmak için üretim kanalında aşamalı sunum özelliğinden yararlanabilirsiniz.

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

APK İş Akışı Örneği

Bu bölümde Track API'nin tipik bir kullanım şekli açıklanmıştır. Bu durumda, her kanal için APK'nın yeni sürümlerini yüklemek ve aşamalı sunum sürümü almak üzere belirli sayıda kullanıcı atamak istediğinizi varsayarız. (Uygulamada bir geliştiricinin tüm bu işlemleri aynı işlemde yapması muhtemelen mümkün olmaz. Bunun yerine beta sürümünü bir gün için güncelleyebilir, başka bir gün üretim sürümünde aşamalı bir sürüm oluşturabilirsiniz.

  1. Düzenleme İş Akışı bölümünde açıklandığı gibi yeni bir düzenleme açın
  2. Yüklemek istediğiniz her APK için Edits.apks: install yöntemini çağırın. Yöntemin istek gövdesinde APK'yı iletin. (Bu, APK'yı bir depolama alanına yerleştirir ancak bir kanalda kullanıma sunmaz veya dağıtmaz.) Yöntem, yüklediğiniz her APK için bir sürüm kodu döndürür. APK'yı bir kanalda yayınlarken APK'yı belirtmek için bu sürüm kodunu kullanırsınız.
  3. APK'ları serbest bırakmak istediğiniz her parça 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'yı serbest bırakmak için:

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

    Bu noktada, APK'lar kullanıcılar tarafından hâlâ kullanılamaz. Diğer düzenlemelerde olduğu gibi değişiklikler yapılana kadar geçerli olmaz.

  4. Değişiklikleri uygulamak için Düzenlemeler: kaydetme yöntemini çağırın. Bu işlemin ardından her kanaldaki kullanıcılara APK'nın güncellenmiş sürümü sunulur. (Tüm düzenlemelerde olduğu gibi değişikliklerin uygulanması birkaç saati bulabilir.)

Aşamalı Sunumlar

APK'nızın kademeli olarak dağıtmak istediğiniz yeni bir sürümü olduğunda bunu "hazırlanmış kullanıma sunma" sürümü olarak yayınlamayı seçebilirsiniz. Bunu yaparsanız Google Play, bunu uygulamanızın kullanıcıların istediğiniz bölümüne otomatik olarak dağıtır. "Kullanıma sunma" APK'sında herhangi bir sorun yoksa (kilitlenmeler vb.) bu sürümü alan kullanıcı 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'nın aşamalı sunumunu gerçekleştirmek ve ardından üretime yükseltmek için uygulayacağınız adımlar açıklanmaktadır.

  1. İş Akışını Düzenleme bölümünde açıklandığı gibi 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ıların oranını seçin. Bu noktada, APK son kullanıcılar tarafından hâlâ kullanılamaz.

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

  4. Etkin düzenlemelerdeki değişiklikleri uygulamak için Düzenlemeler: kaydetme bölümünü çağırın. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcıların oranı, yeni APK'yı alır.

Aşamalı sunumun başarısına bağlı olarak, yayın 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 de açıklandığı gibi, %5'lik devam eden bir aşamalı sunumunuz olduğu varsayıldığında, bu bölümde, sürümün iyi gittiği durumda yüzdenin nasıl artırılacağı açıklanmaktadır:

  1. İş Akışını Düzenleme bölümünde açıklandığı gibi bir düzenleme oluşturun.

  2. Edits.tracks: update yöntemini kullanarak üretim kanalındaki "inProgress" aşamalı sürümü 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. Etkin düzenlemelerdeki değişiklikleri uygulamak için Düzenlemeler: kaydetme bölümünü çağırın. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcıların oranı, yeni APK'yı alır.

Aşamalı sunum durduruluyor

Önceki bölümde açıklandığı gibi, %5'te devam eden bir aşamalı sunumunuz olduğu varsayıldığında, bu bölümde bir sorun bulduğunuzda aşamalı sunumun nasıl durdurulacağı açıklanmaktadır:

  1. İş Akışını Düzenleme bölümünde açıklandığı gibi bir düzenleme oluşturun.

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

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

  3. Etkin düzenlemelerdeki değişiklikleri uygulamak için Düzenlemeler: kaydetme bölümünü çağırın. Sürümünüz artık yeni kullanıcılara sunulmayacak.

Durdurulan 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. İş Akışını Düzenleme bölümünde açıklandığı gibi bir düzenleme oluşturun.

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

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

  3. Etkin düzenlemelerdeki değişiklikleri uygulamak için Düzenlemeler: kaydetme bölümünü çağırın. Önümüzdeki birkaç saat içinde yeni APK, kullanıcıların kullanımına sunulacaktır. Seçtiğiniz kullanıcıların 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 sağlar. Bu sürümler 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çıklandığı gibi yeni bir düzenleme açın
  2. Yüklemek istediğiniz her APK için Edits.apks: install yöntemini çağırın. Yöntemin istek gövdesinde APK'yı iletin. Yöntem, yüklediğiniz her APK için bir sürüm kodu döndürür. Bu sürüme ait kodu, bir sürüme atadığınızda APK'ya başvurmak için 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üzdeki sürüm notlarını belirterek kullanıcılardaki 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."}
      ]
  }]
}