Руководство по приложению PWA для iOS / iPadOS

Пользуйтесь приложением Marinara Engine на iPhone или iPad. Apple не позволяет запускать сервер Marinara на этих устройствах, поэтому вы открываете в Safari сервер, который работает на другом устройстве. Затем его можно сохранить на домашний экран как PWA. PWA (Progressive Web App) – это сайт, который открывается в отдельном окне, как приложение.

Быстрый способ

  1. Установите и запустите Marinara на компьютере, домашнем сервере или телефоне с Android (см. список ниже). Оставьте ее запущенной.
  2. Задайте вход на этом компьютере. См. Удаленный доступ.
  3. Узнайте IP-адрес этого компьютера (см. ниже).
  4. На iPhone или iPad откройте Safari и перейдите по адресу из http://, этого IP-адреса и :7860.

Не используйте 127.0.0.1 на iPhone или iPad. Этот адрес означает сам iPhone.

Где работает сервер

Сервер может работать:

Подключение из Safari

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

  1. Подключите устройство с сервером и ваш iPhone или iPad к одной сети, например к домашнему Wi-Fi. Чтобы подключаться из другого места, используйте Tailscale – бесплатную программу, которая связывает ваши устройства в частную сеть через интернет.
  2. Узнайте IP-адрес устройства с сервером. На компьютере с сервером выполните одну команду в терминале (окне, в котором вводятся команды) и найдите адрес вида 192.168.1.42.
  1. Откройте Safari и перейдите по этому адресу. Вместо <host-ip> подставьте этот IP-адрес. Порт по умолчанию – 7860.
http://<host-ip>:7860
  1. Загрузится главный экран Marinara.

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

Если не получилось: проверьте, что сервер все еще работает и что оба устройства находятся в одной сети или в Tailscale. Проверьте IP-адрес и порт. См. Устранение неполадок в приложении Marinara Engine.

Добавление на домашний экран

  1. Откройте свой сервер Marinara в Safari.
  2. Нажмите кнопку "Поделиться" (Share) – квадратный значок со стрелкой вверх.
  3. Прокрутите меню "Поделиться" вниз и нажмите Add to Home Screen (добавить на домашний экран).
  4. При желании измените название, затем нажмите Add (добавить).

На домашнем экране появится значок Marinara. Нажмите на него, чтобы открыть Marinara в отдельном окне, без адресной строки Safari.

HTTPS, если приложение работает со сбоями

Лучше всего PWA работает по HTTPS – защищенному соединению, адрес которого начинается с https://. Простой адрес http:// в Safari работает. Но некоторые версии iOS и iPadOS ограничивают приложение с домашнего экрана, если у него простой адрес http://. В этом случае раздавайте Marinara по HTTPS или оставьте ее закладкой в Safari.

Сам по себе Tailscale не делает адрес HTTPS. Используйте такую настройку Tailscale, которая раздает HTTPS, или попросите владельца сервера поставить Marinara за HTTPS. См. Удаленный доступ.

Очистка и повторная установка приложения PWA

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

  1. Нажмите и удерживайте значок Marinara на домашнем экране.
  2. Нажмите пункт удаления приложения и подтвердите его.
  3. Откройте приложение Settings (настройки) на iPhone или iPad.
  4. Нажмите Safari. В новых версиях iOS и iPadOS этот пункт может находиться в разделе Apps (приложения), затем Safari.
  5. Нажмите Advanced (дополнительно), затем Website Data (данные сайтов).
  6. Найдите запись с вашим адресом Marinara. Если ее не видно, нажмите Show All Sites (показать все сайты).
  7. Проведите по записи влево и нажмите Delete (удалить).
  8. Снова откройте Marinara в Safari и снова добавьте ее на домашний экран по шагам выше.

Устранение неполадок

Страница не открывается в Safari. Проверьте, что сервер работает, что оба устройства находятся в одной сети или в Tailscale и что IP-адрес и порт 7860 указаны верно. См. Удаленный доступ и Устранение неполадок в приложении Marinara Engine.

После обновления Safari показывает страницу входа или настройки.

См. Нет доступа после обновления.

Safari упорно показывает старую сборку. Перезагрузите страницу. Если она по-прежнему выглядит устаревшей, переустановите PWA по шагам выше.

Приложение с домашнего экрана закрывается или становится пустым во время генерации. Откройте его снова и вернитесь в чат. Исправный сервер продолжает работу: ответы чата и запросы изображений Illustrator по-прежнему выполняются на сервере, а снова открытый чат обновляется, когда они завершатся. Stop (остановить) по-прежнему отменяет генерацию в выбранном чате. Если пустой экран появляется снова и снова, сообщите об этом и приложите отчет Support Diagnostics.

Красная полоса сообщает, что сохранение будет молча срываться. Это предупреждение сервера о доверии в сети, а не проблема iPhone или iPad. Владельцу сервера нужно добавить ваш адрес в доверенные. См. Удаленный доступ.

Опасные действия заблокированы. Для некоторых служебных действий нужен секрет администратора (второй пароль) от владельца сервера. Сохраните его на iPhone или iPad в Settings → Advanced → Admin Access (доступ администратора). См. Удаленный доступ.

Смежные руководства