Обновление клиентского приложения через флеш-карту: различия между версиями
Нет описания правки |
Нет описания правки |
||
| Строка 1: | Строка 1: | ||
<translate> | |||
== '''Описание ситуации''' == | == '''Описание ситуации''' == | ||
{{Note|Обновление клиентского приложения через флеш-карту доступно | {{Note|Обновление клиентского приложения через флеш-карту доступно только для клиентского приложения и устройств под управлением Android OS.|warn}} | ||
Ключевые причины использования функционала — возможность добавлять свои (кастомные) сертификаты при сборке «APK»-файла и обновление клиентского приложения без перезагрузки устройства. В качестве дополнительной опции появляется возможно переустановить клиентское приложение на устройство, если текущее приложение было установлено неудачно и имеет проблемы. Данный функционал будет полезен пользователям и специалистам технической поддержки SmartPlayer. | |||
== '''Алгоритм действия''' == | == '''Алгоритм действия''' == | ||
В этом разделе будет описан порядок | В этом разделе будет описан порядок действий для загрузки клиентского приложения с флеш-карты: | ||
* взять флеш-карту и создать папку "SmartPlayer" на ней; | * взять флеш-карту и создать папку "SmartPlayer" на ней; | ||
* загрузить | * загрузить «APK»-файл с клиентским приложением SmartPlayer; | ||
* подключить флеш-карту к устройству; | * подключить флеш-карту к устройству; | ||
* на устройстве произойдет процесс проверки и считывания информации с флеш-карты вместе с ее содержимым; | * на устройстве произойдет процесс проверки и считывания информации с флеш-карты вместе с ее содержимым; | ||
* пользователь начнет установку новой версии приложения | * пользователь начнет установку новой версии приложения; | ||
[[File:Считывание_с_флешки.png|thumb|center| Пример отображения процесса установки новой версии|800px]]; | [[File:Считывание_с_флешки.png|thumb|center| Пример отображения процесса установки новой версии|800px]]; | ||
* ожидать завершение установки; | * ожидать завершение установки; | ||
* запустить и использовать устройство по своему назначению. | * запустить и использовать устройство по своему назначению. | ||
== '''Тонкости и нюансы в работе функционала''' == | == '''Тонкости и нюансы в работе функционала''' == | ||
В процессе обновления клиентского приложения через флеш-карту нужно понимать что требуется соблюдать определенные правила и действия чтобы функционал работал корректно и стабильно. Ниже будут перечислены эти действия: | В процессе обновления клиентского приложения через флеш-карту нужно понимать, что требуется соблюдать определенные правила и действия, чтобы функционал работал корректно и стабильно. Ниже будут перечислены эти действия: | ||
* при установке на устройство с флеш-карты дистрибутив автоматически переносится в память устройства. Поэтому необходимо понимать и помнить что на устройстве должно быть доступно свободное место на локальном хранилище, которого будет достаточно для переноса дистрибутива. | * при установке на устройство с флеш-карты дистрибутив автоматически переносится в память устройства. Поэтому необходимо понимать и помнить что на устройстве должно быть доступно свободное место на локальном хранилище, которого будет достаточно для переноса дистрибутива. | ||
* при создании флеш-карты с клиентским приложением необходимо создать папку "SmartPlayer" и в эту папку загрузить | * при создании флеш-карты с клиентским приложением необходимо создать папку "SmartPlayer" и в эту папку загрузить «APK»"-файл. Примерное отображение пути: "/SmartPlayer/update.apk". Если будет установлен поврежденный файл или файл не с тем содержимым, то при обновлении устройство покажет ошибку и прекратит процесс. | ||
[[File:Поврежденный_файл.png|thumb|center| Пример отображения ошибки при установке битого или неправильного файла|800px]] | [[File:Поврежденный_файл.png|thumb|center| Пример отображения ошибки при установке битого или неправильного файла|800px]] | ||
* обновление устройства произойдет если клиентское приложение на флеш-карте имеет такую же версию клиентского приложения или выше. | * обновление устройства произойдет, если клиентское приложение на флеш-карте имеет такую же версию клиентского приложения или выше. Если версия клиентского приложения на устройстве ниже, то пользователю будет показано окно с информацией что произвести обновление с понижением версии невозможно. | ||
[[File:Версия_ниже.png|thumb|center| Пример отображения ошибки при обновлении версии ниже текущей|800px]] | [[File:Версия_ниже.png|thumb|center| Пример отображения ошибки при обновлении версии ниже текущей|800px]] | ||
* на некоторых устройствах есть root-права или SDK(система инструментов разработчика), позволяющий использовать функционал «тихой» установки(то есть автоматической установки с параметрами по умолчанию). При такой установке пользователь увидит окно с тремя кнопками: | * на некоторых устройствах есть root-права или SDK (система инструментов разработчика), позволяющий использовать функционал «тихой» установки (то есть автоматической установки с параметрами по умолчанию). При такой установке пользователь увидит окно с тремя кнопками: «close», «open file», «install». | ||
[[File:Тихая_установка.png|thumb|center| Пример отображения отображения экрана устройства при «тихой» установке|800px]] | [[File:Тихая_установка.png|thumb|center| Пример отображения отображения экрана устройства при «тихой» установке|800px]] | ||
В данном случае кнопки на экране выполняют следующие действия:<br> | В данном случае кнопки на экране выполняют следующие действия:<br> | ||
| Строка 26: | Строка 27: | ||
** open file — переход к системному установщику с выбором файла установки и окном подтверждения. | ** open file — переход к системному установщику с выбором файла установки и окном подтверждения. | ||
[[File:Ручной_выбор_файла.png|thumb|center| Пример отображения отображения ручной установки|800px]] | [[File:Ручной_выбор_файла.png|thumb|center| Пример отображения отображения ручной установки|800px]] | ||
Если SDK или root — | Если SDK или root — отсутствуют, то отображение изменится и «тихая» установка становится недоступной. Пользователь теперь увидит две кнопки «close» и «install». В данном случае кнопка «install» меняет своё назначение и становится идентичной по функционалу кнопке «open file» функционал работы, который описан выше. | ||
[[File:Без_тихой_установки.png|thumb|center| Пример отображения отображения экрана без возможности «тихой» установки|800px]] | [[File:Без_тихой_установки.png|thumb|center| Пример отображения отображения экрана без возможности «тихой» установки|800px]] | ||
== '''Дополнительная информация''' == | == '''Дополнительная информация''' == | ||
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы можно озвучить | Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить эти вопросы в разделе "Обсуждения" вверху страницы. | ||
[[File:Обсуждение_обновления.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]] | [[File:Обсуждение_обновления.png|thumb|center| Пример отображения вкладки "Обсуждения" на wiki-странице |800px]] | ||
Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | Также дополнительную информацию можно узнать на странице [[Как взаимодействовать пользователю с разделом "Обсуждения"]] | ||
</translate> | |||
Версия от 10:18, 21 января 2026
Описание ситуации
Ключевые причины использования функционала — возможность добавлять свои (кастомные) сертификаты при сборке «APK»-файла и обновление клиентского приложения без перезагрузки устройства. В качестве дополнительной опции появляется возможно переустановить клиентское приложение на устройство, если текущее приложение было установлено неудачно и имеет проблемы. Данный функционал будет полезен пользователям и специалистам технической поддержки SmartPlayer.
Алгоритм действия
В этом разделе будет описан порядок действий для загрузки клиентского приложения с флеш-карты:
- взять флеш-карту и создать папку "SmartPlayer" на ней;
- загрузить «APK»-файл с клиентским приложением SmartPlayer;
- подключить флеш-карту к устройству;
- на устройстве произойдет процесс проверки и считывания информации с флеш-карты вместе с ее содержимым;
- пользователь начнет установку новой версии приложения;

;
- ожидать завершение установки;
- запустить и использовать устройство по своему назначению.
Тонкости и нюансы в работе функционала
В процессе обновления клиентского приложения через флеш-карту нужно понимать, что требуется соблюдать определенные правила и действия, чтобы функционал работал корректно и стабильно. Ниже будут перечислены эти действия:
- при установке на устройство с флеш-карты дистрибутив автоматически переносится в память устройства. Поэтому необходимо понимать и помнить что на устройстве должно быть доступно свободное место на локальном хранилище, которого будет достаточно для переноса дистрибутива.
- при создании флеш-карты с клиентским приложением необходимо создать папку "SmartPlayer" и в эту папку загрузить «APK»"-файл. Примерное отображение пути: "/SmartPlayer/update.apk". Если будет установлен поврежденный файл или файл не с тем содержимым, то при обновлении устройство покажет ошибку и прекратит процесс.

- обновление устройства произойдет, если клиентское приложение на флеш-карте имеет такую же версию клиентского приложения или выше. Если версия клиентского приложения на устройстве ниже, то пользователю будет показано окно с информацией что произвести обновление с понижением версии невозможно.

- на некоторых устройствах есть root-права или SDK (система инструментов разработчика), позволяющий использовать функционал «тихой» установки (то есть автоматической установки с параметрами по умолчанию). При такой установке пользователь увидит окно с тремя кнопками: «close», «open file», «install».

В данном случае кнопки на экране выполняют следующие действия:
- close — завершает процесс работы с окном установки;
- install — запускает «тихую» установку на устройстве;
- open file — переход к системному установщику с выбором файла установки и окном подтверждения.

Если SDK или root — отсутствуют, то отображение изменится и «тихая» установка становится недоступной. Пользователь теперь увидит две кнопки «close» и «install». В данном случае кнопка «install» меняет своё назначение и становится идентичной по функционалу кнопке «open file» функционал работы, который описан выше.

Дополнительная информация
Если данная статья не помогает использовать функционал по назначению или после ее прочтения остаются вопросы, можно озвучить эти вопросы в разделе "Обсуждения" вверху страницы.

Также дополнительную информацию можно узнать на странице Как взаимодействовать пользователю с разделом "Обсуждения"