APK-файлы и треки

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

API разработчика Google Play позволяет загружать новые APK для ваших приложений и выпускать их в различных версиях . Это позволяет вам развертывать альфа- и бета-версии вашего приложения, которые доступны для утвержденных пользователей. Это также позволяет развернуть поэтапную версию развертывания , которая автоматически становится доступной для небольшого числа пользователей приложения. После того, как вы выпустили версию для поэтапного развертывания, вы можете постепенно увеличивать количество пользователей, которые получат эту версию приложения, пока вы, наконец, не развернете эту версию как «производственную».

Добавление и изменение APK

  1. Загрузите один или несколько APK, вызвав метод Edits.apks: upload .

    Этот метод загружает APK в «корзину» хранилища, где его можно назначить «треку», чтобы развернуть его для пользователей. (Если изменение удаляется или отбрасывается, все APK-файлы, загруженные в это изменение, также теряются.)

  2. Выпустите APK на «треках», вызвав Edits.tracks: update . Вы можете выпускать APK на следующих треках:

    • Тестирование таких треков, как "alpha" и "beta"

      Альфа- и бета-версии приложения развертываются для пользователей, которых вы назначаете в группы альфа- и бета-тестирования. Вы назначаете пользователей в эти группы с помощью консоли Google Play.

    • Трек внутреннего тестирования: "internal"

      Внутренние версии вашего приложения развертываются на вашей внутренней тестовой версии в соответствии с настройками в консоли Google Play.

    • Производственный трек: "production"

      Релизы на «производственной» версии развертываются для всех пользователей. Вы можете использовать поэтапные выпуски на «производственной» версии, чтобы безопасно развернуть свой выпуск сначала для небольшого процента рабочих пользователей, а затем постепенно увеличивать этот процент по мере роста вашей уверенности в выпуске.

    Пользователи простого режима не должны размещать более одного APK на любой трек. Пользователи расширенного режима, использующие поддержку нескольких APK , могут загружать ноль, один или несколько APK на каждую дорожку.

Пример рабочего процесса APK

В этом разделе описывается типичный способ использования Tracks API. В этом случае мы предполагаем, что вы хотите загрузить новые версии APK для каждой версии и назначить ряд пользователей для получения версии поэтапного развертывания. (На практике маловероятно, что разработчик выполнит все эти действия за одну операцию; вместо этого вы можете обновить бета-версию в один день, создать промежуточный выпуск в «рабочей среде» в другой день и так далее.)

  1. Откройте новое редактирование, как описано в разделе Рабочий процесс редактирования.
  2. Вызовите метод Edits.apks: upload для каждого APK, который вы хотите загрузить. Передайте APK в теле запроса метода. (Это помещает APK в область хранения, но не выпускает его на дорожку и не развертывает.) Метод возвращает код версии для каждого APK, который вы загружаете; вы будете использовать этот код версии для ссылки на APK, когда будете выпускать его на треке.
  3. Вызовите метод Edits.tracks: update для каждой дорожки, для которой вы хотите выпустить APK. В теле запроса передайте ресурс Edits.tracks , содержащий выпуск, который вы хотите развернуть. Например, чтобы выпустить APK с кодом версии 88:

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

    На данный момент APK по-прежнему недоступны для пользователей. Как и в случае с другими правками, изменения не вступают в силу, пока вы их не зафиксируете.

  4. Вызовите метод Edits: commit , чтобы зафиксировать изменения. После этого пользователям каждой дорожки будет предоставлена ​​обновленная версия APK. (Как и в случае со всеми изменениями, для вступления изменений в силу может потребоваться несколько часов.)

Поэтапное развертывание

Когда у вас есть новая версия APK, которую вы хотите постепенно развертывать, вы можете выпустить ее как версию «поэтапного развертывания». Если вы сделаете это, Google Play автоматически развернет его для нужной доли пользователей приложения, которую вы укажете. Если в развертываемом APK нет проблем (таких как сбои и т. д.), вы можете увеличить долю пользователей, получающих эту версию; когда вы будете готовы, вы можете развернуть этот APK в качестве новой рабочей версии.

