EN | [RU]

Пример использования Supabase с Flutter

Этот пример приложения демонстрирует интеграцию supabase.com с Flutter-приложением для ОС Аврора и показывает, как выполнять распространённые операции с базой данных и аутентификацией.

Содержание

• Установка и настройка
  • Настройка Supabase
  • Настройка для ОС Аврора
• Скриншоты
• Совместимость
• Функциональные сценарии
• Структура проекта
• Известные проблемы
• Правила использования и участие в разработке

Установка и настройка

Настройка Supabase

Создание проекта Supabase

Для интеграции необходимо создать проект Supabase на supabase.com.

Настройка учетных данных Supabase

В файле lib/main.dart требуется инициализировать Supabase SDK с использованием URL проекта и анонимного ключа:

await Supabase.initialize(
  url: 'YOUR_SUPABASE_URL',         // Заменить на URL вашего проекта
  anonKey: 'YOUR_SUPABASE_ANON_KEY' // Заменить на публичный ключ проекта
);

Пояснение:

• SUPABASE_URL: уникальный адрес проекта, доступный в панели управления Supabase.
• SUPABASE_ANON_KEY: публичный ключ для клиентского (анонимного) доступа.

Рекомендация по безопасности: для продакшн-приложений рекомендуется использовать переменные окружения (например, через flutter_dotenv) вместо хранения ключей напрямую в коде.

Создание таблицы в Supabase

В консоли Supabase создать таблицу profiles со следующими полями:

• id: uuid
• username: text
• website: text

Настройка для ОС Аврора

Разрешения в .desktop-файле

Для корректной работы Supabase требуется доступ в интернет. В .desktop-файле, расположенном по пути aurora/desktop/ru.aurora.supabase_aurora_example.desktop, должно быть указано разрешение:

[X-Application]
Permissions=Internet

Скриншоты

Совместимость

• Flutter: Версия 3.27.3 и новее
• Supabase: Совместим с текущими функциями Supabase
• ОС Аврора: Протестировано с ОС Аврора 5.0.0 и выше

Функциональные сценарии

Аутентификация пользователя

• Регистрация: Ввод email и пароля, нажатие "Signup"
• Вход: Ввод email и пароля, нажатие "Login"
• Выход: Кнопка "Sign Out" на экране профиля

Управление профилем

• Просмотр профиля: Отображение имени и веб-сайта текущего пользователя
• Обновление профиля: Редактирование имени и/или сайта и нажатие "Save"

Структура проекта

Проект следует стандартной структуре Flutter-приложения с поддержкой ОС Аврора:

• lib/main.dart: Основная логика приложения, интерфейс и интеграция с Supabase
• aurora/: Каталог с файлами, специфичными для ОС Аврора
• pubspec.yaml: Зависимости, включая supabase_flutter и переопределения под ОС Аврора

Известные проблемы

При сборке может возникнуть MissingPluginException, связанное с методом listen на канале com.llfbandit.app_links/events. Это происходит из-за отсутствия реализации плагина app_links для ОС Аврора.

Важно: Эта ошибка не влияет на работу Supabase и может быть проигнорирована, если приложение функционирует корректно.

Правила использования и участие в разработке

Исходный код проекта предоставляется по лицензии, которая позволяет использовать его в сторонних приложениях.

Для участия в развитии проекта, пожалуйста, ознакомьтесь с cоглашением участника. Если Вы планируете присылать свой исходный код для включения в состав проекта, Вам понадобится принять условия CLA.

Информация об участниках указана в файле AUTHORS.

Кодекс поведения — это действующий набор правил компании «Открытая Мобильная Платформа», который информирует об ожиданиях по взаимодействию между членами сообщества при общении и работе над проектами.