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

Мобильное приложение

Общие сведения

Данное руководство предназначено для настройки экземпляра TESSA, установленного из поставки. Подразумевается, что на верхнем уровне в репозитории проектного решения расположены папки MobileClient SDK и WebClient SDK, скопированные из архива сборки. Проектные расширения расположены по пути WebClient SDK/src.

Настройки конфигурации

Для работы мобильного приложения необходимо изменить файлы конфигурации.

Подробнее про параметры файла app.json.

В файле app.json в папке web требуется добавить строку, содержащую допустимые источники CORS.

"AllowedCorsOrigins": [
    "https://localhost", 
    "capacitor://localhost", 
    "https://[доменное имя сервера приложений]", 
    "https://[IP-адрес сервера приложений]"
]

Example

"AllowedCorsOrigins": [
    "https://localhost", 
    "capacitor://localhost", 
    "https://tessa-server.org", 
    "https://127.0.0.1"
]

Обязательно указывается "https://localhost", "capacitor://localhost" и доменное имя (IP-адрес), по которому осуществляется доступ к web-клиенту. Путь (например: ../tessa/web) указывать не нужно.

Нужно проверить, что в файле app.json указан параметр 

"CookiesSameSite": "None"

Сборка и публикация бандла

Для работы приложения необходимо собрать и опубликовать бандл на сервере.

Процесс сборки и публикации бандла:

  1. Поместить проектные расширения в папку WebClient SDK/src.
  2. Зарегистрировать их в файле webpack.config.js.

Example

const entries = {
  default: './src/default/index.ts',
  solution: './src/solution/index.ts',
  yourExtension: './src/yourExtension/index.ts'
};
  1. Перейти в папку MobileClient SDK и запустить скрипт mobile-sdk-build.sh (Linux) или mobile-sdk-build.bat (Windows) для автоматической сборки расширений и копирования их в папку wwwroot.
  2. При необходимости отредактировать адрес сервера в скрипте и запустить mobile-publish.sh (Linux) или mobile-publish.bat (Windows) для создания карточки с архивом бандла.

После завершения публикации бандла на сервере нужно перейти на рабочем месте Администратор в представление Служебные —> Мобильное приложение и убедиться в том, что в представлении появилась строка с информацией о бандле. Для проверки нужно запустить мобильное приложение, ввести адрес web-клиента в поле Адрес сервера на стартовой странице и нажать Перейти.

После каждого внесения изменений в проектные расширения требуется в папке MobileClient SDK снова запустить скрипт mobile-sdk-build.sh (Linux) или mobile-sdk-build.bat (Windows). По умолчанию все расширения, зарегистрированные в файле WebClient SDK/webpack.config.js, будут добавлены в мобильный бандл. Чтобы расширение работало только в web-клиенте, нужно в webpack.config.js удалить строку с соответствующим расширением перед запуском скриптов сборки и публикации мобильного бандла.

Тестирование на локальном сервере с самоподписанным сертификатом

Версия приложения, доступная в Google Play и App Store, не работает с серверами TESSA, на которых установлен самоподписанный сертификат. Это связано с требованиями безопасности.

Для локального тестирования существует debug-версия приложения. Получить её можно по запросу.

Примеры расширений для мобильного приложения

Расширения типового решения для мобильного клиента расположены по следующему пути: WebClient SDK/src/default/mobileClient.

Примеры расширений для мобильного приложения расположены в том же каталоге на уровень ниже в папке examples. Удаление примеров подробнее описано на этой странице.

Note

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

Back to top