Перейти к содержанию

Как скачать и обновлять Суперапп

Способы установки и обновления клиентов

Платформа Установка Обновление Примечание
Windows - msi-установщик
- SCCM / MECM
- Для текущего пользователя или всех пользователей
- Распространение через DL для закрытых контуров 		- Автообновление (по умолчанию)
- Проверка раз в час, всплывающее окно
- AUTOUPDATES=0 — отключение 		Поддерживается ГОСТ
macOS - App Store или .dmg - App Store → автоматически
- .dmg → всплывающее окно о новой версии
Отключить нельзя 		Временно недоступно в App Store.
Рекомендуется веб-версия или .dmg
Поддерживается ГОСТ
Linux - .deb / .rpm / .tar / Snapcraft
- Поддерживаются корпоративные репозитории 		- Snapcraft → через магазин
- .deb/.rpm → вручную (новый пакет)
- .tar → проверка раз в час 		Поддерживается ГОСТ
Web   Обновляется вместе с серверной частью  
Android - RuStore (ГОСТ-версия)
- Google Play
- APK — резервный способ
 Автоматически через магазин или вручную Временно недоступно в Google Play. Подробнее про установку
Используйте магазин приложений RuStore
iOS - App Store
- TestFlight (ГОСТ-версия) 		Автоматически через магазин или вручную Временно недоступно в App Store. Подробнее про установку
Рекомендуется веб-версия

Где скачать клиентское приложение

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

  1. С сайта https://workspace.vk.ru/download/

  2. Из AppStore — https://apps.apple.com/ru/app/vk-workspace-%D0%B1%D0%B8%D0%B7%D0%BD%D0%B5%D1%81-%D1%81%D1%83%D0%BF%D0%B5%D1%80%D0%B0%D0%BF%D0%BF/id1473826998?mt=12

  3. Из Snapcraft — https://snapcraft.io/vkworkspace

  4. Со страницы https://dl.<сайт_компании>, которая доступна после установки Мессенджера.

    Например, если сайт вашей компании — mycompany.com, то скачать Суперапп можно со страницы https://dl.mycompany.com.

Варианты работы Супераппа на iOS и macOS

Обратите внимание на варианты работы с приложением VK WorkSpace на iOS и macOS, если оно временно недоступно в официальном магазине App Store:

  • Ранее установленные приложения продолжают работать, однако перестали приходить push-уведомления.

    Предупредите ваших сотрудников, чтобы они не удаляли и не переустанавливали мобильное приложение. Из-за отсутствия приложения в магазине App Store повторная установка на телефон будет невозможна.

    Чтобы возобновить получение push-уведомлений от Почты на телефонах, пользователи могут добавить ярлык сервиса на главный экран телефона. Как это сделать, описано в инструкции для пользователей.

  • Если же приложение не было установлено ранее, следуйте рекомендациям ниже.

Как пользоваться Супераппом на macOS, если приложение не было установлено ранее

Варианты для пользователей

Ваши сотрудники могут:

  • Пользоваться веб-версией Супераппа в браузере.

  • Пользоваться десктопной версией, которую сотрудник может самостоятельно скачать (dmg-файл) и установить напрямую с официальной страницы workspace.vk.ru/download.

Централизованная установка через администраторов

Если в вашей компании развертывание ПО автоматизировано или выполняется ИТ-отделом:

  1. Скачайте дистрибутив с официальной страницы workspace.vk.ru/download.

  2. Выполните проверку контрольной суммы (хэш-суммы) по алгоритму sha256. Для этого скачайте файл с контрольной суммой по ссылке.

  3. Выполните команду для дистрибутива:

    shasum -a 256 <имя дистрибутива (файла dmg)>
    И сверьте с данными из файла с контрольной суммой.

  4. Далее используйте альтернативные методы управления запуском на macOS:

    • Удаление флага карантина через Терминал:

      Обойти стандартные проверки безопасности macOS для конкретного приложения можно с помощью команды:

      xattr -d com.apple.quarantine VK\ WorkSpace.app

    • Использование корпоративного Self Service:

      Так как инструмент корпоративного управления Self Service обладает правами локального администратора на устройствах сотрудников, установка и первый запуск приложения через него проходят без вызова предупреждений от macOS.