В этом разделе описываются шаги, которые необходимо выполнить, чтобы выполнить поэтапное развертывание APK, а затем перевести его в рабочую среду:

  1. Создайте редактирование, как описано в разделе Рабочий процесс редактирования .

  2. Загрузите новый APK в редакцию, используя метод Edits.apks: upload .

  3. Запустите промежуточный выпуск "inProgress" на производственной версии с помощью метода Edits.tracks: update . Выберите долю пользователей, которые должны получить новый APK. На данный момент APK по-прежнему недоступен для конечных пользователей.

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

  4. Зафиксируйте изменения в активном редактировании, вызвав Edits: commit . В течение следующих нескольких часов новый APK будет доступен пользователям. Выбранная вами часть пользователей получит новый APK.

В зависимости от успеха поэтапного развертывания вы можете увеличить процент пользователей, имеющих право на этот выпуск, или приостановить выпуск.

Увеличение доли пользователей для поэтапного внедрения

Предполагая, что у вас есть текущее поэтапное развертывание на уровне 5 %, как описано в предыдущем разделе, в этом разделе описывается, как увеличить процент в случае, если выпуск идет хорошо:

  1. Создайте редактирование, как описано в разделе Рабочий процесс редактирования .

  2. Измените промежуточный выпуск "inProgress" на рабочей версии с помощью метода Edits.tracks: update . Увеличьте долю пользователей, которые должны получить новый APK:

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

  3. Зафиксируйте изменения в активном редактировании, вызвав Edits: commit . В течение следующих нескольких часов новый APK будет доступен пользователям. Выбранная вами часть пользователей получит новый APK.

Остановка поэтапного внедрения

Предполагая, что у вас есть текущее поэтапное внедрение на уровне 5 %, как описано в предыдущем разделе, в этом разделе описывается, как остановить поэтапное развертывание в случае обнаружения проблемы:

  1. Создайте редактирование, как описано в разделе Рабочий процесс редактирования .

  2. Измените промежуточный выпуск "inProgress" на рабочей версии с помощью метода Edits.tracks: update . Установите статус "halted" .

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

  3. Зафиксируйте изменения в активном редактировании, вызвав Edits: commit . Ваш релиз больше не будет доступен для новых пользователей.

Если вы позже решите возобновить остановленный выпуск, вы можете сделать это, вернув его статус в "inProgress" .

Завершение поэтапного внедрения

Если вы довольны своим поэтапным внедрением и хотите развернуть выпуск для 100% пользователей, вы можете установить статус выпуска на "completed" :

  1. Создайте редактирование, как описано в разделе Рабочий процесс редактирования .

  2. Измените промежуточный выпуск "inProgress" на рабочей версии с помощью метода Edits.tracks: update . Установите статус "halted" .

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

  3. Зафиксируйте изменения в активном редактировании, вызвав Edits: commit . В течение следующих нескольких часов новый APK будет доступен пользователям. Выбранная вами часть пользователей получит новый APK.

Черновые выпуски

Черновые выпуски позволяют автоматически загружать APK и создавать выпуск через API, который впоследствии можно развернуть через консоль Google Play. Чтобы создать черновик релиза на треке:

  1. Откройте новое редактирование, как описано в разделе Рабочий процесс редактирования.
  2. Вызовите метод Edits.apks: upload для каждого APK, который вы хотите загрузить. Передайте APK в теле запроса метода. Метод возвращает код версии для каждого загруженного вами APK; вы будете использовать этот код версии для ссылки на APK, когда будете назначать его выпуску.
  3. Вызовите метод Edits.tracks: update для каждой дорожки, которую вы хотите выпустить. В теле запроса передайте ресурс Edits.tracks , содержащий проект выпуска, который вы хотите создать. Например:

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

  4. Вызовите метод Edits: commit , чтобы зафиксировать изменения. Теперь ваш черновик релиза можно проверить и развернуть через консоль Google Play или API.

Указание примечаний к выпуску

При выпуске новой версии приложения вы можете выделить пользователям новые возможности, указав примечания к выпуску.

Для этого используйте поле "releaseNotes" при предоставлении ресурса Edits.tracks методу Edits.tracks: update .

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