Пример создания

Приложение aitu.apps - по сути web-приложение ( проще говоря, веб-сайт ), доступное в интернете по определенному адресу.

Это даёт ряд преимуществ перед разработкой нативных приложений:

• моментальные обновления: нет необходимости ждать модерации официальных магазинов приложений, достаточно просто выполнить процесс деплоя и ваши обновления станут доступны для пользователей!

• независимость от платформы: aitu app как web-приложение работает одинаково на всех платформах сразу (список актуальных поддерживающихся платформ вы всегда можете найти на aitu.io). Нет необходимости разрабатывать и поддерживать отдельные версии под каждую из платформ.

Нативные компоненты

Приложение aitu.apps хоть по сути и является веб-сайтом, однако благодаря современным технологиям может выглядеть неотличимо от нативного приложения. Для этого рекомендуем воспользоваться готовыми фреймворками с наборами компонентов, такими как ionic или framework7. Все наши шаблоны используют ionic в качестве демонстрационного примера.

Приложение aitu.apps может использовать всю функциональность доступную сегодня веб-разработчикам, а так же предоставляет Aitu Bridge API, который позволяет взаимодействовать с устройствами и сервисами aitu каждого пользователя. Подробно о всей функциональности Aitu Bridge API можно узнать в документации.

Пример разработки простого приложения aitu.apps с использованием Aitu Bridge API

Мы рекомендуем использовать SPA (Single Page Application) в качестве решения для приложения aitu.apps. В качестве быстрого старта вы можете использовать наши шаблоны созданные для популярных библиотек создания SPA: React, Vue, Angular.

Минимальные требования

Перед началом установки убедитесь, что у вас установлен и настроен Node.js 14 версии и выше.

React

1. Склонируйте проект шаблона в папку вашего проекта.

git clone https://github.com/btsdigital/aitu-apps-react-boilerplate PATH_TO_YOUR_PROJECT

2. Установите зависимости.

npm install

3. Запустите приложение.

npm start

После успешного запуска перейдите по ссылке http://localhost:3000 и вы должны увидеть примерно следующую картину:

В качестве примера в шаблонах используется метод getMe из Aitu Bridge API. Однако, так как Aitu Bridge доступен только внутри приложения aitu, здесь в качестве заглушки выводится <username>. При запуске через aitu сюда подставится реальное имя пользователя.

4. Создайте и настройте приложение в личном кабинете разработчика как указано в документации. В поле URL вставьте действительный публичный адрес вашего приложения. Сохраните изменения.

Приложение aitu.apps должно использовать защищенный https протокол.

Публичный адрес приложения

Для доступа к мини-приложению в aitu необходим публичный адрес в интернете. В качестве решения для разработки мы рекомендуем использовать ngrok.

После установки достаточно выполнить команду ngrok http 3000 и вы получите публичный https адрес.

Пример создания приложения aitu.apps

5. Запустите aitu, на вкладке Aitu Apps в категории мои приложения нажмите на созданное приложение и запустите его:

Обратите внимание, что значение <username> подменилось реальным именем пользователя, полученным из метода getMe.

Дальнейшие шаги

Вы получили действующее приложение, которое можно использовать для разработки и тестирования. Рекомендуем ознакомиться с полной функциональностью Aitu Bridge API в документации.

Публиация мини-приложения в aitu.

После завершения разработки и тестирования вы можете сделать ваше мини-приложение доступным для всех пользователей aitu. Для этого нажмите на кнопку Отправить на модерацию. После проверки вашего приложения оно станет доступно пользователям aitu.

Хостинг вашего приложения

ngrok удобное решение, но подходит только для разработки. Для полноценной работы вашего приложения вам понадобится постоянный хостинг. Это может быть ваш сайт или отдельный адрес сайта, или же готовое решение для хостинга приложений в сети интернет, например netlify.