iPhone и iPad

Приложение для iOS — оболочка над той же веб-мордой: окно смотрит на ваш домашний Clauder, а своего сервера на устройстве нет. iOS не даёт запускать чужие программы, поэтому агент всегда работает на компьютере, а iPhone остаётся пультом. Минимум — iOS 15.

В App Store приложения нет. Ставить его приходится самому, и ниже — как это делается сейчас.

Сначала подумайте о веб-морде

Если нужно смотреть чаты и отвечать агенту, приложение не обязательно. Откройте адрес Clauder в Safari, нажмите «Поделиться» → «На экран Домой» — и он будет открываться отдельным окном, без адресной строки, как обычное приложение. Ничего не нужно подписывать и продлевать, обновляется само. Подробнее — Веб-морда и PWA.

Приложение даёт сверх этого: подключение снимком QR-кода, ключ в связке ключей iOS, виджеты на экране «Домой» и экране блокировки, быстрые действия на значке, уведомления о вопросах агента, пока приложение открыто, и фоновую проверку, когда оно закрыто.

Что понадобится

• Файл Clauder-<версия>.ipa из сборок — их выдают по запросу в Telegram @varyen. Он весит меньше мегабайта — так и должно быть: интерфейс приезжает с вашего сервера, а в пакете только тонкая оболочка.
• Apple ID. Подойдёт обычный бесплатный — платный аккаунт разработчика не нужен. Лучше завести отдельный: программе подписи придётся войти под ним.
• Компьютер с Windows или macOS и кабель к iPhone.

Файл в релизе не подписан: Apple не даёт подписать приложение один раз для всех, поэтому подпись делается под ваш Apple ID и ваше устройство.

Установка через Sideloadly

Sideloadly — бесплатная программа для Windows и macOS. На Windows ей нужен iTunes и iCloud в версиях с сайта Apple, а не из Microsoft Store — Sideloadly сам подскажет, если их нет.

1. Подключите iPhone кабелем, разблокируйте его и нажмите «Доверять этому компьютеру».
2. Перетащите Clauder-<версия>.ipa в окно Sideloadly.
3. Впишите свой Apple ID и нажмите Start. Пароль и код двухфакторной проверки программа спросит сама.
4. На iPhone откройте Настройки → Основные → VPN и управление устройством, найдите свой Apple ID и нажмите «Доверять».
5. На iOS 16 и новее ещё один шаг: Настройки → Конфиденциальность и безопасность → Режим разработчика — включить и перезагрузить телефон. Без него приложение не запустится.

Подпись живёт 7 дней

С бесплатным Apple ID подпись действует семь дней. Потом приложение перестаёт открываться — данные при этом не пропадают, нужно просто подписать его заново: снова перетащить тот же .ipa в Sideloadly и нажать Start. Настройки и ключ останутся.

Чтобы не вспоминать об этом каждую неделю:

• Sideloadly умеет продлевать подпись сам, если компьютер включён, а iPhone в той же сети Wi-Fi (галка автоматического обновления в настройках программы).
• AltStore делает то же через свой сервер на компьютере: ставите .ipa через него, и он продлевает подпись по Wi-Fi, пока компьютер и телефон видят друг друга.

Ещё ограничения бесплатного Apple ID: одновременно подписанных так приложений — не больше трёх на устройство, и за неделю можно подписать не больше десяти разных приложений.

С платным аккаунтом разработчика подпись живёт год, но оплатить его получается не из всех стран — для Clauder он не нужен.

Без Apple ID: TrollStore

Если на устройстве стоит TrollStore, приложение ставится без Apple ID и без продления раз в неделю: подпись не истекает, лимиты бесплатного Apple ID не тратятся. Для этого есть отдельная сборка — Clauder-<версия>-trollstore.ipa.

• Установка — в TrollStore «+» → «Install from URL» с адресом .ipa или открыть файл в TrollStore из «Файлов».
• Обновили поверх, а виджет стал пустым белым прямоугольником — в TrollStore откройте Settings → Rebuild Icon Cache. После этого iOS заново спросит разрешение на уведомления.
• Пушей и Universal Links эта сборка не добавляет: код подключения по-прежнему идёт через страницу clauder.varyen.net/connect.

Подключение к серверу

При первом запуске приложение спросит адрес. Проще всего — снять QR-код: его показывает раздел Подключение → Подключение по QR в настройках Clauder на компьютере. Можно ввести адрес и ключ руками. Код понимает и обычная камера iPhone: она откроет страницу clauder.varyen.net/connect, а кнопка Открыть в приложении на ней передаст адрес и ключ в Clauder.

Сразу после первого запуска iOS спросит разрешение на доступ к локальной сети — его нужно дать, иначе до домашнего компьютера приложение не достучится.

Подключайте телефон к приложению на компьютере (или к серверу в докере на постоянном адресе), а не к тому, что может перезапускаться: если сервер пропал, уже открытая страница продолжит показывать то, что успела загрузить, но в новые разделы не перейдёт.

Виджеты и быстрые действия

На экран «Домой» ставятся два виджета Clauder:

• «Агенты» — маленький показывает, сколько агентов работает и сколько ждёт ответа; средний — до четырёх чатов со статусом; большой — до шести, с последним сообщением каждого. Тап по строке открывает этот чат, тап мимо строк — экран агентов. На iOS 16 и новее тот же виджет ставится на экран блокировки.
• «Недавние чаты» — последние чаты, тап открывает нужный.

Виджеты обновляются раз в 5–15 минут — чаще iOS не даёт — и сразу, когда открываете приложение. Если сервер не отвечает, под надписью видна причина. Работают и при подписи бесплатным Apple ID через Sideloadly.

Долгое нажатие на значок приложения даёт «Новый чат», «Агенты» и «Чаты». Появляются они после первого запуска.

Фоновая проверка

Пока приложение закрыто, оно время от времени само спрашивает сервер: если агент начал ждать ответа, придёт уведомление (тап ведёт в его чат), а на значке появится число ждущих. Открыли приложение — число гаснет.

Это не пуши. Когда проверять, решает iOS: обычно раз в десятки минут, и никогда — если в настройках iOS выключено фоновое обновление приложений или включён режим энергосбережения. Вопрос, заданный через минуту после того, как вы свернули приложение, всплывёт с такой задержкой.

Обновление

Ставить новую версию из самого приложения нельзя — iOS этого не даёт. Новый .ipa подписывается и ставится так же, как первый: Sideloadly, AltStore или TrollStore. Настройки и ключ при этом остаются. А интерфейс приезжает с сервера, поэтому после обновления Clauder на компьютере новые возможности веб-морды появляются и здесь, без переустановки.

Чего нет по сравнению с Android

• Настоящих фоновых уведомлений. iOS замораживает приложение через несколько секунд после сворачивания, а фоновые пуши требуют платного аккаунта и сервиса Apple. Пока приложение открыто, уведомления о вопросах агента приходят сразу; в фоне — только с задержкой фоновой проверки. Если нужно сразу — бот Telegram.
• «Поделиться в Clauder» из других приложений.
• Телефона как исполнителя и сервера на самом устройстве.

Если что-то не так

• Приложение не открывается, мелькает и закрывается — истекла подпись (прошло 7 дней) или не включён режим разработчика. Подпишите заново.
• «Не удалось проверить приложение» — не нажали «Доверять» в «VPN и управление устройством».
• Белый экран или «сервер недоступен» — проверьте, что компьютер включён и телефон в той же сети; в приложении есть кнопки «Повторить» и «Сменить сервер».