Open vovs03 opened 5 years ago
Чтобы использовать файлы расширения APK с вашим приложением и обеспечить наилучшее взаимодействие с пользователем с минимальными усилиями от вашего имени, мы рекомендуем вам использовать библиотеку загрузчика, которая входит в пакет библиотеки расширения Google Play APK. Эта библиотека загружает ваши файлы расширения в фоновом режиме, показывает уведомление пользователя со статусом загрузки, обрабатывает потерю сетевого подключения, возобновляет загрузку, когда это возможно, и многое другое.
Чтобы осуществить загрузку файлов расширения с помощью библиотеки загрузчиков, все, что вам нужно сделать, это:
Service
подкласс и BroadcastReceiver
подкласс, каждый из которых требует от вас всего лишь нескольких строк кода.В следующих разделах объясняется, как настроить приложение с помощью библиотеки загрузчиков.
Чтобы использовать библиотеку загрузчика, вам нужно загрузить два пакета из SDK Manager и добавить соответствующие библиотеки в ваше приложение.
Сначала откройте Android SDK Manager ( Инструменты> SDK Manager ) и в разделе « Внешний вид и поведение»> «Системные настройки»> Android SDK выберите вкладку « Инструменты SDK », чтобы выбрать и загрузить:
Библиотека лицензирования Google Play Пакет расширения библиотеки Google Play APK Создайте новый библиотечный модуль для библиотеки проверки лицензии и библиотеки загрузчика. Для каждой библиотеки:
Выберите « Файл»> «Новый»> «Новый модуль» .
В окне « Создать новый модуль» выберите « Библиотека Android» и нажмите « Далее» .
Укажите имя приложения / библиотеки, например «Библиотека лицензий Google Play» и «Библиотека загрузчика Google Play», выберите « Минимальный уровень SDK» , затем нажмите « Готово» .
Выберите « Файл»> «Структура проекта» .
Перейдите на вкладку « Свойства » и в « Библиотеке» введите библиотеку из
Или из командной строки обновите ваш проект, включив в него библиотеки:
Поменяйте каталоги на
:star: Совет: В пакет расширения Apk входит пример приложения, в котором показано, как использовать библиотеку загрузчика в приложении. В примере используется третья библиотека, доступная в пакете Apk Expansion, которая называется APK Expansion Zip Library. Если вы планируете использовать ZIP-файлы для своих файлов расширения, мы предлагаем вам также добавить в ваше приложение библиотеку ZIP расширения APK. Для получения дополнительной информации см. Раздел об использовании библиотеки расширений APK.
^^ форматировать...
Google Play
Файлы расширений *.apk
Обзор
Каждый раз, когда вы загружаете APK с помощью консоли Google Play, у вас есть возможность добавить один или два файла расширения в APK. Каждый файл может иметь размер до 2 ГБ и может быть любого формата, который вы выберете, но мы рекомендуем использовать сжатый файл для экономии пропускной способности во время загрузки. Концептуально каждый файл расширения играет свою роль:
Несмотря на то, что вы можете использовать два файла расширения любым удобным вам способом, мы рекомендуем, чтобы основной файл расширения предоставлял основные ресурсы, и его редко следует обновлять; файл расширения патча должен быть меньше и служить «носителем патча», обновляя его с каждым основным выпуском или по мере необходимости.
Однако даже если для обновления вашего приложения требуется только новый файл расширения патча, вы все равно должны загрузить новый APK с обновленным versionCode в манифесте. (Консоль Play не позволяет загружать файл расширения в существующий APK.)
Формат имени файла
Место хранения
Процесс загрузки
Контрольный список развития
Правила и ограничения
Добавление файлов расширения APK - это функция, доступная при загрузке приложения с помощью консоли Play. При первой загрузке приложения или обновлении приложения, использующего файлы расширения, вы должны знать о следующих правилах и ограничениях:
obb/
каталог. Если вам необходимо распаковать некоторые данные, сохраните их в месте, указанномgetExternalFilesDir()
..obb
файл расширения (если вы не выполняете обновление). Это приведет к тому, что Google Play (или само ваше приложение) будет повторно загружать файл расширения.Загрузка файлов расширения
В большинстве случаев Google Play загружает и сохраняет файлы расширения на устройстве одновременно с установкой или обновлением APK. Таким образом, файлы расширения доступны, когда ваше приложение запускается в первый раз. Однако в некоторых случаях ваше приложение должно загружать файлы расширения самостоятельно, запрашивая их по URL-адресу, предоставленному вами в ответе службы лицензирования приложений Google Play .
Основная логика, необходимая для загрузки файлов расширения, заключается в следующем:
Когда ваше приложение запускается, ищите файлы расширения в общем хранилище (в Android/obb//каталоге).
a. Если файлы расширения есть, все готово, и ваше приложение может продолжаться.
b. Если файлы расширения находятся не там:
i. Выполните запрос, используя Лицензирование приложений Google Play, чтобы получить имена файлов расширения, размеры и URL-адреса вашего приложения.
ii. Используйте URL-адреса, предоставленные Google Play, чтобы загрузить файлы расширения и сохранить файлы расширения. Вы должны сохранить файлы в общем хранилище (
Android/obb/<package-name>/
) и использовать точное имя файла, указанное в ответе Google Play.Если ваше приложение бесплатное (не платное), то вы, вероятно, не использовали лицензирование приложений.оказание услуг. Он предназначен в первую очередь для обеспечения соблюдения лицензионных политик для вашего приложения и обеспечения того, чтобы пользователь имел право использовать ваше приложение (он или она по праву заплатил за него в Google Play). Чтобы упростить функциональность файла расширения, служба лицензирования была расширена, чтобы предоставить ответ на ваше приложение, включающий URL-адрес файлов расширения вашего приложения, которые размещены в Google Play. Таким образом, даже если ваше приложение является бесплатным для пользователей, вам необходимо включить библиотеку проверки лицензии (LVL), чтобы использовать файлы расширения APK. Конечно, если ваше приложение бесплатное, вам не нужно принудительно проверять лицензию - вам просто нужна библиотека для выполнения запроса, который возвращает URL ваших файлов расширения.
В дополнение к LVL вам необходим набор кода, который загружает файлы расширения по HTTP-соединению и сохраняет их в нужном месте в общем хранилище устройства. Когда вы встраиваете эту процедуру в свое приложение, вы должны принять во внимание несколько вопросов:
Чтобы упростить эту работу для вас, мы создали библиотеку загрузчиков, которая запрашивает URL-адреса файлов расширений через службу лицензирования, загружает файлы расширений, выполняет все перечисленные выше задачи и даже позволяет вашей активности приостанавливать и возобновлять загрузку. , Добавив в ваше приложение библиотеку загрузчиков и несколько хуков кода, практически вся работа по загрузке файлов расширения уже написана для вас. Поэтому, чтобы обеспечить наилучшее взаимодействие с пользователем при минимальных усилиях от вашего имени, мы рекомендуем вам использовать библиотеку загрузчика для загрузки файлов расширения. Информация в следующих разделах объясняет, как интегрировать библиотеку в ваше приложение.
Если вы хотите разработать собственное решение для загрузки файлов расширения с помощью URL-адресов Google Play, вы должны следовать документации по лицензированию приложений, чтобы выполнить запрос лицензии, а затем извлечь имена, размеры и URL-адреса файлов расширения из дополнительных элементов ответа. Вы должны использовать APKExpansionPolicyкласс (включенный в библиотеку проверки лицензии) в качестве политики лицензирования, которая фиксирует имена, размеры и URL-адреса файлов расширения из службы лицензирования.