Skip to content

artembark/surf-flutter-study-jam-template

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Итоговый проект в ветке day-1

Описание итогового приложения находится в папке docs ветки day-1

Flutter Study Jam 2

Требования к приложению

  • Версия Flutter: 3.0.5
  • Версия Dart: 2.17.1

Ваша ветка с выполнением задания должна называться study-jam-2/day-1.

В шаблонном приложении у вас уже есть базовая реализация чата. Но, чтобы получить доступ к чату, для начала нужно авторизоваться.

Эмоджи 🔥 показывает задание повышеной сложности.

День 1

Авторизация

Как получить аккаунт?

  1. Перейдите на сайт авторизации.
  2. Нажмите на кнопку "Sign in with Github"
  3. Дайте нужные права приложению
  4. Для вас сгенерируется уникальные логин и пароль. Сохраните их обязательно!

Эти логин и пароль вы сможете использовать для реализации экрана авторизации.

Задание 1. Интерфейс

Реализовать пользовательский интерфейс экрана авторизации.

Auth screen

Задание 2. Логика

Нужно реализовать логику авторизации.

Для реализации экрана вам доступен класс IAuthRepository. В нём уже реализована базовая работа с сервером и обработка ошибок (вносить изменения в класс не запрещается). Его метод signIn принимает данные пользователя:

  • login - ваш email, который вы присылали для регистрации
  • password - пароль, который пришёл вам на email

При успешной авторизации вы получите токен, который потребуется для других запросов. Его нужно сохранить в постоянной памяти. Вы можете использовать любое удобное вам хранилище (мы в Surf часто используем shared_preferences).

При успешном сохранении токена, вы сможете воспользоваться методом pushToChat для перехода на экран чата (ChatScreen).

Задание 3. Снекбар

Реализовать отображение SnackBar при ошибке.

Auth screen snackbar

Чат. Рефакторинг

Для вас этот экран покажется знакомым, если вы участвовали в нашем первом Study Jam в феврале. Вам не нужно реализовывать экран во второй раз. Вместо этого вам нужно будет доработать уже существующий экран.

Chat screen

Задание 1. Сообщение геолокации

Помимо обычных сообщений типа ChatMessageDto, вам может встретиться его наследник ChatMessageGeolocationDto.

Реализуйте отображение такого сообщения в пользовательском интерфейсе.

Задание 2. Открытие карты с геолокацией 🔥

По нажатию на кнопку "Открыть на карте" должно открываться одно из приложений карт, доступных на устройстве. Это может быть любое первое попавшееся приложение.

Задание 3. Отправка геолокации 🔥

Также вы можете сами отправить сообщение с геолокацией, передав эту модель ChatMessageGeolocationDto в метод IChatRepository.sendMessage.

Конечно же отправлять нужно настоящую геолокацию! Вы можете сделать, например, с помощью пакета geolocator.

Задание 4. Отображение изображения

Помимо геолокации у вас есть и другие виды сообщений. Например, изображение. Для этого вы можете сделать модель ChatMessageImageDto, и параметр imageUrl, в котором будеть содержаться ссылка на фотографию.

Задание 5. Отправка изображения 🔥

Как и в случае с геолокацией, вам нужно уметь отправлять сообщения. Для этого вы также можете воспользоваться методом IChatRepository.sendMessage и отправить туда сообщение типа SendMessageImageDto, которое понимает в себя параметр типа File.

Задание 6. Аватарки 🔥

Сейчас все аватарки у пользователей одинаковые и скучные :(

Сделайте так, чтобы у аватарки каждого пользователя в чате был свой уникальный цвет. Например, аватарка Пети Сидорова должна отображаться как "ПС" в центре аватара и иметь розовый цвет на всех сообщениях в чате. При перезапуске приложения или установке его на другое устройство у Пети Сидорова должен быть тот же самый уникальный цвет, а у Васи Иванова - свой.

Задание 7. Баблы

Добавьте отображение сообщений в чате в виде баблов, как во всех популярных мессенджерах.

Креатив 🔥🔥🔥

Успели сделать все задания раньше всех или просто хотите выделиться? Доработайте чат по своему усмотрению!

Метод sendMessage помимо прочего принимает параметр payload типа Playload. Этот метод нужен для того, чтобы вы могли добавить к сообщению любые данные, которые захотите.

День 2

Список топиков

Оказывается у нас есть не один чат!

Задание 1. Интерфейс

Реализуйте пользовательский интерфейс для экрана топиков.

Задание 2. Имя пользователя 🔥

Добавьте отображение вашего реального имени пользователя в AppBar экрана. Для этого вам стоит вернуться к результатам первого дня и сохранить в постоянно хранилище ещё и имя пользователя, которое приходит вам в модели ChatUserDto.

Задание 3. Список топиков

Реализуйте отображение списка топиков на экране. Для этого у нас есть класс IChatTopicsRepository. Если у вас всё получится, то должен вернуться, как минимум, один топик "Общий чат". Это тот самый чат, который вы использовали вчера.

Задание 4. Навигация

Измените навигацию так, чтобы после успешной авторизации показывался именно экран Списка топиков, а не базовый чат.

Создание своего топика

Задание 1. Интерфейс

Реализуйте пользовательский интерфейс для экрана Создания топиков.

Задание 2. Отправка топика

С помощью того же IChatTopicsRepository реализуйте создание нового топика, отправив название.

Креатив 🔥🔥🔥

Также, как и с чатами, вы можете проявить креатив, если успели сделать все задания! Помимо возможности отправить название топика, у вас есть возможность отправить payload (подробнее в документации к классу Payload).

Предоставление результатов

Умение защитить результаты своей работы - невероятно важный навык для разработчика.

В текущем проекте есть файл /docs/RESULT.md. Этот шаблон нужен как раз для того, чтобы вы могли поделиться результатами вашей работы. Вы можете записать скринкаст, сделать скриншоты или целый README-файл, в котором будет описано, что вы успели сделать.

Это один из критериев, по которому будет оцениваться ваша работа!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 82.1%
  • HTML 12.0%
  • Ruby 4.2%
  • Swift 1.2%
  • Other 0.5%