Создание кросс-платформенной формы входа в FireMonkey
Кросс-платформенная форма входа позволяет собрать единый пользовательский сценарий для Android, iOS, Windows, macOS и Linux, не создавая отдельный интерфейс для каждой операционной системы. В FireMonkey такая форма разрабатывается в обычном проекте Delphi: общий дизайн дополняется платформенными особенностями, а бизнес-логика остаётся независимой от целевой системы. Подробнее о Kak Nastroit Avtorizatsiyu Cherez Google I Apple V Delphi Prilozhenii.html.
Я Равиль Зарипов, разработчик из Алматы, использую FireMonkey в проектах, где важны единый внешний вид, быстрая доставка и предсказуемая работа приложений на разных устройствах. FMX позволяет размещать элементы по правилам, адаптировать их к размеру окна и применять стили без отказа от нативных возможностей платформ.
Вход — не просто два поля и кнопка. Пользователю нужны понятные сообщения, удобная клавиатура, безопасный обмен данными, восстановление сессии и вход через внешний поставщик идентичности. Поэтому качественная реализация начинается с модели состояний и заканчивается проверкой реального окна на каждой поддерживаемой системе.
Практический путь от структуры формы до публикации включает компоновку, валидацию, авторизацию, доступность, диагностику и подготовку сборок. Такой подход подходит проектам, которым требуется несколько операционных систем без отдельной команды разработки для каждой версии интерфейса.
Проектирование структуры формы
Основу окна входа лучше разделить на независимые слои: визуальные компоненты, модель полей, координатор сценариев и клиент авторизации. В проекте FireMonkey для первого слона подходят TForm, TLayout, TEdit, TButton, TCheckBox и TImage. Службы обмена данными не должны зависеть от координат элементов или названия операционной системы — это упрощает повторное использование формы.
| Критерий сравнения | Android и iOS | Windows | macOS и Linux |
|---|---|---|---|
| Размер окна | Зависит от экрана и ориентации | Изменяется пользователем | Зависит от размера окна |
| Системная клавиатура | Появляется поверх содержимого | Используется аппаратная клавиатура | Используется аппаратная клавиатура |
| Плотность элементов | Учитываются размеры пальцев | Учитываются курсор и системное масштабирование | Учитываются курсор и системное масштабирование |
| Поведение формы | Возможна смена ориентации | Обычно постоянная ориентация | Обычно постоянная ориентация |
Перед реализацией следует определить сценарии входа: по адресу электронной почты или имени пользователя, с паролем, через внешний поставщик идентичности, с запоминанием сессии. Форма должна иметь состояния ожидания, проверки, ошибки и успеха. Каждому состоянию соответствуют доступность кнопки, текст ошибки и наличие индикатора загрузки.
Компоновку лучше строить через TLayout, TAlignLayout и свойства выравнивания, а не через фиксированные координаты. Отдельный контейнер объединяет заголовок, поля и действия,另一个 отвечает за статусное сообщение. Так решение корректно меняет размеры при повороте экрана, появлении клавиатуры или изменении системной плотности отображения.
Проверка данных и состояние интерфейса
Проверку входных данных выполняют в два прохода. Локальный проход быстро сообщает о пустом поле, очевидно неверном адресе или превышении допустимой длины. Серверный остаётся источником истины и определяет, существует ли учётная запись, верол ли пароль и разрешён ли доступ. Слишком строгая клиентская проверка адреса может отклонить допустимые международные варианты, поэтому её правила следует согласовать с сервером.
Для реактивного обновления удобно использовать TEdit.OnChange, а для финальной проверки перед отправкой — OnExit. Кнопка входа может оставаться неактивной, пока обязательные поля не заполнены, однако интерфейс должен объяснять это ограничение. Обработчик OnKeyDown позволяет отправлять форму по клавише Enter на аппаратной клавиатуре, не создавая отдельной кнопки для каждого устройства.
После запуска проверки элементы управления блокируют, чтобы исключить повторную отправку. Пользователь должен видеть, что запрос выполняется, и иметь возможность отменить длительную операцию. При ошибке пароль обычно сохраняют, чтобы пользователь исправил только адрес, а после успешного входа очищают. В журналы не записывают пароли, токены и полные адреса электронной почты.
Авторизация и защищённый обмен
Форма должна обращаться к серверу через защищённый канал, используя REST-клиент, TNetHTTPClient или подходящую библиотеку. Проверка сертификатов TLS остаётся включённой, для запросов задают тайм-аут, а ответы обрабатывают как JSON с понятной моделью ошибок. Серверный PHP-сервис или другой компонент API отвечает за учётные записи, блокировки, ограничение частоты запросов и обмен токенами.
При входе через Google или Apple клиент получает код авторизации во внешнем браузере и обменивает его на токен. Для мобильных и десктопных приложений применяют защиту PKCE, проверяют параметр состояния, а для чувствительных операций используют одноразовый nonce. Практический подход к интеграции Google и Apple показывает, как объединить обработку обратных ссылок, серверный обмен кодами и безопасное завершение сценария.
Токен доступа не следует хранить в обычных текстовых настройках. Для долгоживущей сессии используют защищённое хранилище конкретной платформы: связку ключей macOS, хранилище ключей Android или системный менеджер секретов на компьютере. Возможность «запомнить меня» реализуют через обновляемый токен, который можно отозвать. Клиентская проверка токена не заменяет серверную авторизацию каждого запроса.
Адаптация интерфейса и доступность
FireMonkey масштабирует компоненты, но разработчику всё равно нужно проверить поведение формы на узком экране, большом мониторе и в режиме высокой плотности отображения. Когда появляется системная клавиатура, сфокусированное поле должно оставаться видимым. Для этого применяют прокрутку, ограничивают размеры контейнеров и корректируют отступы при изменении доступной области окна.
Доступные названия полей располагают рядом с элементами, а не полагаются только на подсказку внутри пустого поля. Размер шрифта должен увеличиваться без наложения текста, контраст — соответствовать требованиям платформы, состояния — обозначаться не одним цветом. Размер интерактивных элементов рассчитывают с учётом касания пальцем, а сценарий с программным экранным диктором проверяют отдельно, поскольку его поддержка различается между платформами.
Интерфейс также должен поддерживать локализацию и ввод с разных раскладок. Надписи, подсказки и сообщения об ошибках выносят в строковые ресурсы, а не оставляют непосредственно в обработчиках. Для адреса электронной почты на мобильных устройствах запрашивают подходящую клавиатуру, сохраняя возможность обычного вода. Порядок фокуса между полями, флажком и кнопкой задают явно, чтобы он не менялся после загрузки локализованного интерфейса.
Тестирование и подготовка к выпуску
Проверять форму нужно на физических устройствах и в эмуляторах Android и iOS, а также в Windows, macOS и Linux с разными разрешениями, масштабами и клавиатурами. Сценарий включает пустые поля, неверный пароль, успешный вход, потерю сети, медленный сервер, смену ориентации и возврат приложения из фонового режима. Логику проверки данных покрывают автоматическими тестами, а интерфейс — дымовыми сценариями после каждой сборки.
Диагностика должна показывать техническую причину сбоя без раскрытия секретов. В журнал записывают время, версию приложения, платформу, код ответа и обезличенный идентификатор запроса. Сеть, сервер, неверные учётные данные и недоступность поставщика идентичности различают отдельными сообщениями. Это упрощает сопровождение и позволяет пользователю выбрать правильное действие.
Перед выпуском проверяют подпись пакета, разрешения, схему обратных ссылок, политику хранения данных и правила публикации в магазинах приложений. Серверная часть получает независимое обновление без обязательной публикации клиента, а изменения интерфейса не должны ломать сохранённую сессию. Такой каркас превращает форму входа в устойчивый модуль, который можно последовательно проверять, сопровождать и выпускать для всех поддерживаемых платформ.