Hola, Amigos! Русскоязычные каналы разработчиков на Flutter — большая редкость в телеграм. Поэтому срочно делимся с вами находкой!

Канал ведет Саша Ворожищев, руководитель Flutter/iOS-разработки AGIMA. Это не новостной канал, автор делится: статьями о мобильной разработке, исследованиями, классными подходами, трендами в IT. Плюс щепотка юмора и музыки👆

Загляните на канал Саши и подпишитесь!

Completer в Flutter для работы с асинхронностью

Hola, Amigos! Completer — это вспомогательный класс, который позволяет нам создавать Future объекты. Как вы знаете, Future — это тип данных, который представляет собой результат асинхронной операции. Все асинхронные функции в Flutter возвращают Future и позволяют вам работать с результатами операции, когда они становятся доступными.

Completer приходит на помощь, когда вы хотите создать собственную синхронную функцию, которая также возвращает Future. Это может быть полезно, когда вам необходимо выполнить какие-то операции внутри функции и предоставить результат для будущего использования.

Примеры создания Completer объектов:

final stringCompleter = Completer<String>();
final voidCompleter = Completer<void>();
final dynamicCompleter = Completer();
final nullableStringCompleter = Completer<String?>();

Completer используется для представления значения будущему объекту и для запуска всех ожидающих обратных вызовов. Вы можете завершить Completer, как показано ниже:

stringCompleter.complete('foo');

Или, если вы хотите получить результат из функции обратного вызова, вы можете использовать его future свойство:

final valueFuture = stringCompleter.future;
final value = await valueFuture;

Также, Completer предоставляет метод isCompleted, который позволяет вам узнать, завершился ли Completer:

final isCompleted = stringCompleter.isCompleted;

⚠️ Важно помнить, что Completer — это односторонний процесс, и его нельзя перезапустить после завершения.

Рассмотрим работу и использование Completer на двух примерах.

1️⃣ Пример

Нам нужно получить значения переменной из функции обратного вызова.

См. скриншот 1: мы имитируем асинхронную операцию и желанием получить значение переменной time, но как нам это сделать вне функции?

См. скриншот 2: на помощь приходит Completer, благодаря которому мы можем получить значение переменной вне зоны видимости функции обратного вызова после завершения асинхронной операции:

final valueFuture = stringCompleter.future;
final value = await valueFuture;

2️⃣ Пример

Если вам доводилось разрабатывать клиент-серверные приложения, то вы, скорее всего, сталкивались с проблемой отправки нескольких запросов. Например, при авторизации в системе пользователю требуется заполнить поля логина и пароля, затем отправить запрос на сервер тапом на кнопку «Войти». Но что, если пользователь нажмёт на неё более 1 раза? В данном случае на сервер пойдут конкурентные запросы, что не является хорошей практикой.

См. скриншот 3: эту проблему можно решить как на стороне Flutter, используя Debouncer, но это также решает Completer с помощью вышеупомянутого. Мы дополним пример выше и имитируем несколько нажатий пользователем с помощью цикла for. Добавив условие управления Future, в котором мы проверяем закончил ли Completer свою работу, мы выходим из цикла и получаем нужное нам значение единожды.

Таким образом, Completer можно использовать как своеобразную защиту от дублирующих запросов на сервер или создания пользователем дублирующих асинхронных операций.

Успешной вам разработки! Отправляйте реакцию, если было полезно😉

Камера и Flutter

Hola, Amigos! На связи Александр Чаплыгин, Flutter-dev в Amiga. Недавно я выступал на конференции для разработчиков DevFest в Омске с докладом «Камера и Flutter». Решил поделиться с вами впечатлениями о своем первом выступлении и для тех, кого не было на конференции, рассказать про проект, в котором использовалась библиотека Google ML Kit Barcode Scanning.

Переходите по ссылке, там все подробности⬆️ Обязательно дайте знать в комментариях, понравилась ли вам статья!

Пакет geolocator