Как пользоваться сервисами VK WorkSpace на iOS, если приложение не было установлено ранее

Сотрудники могут пользоваться веб-версиями отдельных сервисов VK WorkSpace в мобильном браузере:

  • Почтой.
  • Календарем.
  • Диском.
  • Мессенджером с Задачами.

Чтобы получать push-уведомления от Почты, сотрудники могут добавить ярлык сервиса на главный экран телефона по инструкции.

Работа супераппа на Android

Приложение VK WorkSpace недоступно в Google Play. Установленные приложения продолжат работать. Чтобы пуш-уведомления приходили корректно, настройте их отправку на сервере по инструкции.

Для того чтобы своевременно обновлять приложение VK WorkSpace, пользователям нужно установить магазин приложений RuStore.

Сводка по действиям администратора:

  1. Настройте отправку пуш-уведомлений на сервере VK WorkSpace по инструкции.

  2. После этого перешлите сотрудникам рекомендации по установке RuStore, чтобы они могли обновлять приложение до актуальной версии:

    2.1. Установить RuStore, если его ещё нет на устройстве (инструкция, как установить RuStore). 2.2. Открыть RuStore на смартфоне и авторизоваться в профиле. Войти можно любым удобным способом (инструкция по авторизации). 2.3. Найти приложение VK WorkSpace в поиске RuStore и установить его. Если приложение VK WorkSpace уже установлено, обновить его до актуальной версии.

Где скачать архивы сборок клиентских приложений

Ознакомьтесь с этим разделом, если в вашей компании ограничен доступ в интернет или если вы хотите размещать сборки клиентского приложения во внутреннем контуре.

Начиная с версии 26.2 сборки клиентского приложения не поставляются в составе дистрибутива Мессенджера. Чтобы пользователи смогли установить Суперапп из внутреннего контура:

  1. Скачайте архивы сборок:

  2. Распакуйте подготовленные архивы во внутреннее хранилище.

  3. Перейдите в конфигурационный файл /usr/local/nginx-im/html/myteam/myteam-config.json.

  4. В секции apps в полях url укажите ссылки на внутреннее хранилище. Пример заполнения ссылок описан в шаге 5.

    В полях full_version укажите номер версии сборки, который видно после распаковки архива:

    {
  "apps": {
    "linux_x64": {
      "full_version": "26.2.10.100481",
      "url": "https://dl.<ваш домен>.ru/downloads/linux/x64/26.2.10.100481",
    },
    "mac_x64": {
      "full_version": "26.2.10.100480",
      "url": "https://dl.<ваш домен>.ru/downloads/mac/x64/26.2.10.100480", 
    },
    "win_x64": {
      "full_version": "26.2.10.100482",      
      "url": "https://dl.<ваш домен>.ru/downloads/win/x64/26.2.10.100482",
    }
  }
}

  5. Перейдите в конфигурационный файл /srv/myteam-onpremise-www/htdocs/dl-config.json и укажите там ссылки на внутреннее хранилище:

    {
    "window-build-links": {
        "msi": "<myteam-config.apps.win_x64.url>/vkworkspace.msi"
    },
    "linux-build-links": {
        "tar": "<myteam-config.apps.linux_x64.url>/vkworkspace.tar.xz",
        "rpm": "<myteam-config.apps.linux_x64.url>/vkworkspace.rpm",
        "deb": "<myteam-config.apps.linux_x64.url>/vkworkspace.deb"
    },
    "macos-build-links": {
        "dmg": "<myteam-config.apps.mac_x64.url>/vkworkspace.dmg"
    }
}

    где:

    • myteam-config.apps.win_x64.url — значение поля url из секции win_x64 в файле myteam-config.json.
    • myteam-config.apps.linux_x64.url — значение поля url из секции linux_x64 в файле myteam-config.json.
    • myteam-config.apps.mac_x64.url — значение поля url из секции mac_x64 в файле myteam-config.json.

    Пример заполнения конфигурационных файлов:

    Вы скачали архивы со сборками и распаковали их во внутреннее хранилище, после распаковки архивов:

    • для Linux, появится каталог .../linux/x64/26.2.10.100480
    • для Windows — каталог .../win/x64/26.2.10.100482
    • для macOS — каталог .../x64/26.2.10.100481

    Все сборки уникальны, версии сборок не повторяются, для каждой операционной системы своя версия.

    Укажите в конфигурационных файлах ссылки на ваше внутреннее хранилище и номер версии из каталога. Если вы укажете для разных операционных систем одинаковые версии, пользователи не смогут скачать Суперапп на странице https://dl.<сайт_компании>.

  6. Для инсталляции на одну виртуальную машину выполните команду:

    HELMWAVE_USE_LOCAL_REPO_CACHE=true hwup -t godmod

    Для кластерной инсталляции:

    HELMWAVE_USE_LOCAL_REPO_CACHE=true HELMWAVE_ENV_NAME=cluster hwup -t godmod

  7. Перезапустите под в технологическое окно (может приводить к сбою в новых подключениях):

    kubectl delete pods -n vkteams -l app=myteam-admin

