Инсталлятор под Windows
Компания РОСА представляет новый инструмент под названием "Среда разработки", предназначенный для поддержки разработчиков, которые хотят создавать приложения под операционную систему РОСА Мобайл.
Системные требования
Вам потребуется операционная система Windows версии 10 или 11.
Вам потребуется доступ в Интернет.
Обязательно наличие 30 Гб свободного дискового пространства. Если дискового пространства будет недостаточно, это может привезти к неполному скачиванию образов контейнеров и трудно диагностируемым ошибкам сборки.
Вам потребуется 16Гб оперативной памяти для комфортной работы.
Установка клиента ssh
Проверьте, что SSH-клиент установлен:
ssh -V Если команда ssh не найдена, зайдите в настройки, раздел "Система" -> "Дополнительные компоненты" –> "Добавление дополнительного компонента"
Выберите и установите "Клиент OpenSSH”.
Установка Microsoft Visual Studio Code
Скачайте установщик для Windows и запустите его.
Подтвердите установку компонента WSL нажатием на любую клавишу в течение 60 секунд.
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Установка Docker Desktop
Скачайте установщик для Windows и запустите его.
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Установка и настройка плагина для Visual Studio Code
Скачайте файл плагина “vscode-rosa-1.0.1.vsix” по ссылке ниже.
Запустите Visual Studio Code. В разделе Extensions нажмите на кнопку с троеточием и в появившемся меню выберите пункт "Install from VSIX…"
В диалоге выбора файлов выберите скачанный файл "vscode-rosa-1.0.1.vsix" и нажмите кнопку "Install".
Дождитесь сообщения "Completed installing extension".
Если запущен Docker Desktop, то сразу же начнётся скачивание необходимых контейнеров от компании РОСА.
Если Docker Desktop не был запушен, запустите его и перезапустите Visual Studio Code.
Дождитесь, когда скачаются образы контейнеров. Объём образов составляет более 3 Гигабайт, так что скачивание может занять длительное время:
По завершении скачивания появится сообщение "Rosa builder docker images successfully downloaded", а программа Docker Desktop покажет, что появилось два новых образа:
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Установка эмулятора телефона
Скачайте файл виртуальной машины эмулятора телефона "R-PhoneEmulatorx86.ova" по ссылке ниже.
Запустите Visual Studio Code. Перейдите в раздел плагина "ROSA Mobile".
Подведите мышь в раздел "VIRTUAL DEVICES" и нажмите на появившийся знак "+":
В диалоге выбора файлов выберите скачанный файл "R-PhoneEmulatorx86.ova" и нажмите кнопку "Select a virtual device appliance".
Запускается импорт из файла, который может занять несколько минут. По завершению импорта выводится сообщение "Virtual device R-Phone Emulator x86 successfully added".
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Проверка: первая программа на эмуляторе
Запустите Visual Studio Code.
Находясь в любом месте окна программы, кроме окна поиска, нажмите сочетание клавиш "Ctrl+Shift+P". В окне поиска появится список известных команд. Выберите команду "Rosa: Create template", которая создаст программу по шаблону. На выбор будет предложено два шаблона: single-page-template и tabs-page-template. Выберем single-page-template.
В появившемся окне выбора каталога укажите каталог, в котором будут располагаться файлы программы.
Перейдите в раздел плагина "ROSA Mobile".
В разделе "VIRTUAL DEVICES" выберите устройство "R-Phone Emulator x86", для которого будет создаваться программа:
Снова нажмите сочетание клавиш "Ctrl+Shift+P". В окне поиска появится список известных команд. Выберите команду "Rosa: Start Build and run on device". Начнётся сборка программы, затем запустится эмулятор телефона, а на нём заработает собранная программа.
Если экран эмулятора заблокируется, используйте пароль "rosa" для разблокировки.
Завершить работу эмулятора можно, просто закрыв его окно.
Ниже расположено видео, иллюстрирующее выполнение данной команды.
Добавить реальный телефон в интерфейс среды разработки (при необходимости)
В настройках сети WiFi телефона определите его IP-адрес:
В Visual Studio Code перейдите в область плагина ROSA Mobile (1) и нажмите на «+» в разделе «Devices» (2):
Укажите IP-адрес телефона, порт (22), имя пользователя (omv) и пароль (изначально "1234").
Собирать и выполнять программы на реальном телефоне можно так же, как и на эмуляторе. Только при запуске задачи "Rosa: Start Build and run on device" (смотреть пункт “Установка эмулятора телефона”) должен быть выбран реальный телефон в качестве целевого устройства.
Ниже расположено видео, иллюстрирующее выполнение данной команды.