Hola, Amigos! Сегодня мы поговорим о пакете geolocator, который поможет вам интегрировать геолокацию в ваши Flutter приложения. Эта функция полезна различным приложениям и бизнесам, которые зависят от геолокации или могут использовать ее в своих преимуществах: доставка, соцсети и знакомства, логистика, медицина др.

Что такое geolocator?
geolocator позволяет получать информацию о текущем местоположении, следить за изменениями координат, а также определять расстояния между точками.

Пример использования
1️⃣ Добавьте зависимость: Сначала добавьте geolocator в файл pubspec.yaml вашего проекта.

dependencies:
geolocator: ^7.7.0

2️⃣ Импортируйте пакет:

import 'package:geolocator/geolocator.dart';

3️⃣ Используйте geolocator:

// Инициализируем Geolocator
final geolocator = Geolocator();

// Получаем текущее местоположение
Position position = await geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.high);

// Используем полученные данные
print('Широта: ${position.latitude}, Долгота: ${position.longitude}');

Готово!⚙️

Не забывайте, что для использования #пп geolocator, вам необходимо настроить пользовательское разрешение для доступа к геолокации. Об этом подробнее в следущем посте.

А пока делитесь в комментариях, кто уже использовал в своих приложениях пакет geolocator. Расскажите, что это был за проект? Нам интересно узнать, о вашем опыте ⚙️

Запрос разрешений

Hola, Amigos! В посте выше мы делали обзор пакета geolocator. Сегодня уделим внимание пользовательскому разрешению для доступа к геолокации, ведь без него использование пакета невозможно.

Запрос разрешений — это важный шаг, который поможет вам обеспечить соблюдение приватности пользователей и убедиться, что приложение работает корректно с доступом к геолокации.

На платформе Android вам потребуется запросить следующие разрешения:

🟡ACCESS_FINE_LOCATION или ACCESS_COARSE_LOCATION: Эти разрешения используются для получения точного местоположения на устройстве.
🟡INTERNET: Для доступа к сети, например, для получения данных о местоположении с использованием GPS.
🟡ACCESS_BACKGROUND_LOCATION: Если ваше приложение должно иметь доступ к местоположению в фоновом режиме.

На iOS разрешения работают следующим образом:

🔵NSLocationWhenInUseUsageDescription: Разрешение на использование местоположения, когда приложение активно.
🔵NSLocationAlwaysUsageDescription: Разрешение на использование местоположения даже в фоновом режиме.
🔵NSLocationAlwaysAndWhenInUseUsageDescription: Разрешение на использование местоположения и в активном, и в фоновом режиме.

Не забудьте предоставить ясное объяснение пользователю о том, зачем вашему приложению нужен доступ к его местоположению, и почему это важно.

При работе с разрешениями в Flutter, вы также можете использовать пакет permission_handler, чтобы упростить процесс запроса и проверки разрешений на разных платформах.

Разрабатывайте приложения с заботой о пользователях ⚙️

Поделитесь в комментариях, над каким проектом работаете сейчас? Мы вот ковыряемся в ecom проекте, победили наконец-то видеоплеер. Но это уже совсем другая история…

Подход к легаси проектам

Hola, Amigos! Нам часто приходится сталкиваться с легаси проектами. Это настоящая боль проблема, когда нужно:

🟡несколько версий Flutter SDK на одной машине.
🟡«потрогать» (Beta channel) версии Flutter.
🟡проверить гипотезу на другой версии Flutter SDK.
🟡разрабатывать пару проектор на разных версиях Flutter SDK.
🟡проверить работу проекта на новой версии Flutter SDK.
🟡и т.д.

Есть путь самурая, т.е. устанавливать разные версии Flutter SDK и как-то ими «жонглировать».

Есть путь рабочего человека, т.е. использовать решение Flutter Version Management (FVM).

Рекомендуем воспользоваться последним.