После этих настроек пользователи смогут получить Суперапп на странице https://dl.<сайт_компании>.

Как обновлять Суперапп

Если пользователи могут обновлять Суперапп из публичных ресурсов

Суперапп постоянно обновляется на публичных ресурсах, поэтому версия Супераппа на ресурсах для скачивания может отличаться от вашей версии бэкенда. Поддерживается совместимость Супераппа с текущей и двумя предыдущими версиями бэкенда Мессенджера.

Вы можете управлять обновлением Супераппа для вашей инсталляции — обновляться до самой новой версии (настройки по умолчанию) или до конкретной версии.

По умолчанию в веб-интерфейсе установщика указаны ссылки на публичное облако, чтобы Суперапп обновлялся до самой последней версии. Чтобы настроить обновление до конкретной версии:

  1. В веб-интерфейсе установщика Проекты → vkteams → apps укажите в полях url ссылки на конкретные версии в публичном облаке. Пример для операционной системы Windows: https://hb.bizmrg.com/vkteams-www/win/x64/26.2.0.87324

  2. В полях full_version укажите конкретную версию, в нашем примере это «26.2.0.87324».

  3. Нажмите на кнопку Сохранить настройки и запустите автоматическую установку.

Если вы хотите ограничить использование устаревших версий Супераппа

Вы можете запретить пользователям использовать Суперапп, версия которого ниже минимально поддерживаемой (устанавливается администратором организации). Подробнее — в документации.

Если вы размещаете сборки Супераппа во внутреннем контуре или в компании ограничен доступ в интернет

В таком случае вам необходимо самостоятельно обновлять архивы сборок Супераппа во внутреннем хранилище и указывать их в веб-интерфейсе установщика, как описано выше.

Ошибки обновления

Обновление не будет работать, если:

  • Указаны неверные ссылки в myteam-config.json или по ссылкам нет файлов.
  • Файлы не доступны по HTTP(S) – например, из-за неверный настроек HTTP-сервера или у файлов нет доступа не чтение.
  • По ссылками разложено не содержимое архива (отсутствует version.json), а сборки, скаченные по пользовательским ссылкам.
  • При включенном ГОСТ-шифровании, ссылки на публичное облако https://hb.bizmrg.com/vkteams-www/ не внесены в исключение доменов.

В случае использования ГОСТ-шифрования все внешние адреса (все адреса вне mycompany.com) должны быть внесены в исключение в параметре gost-host-regexes в файле /usr/local/nginx-im/html/myteam/myteam-config.json:

"gost-host-regexes" : ".*" # по-умолчанию ходим по ГОСТ по всем адресам

Внимание

Внешние адреса без поддержки ГОСТ не будут работать!

Добавление исключений:

"gost-host-regexes" : ".*gost-(e|vkteams-calendar|cloud)\\.mycompany\\.com" # ходим по ГОСТ только по внутренним адресам mycompany.com. Внешние адреса без поддержки ГОСТ работают

Подробнее про ГОСТ-шифрование и параметр gost-host-regexes — в документации.