Обновление клиентского приложения через флеш-карту: различия между версиями

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

Описание ситуации

Обновление клиентского приложения через флеш-карту доступно только для клиентского приложения и устройств под управлением Android OS.

Ключевые причины использования функционала — возможность добавлять свои (кастомные) сертификаты при сборке «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» функционал работы, который описан выше.

Пример отображения отображения экрана без возможности «тихой» установки

Дополнительная информация

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

Пример отображения вкладки "Обсуждения" на wiki-странице

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