Из плюсов:
1️⃣ быстрая установка.
2️⃣ легко переключаться между версиями Flutter SDK — fvm use 3.13.6
3️⃣ легко установить нужную версию Flutter SDK — fvm install 3.7.12

Всем удачного кода! Делитесь в комментариях своими лайфхаками работы с проектами, которые достались вам по наследству от других разработчиков.

Sliver во Flutter

Hola, Amigos! Sliver — мощный инструмент для настройки и создания эффектов прокрутки в вашем приложении Flutter. Он идеально подходит для обработки множества дочерних виджетов, которые могут меняться при прокрутке.

Разновидности Sliver:

➡️ SliverAppBar: Плавающий или изменяющийся при прокрутке заголовок.
➡️ SliverList: Список элементов в прокручиваемой области.
➡️ SliverGrid: Элементы в 2D-сетке.
➡️ SliverPersistentHeader: Фиксированный заголовок при прокрутке.
➡️ SliverFixedExtentList: Фиксированный список элементов с одинаковой высотой.

Перед использование Sliver нужно ознакомиться с CustomScrollView. Это виджет типа ScrollView, который позволяет создавать различные эффекты прокрутки: сетка, списки и др. Он имеет свойство sliver, которое принимает список виджетов:

CustomScrollView(slivers: [
SliverAppBar(...),
SliverPadding(...),
SliverList(...),
SliverGrid(...),
]

Типичные сценарии реализации Slivers:

🔴Плавающий заголовок с изменением цвета и размера при прокрутке.
🔴Прокрутка списка или сетки элементов.
🔴Прокрутка списка с фиксированным заголовком.

Для немедленного отображения списка элементов мы используем SliverChildDelegate, тогда как для отложенной загрузки itemList — SliverChildBuilderDelegate.

Slivers помогают обеспечить более продвинутую, настраиваемую и лучшую возможность прокрутки. Пользуйтесь!

В следующем посте расскажем, как работать с гридами. Ставьте реакцию, если ждете!

Responsive_framework

Hola, Amigos! На связи Ярослав Цемко, Flutter-разработчик Amiga. Рад со всеми познакомиться и поделиться своей первой статьей на Habr, в которой я рассказал о крутом плагине Responsive_framework в контексте одного из наших проектов ⚙️

Изначально задача состояла в том, чтобы в приложении на разных девайсах: веб, мобильный телефон и специальный планшет был удобный интерфейс и красивая картинка.

Мы пробовали несколько путей реализации, и у каждого из них свои сложности и ограничения. Всё подробно рассказал в статье.

Буду рад вашим комментариям! И если у кого-то из наших подписчиков есть инвайт на Habr, то напишите, пожалуйста, нашей амиговке Арине @arina_na_na ⚙️

SliverGrid: Как работать с Гридами

Hola, Amigos! SliverGrid — это инструмент для создания двумерных массивов элементов для прокрутки и отображения данных.

Виджет использует параметр делегата, который указывает, как расположить ваши дочерние элементы в сетке.

SliverGrid предоставляет несколько конструкторов, которые позволяют выбрать подходящий макет сетки в зависимости от ваших потребностей:

🦋 Конструктор-счетчик: Используется для указания количества элементов на горизонтальной оси. Это позволяет контролировать, сколько элементов помещается в строке.

SliverGrid.count(
children: scrollItems, // Ваши элементы
crossAxisCount: 3, // Количество элементов в строке
)

🦋 Конструктор экстента: Позволяет указать максимальную ширину элементов, чтобы определить, сколько элементов должно поместиться в сетке.

SliverGrid.extent(
children: scrollItems, // Ваши элементы
maxCrossAxisExtent: 75.0, // Максимальная ширина элемента
)

🦋 Конструктор по умолчанию: Этот конструктор принимает дополнительный параметр gridDelegate. Данный параметр принимает класс SliverGridDelegateWithFixedCrossAxisCount, который, помогает зафиксировать количество элементов на горизонтальной оси.

SliverGrid(
gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
crossAxisCount: 4, // Количество элементов в строке
),
delegate: SliverChildBuilderDelegate(
(BuildContext context, int index) {
return scrollItem(); // Вставьте сюда свой виджет
}
)
)

С SliverGrid в вашем арсенале Flutter вы сможете легко и красочно оживить свой интерфейс сеток. Успехов в разработке!

Ставьте реакцию, если было полезно ⚙️ В следующем посте расскажем про динамические Slivers.

Динамические Slivers

Hola, Amigos! После того, как мы изучили фундаментальные примеры Slivers, давайте перейдем к более продвинутым функциям и посмотрим на Slivers в действии ⚙️

Чтобы сделать прокрутку более отзывчивой и адаптивной к действиям пользователей, рассмотрим возможность использования «динамических» Slivers — SliverFillViewport.

Этот виджет регулирует размер своих дочерних элементов в зависимости от текущего размера области просмотра, гарантируя, что вид прокрутки всегда заполняет весь экран.

CustomScrollView(
slivers: [
SliverFillViewport(
delegate: SliverChildListDelegate(
[
Container(color: Colors.red, height: 150.0),
Container(color: Colors.purple, height: 150.0),
Container(color: Colors.green, height: 150.0),
]
),
viewportFraction: 0.3
),
]
)

SliverFillViewport использует свойство viewportFraction, чтобы определить, какую часть экрана каждый дочерний виджет будет заполнять. В приведенном выше коде каждый виджет будет заполнять треть (0,3) экрана.

Slivers легко настраиваются, это качество распространяется и на их дочек. Такие виджеты как SliverChildBuilderDelegate и SliverChildListDelegate могут присваивать уникальные идентификаторы каждому дочернему элементу, что открывает двери для креативных анимаций и переходов ⚙️ ‍

Успехов в разработке! Пишите в комментариях о вашем опыте использования Slivers в проектах.

Обзор пакета flutter_blue_plus

Hola, Amigos! Сегодня начнем с вами рассматривать многогранную тему Bluetooth во Flutter.

Один из самых популярных пакетов flutter_blue_plus позволяет сканировать устройства и устанавливать с ними соединение благодаря Bluetooth Low Energy (BLE).

⚙️ Важно: перед использованием убедитесь, что вы попросили пользователя предоставить разрешение на использование Bluetooth (пакет permission_handler).

Давайте рассмотрим основные возможности пакета.

Сканирование Bluetooth-устройств:

FlutterBluePlus flutterBlue = FlutterBluePlus.instance;
 // прослушиваем найденные девайсы
flutterBlue.scanResults.listen((results){ 
// производим действия с найденными устройствами
});

Подключение к устройствам:

После обнаружения устройств можно установить с ними соединение.

void connectToDevice(BluetoothDevice device) async{
    await device.connect();
}

Получение списка услуг от устройства:

Каждое Bluetooth-устройство предоставляет список услуг, которые оно поддерживает. Чтобы получить этот список, используйте:

final services await device.discoverServices();

Характеристики BLE-устройств:

Каждая услуга на BLE-устройствах содержит набор характеристик, которые используются для взаимодействия с устройством. Например, у сервиса Generic Access Service есть характеристики, такие как имя устройства и MAC-адрес:

for(var service in services){
  List<BlueToothCharacterictic> characteristics = service.characteristics;
}

Считывание характеристик в устройствах BLE:

Для считывания данных с Bluetooth-устройства используйте метод read(), обязательно используйте await, так как read() асинхронный.

BlueToothCharacterictic characteristics;
List<int> value = await characteristics.read();
print(value.toString());

Запись характеристик в устройства BLE:

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

List<int> dataToSend = [0x01,0x02,0x03];
await characteristics.write(dataToSend);

С Bluetooth во Flutter множество подводных камней. Ставьте реакцию, если тема инересна! И делитесь в чате разработчиков своим опытом, вместе обсудим ⚙️