Hola, Amigos! На связи Павел Гершевич, Mobile Team Lead в Amiga. Не всё, что нам нужно, упаковано в библиотеки, поэтому иногда мы пишем решения сами. После этого возникает желание завернуть код в пакет и отправить на pub.dev, чтобы облегчить работу другим разработчикам. А может, вы сами создаете полезное SDK и внедряете поддержку Flutter.
И перед публикацией встает вопрос: какую лицензию выбрать? Давайте разбираться.

Сегодня мы рассмотрим лицензии для Open Source проектов, которые чаще всего используют библиотеки под Dart и Flutter - MIT (uuid, flutter_svg), BSD-3-Clause (библиотеки от команд Dart и Flutter) и Apache 2.0 (clock, rxdart).

Все они относятся к категории разрешительных: позволяют использовать, модифицировать и распространять код. Но отличия у них всё-таки есть. Давайте разбираться.

Лицензия MIT запрещает предъявлять иски к авторам. Для ее использования нужно оставить уведомления в коде и файл с текстом самой лицензии. Можно сказать, что она является базовой. Ее стоит выбирать для небольших проектов и примеров кода.

Лицензия BSD-3-Clause максимально похожа на MIT, но в нее добавлен пункт о запрете рекламы от имени автора. Ее можно выбрать, если вы не хотите, чтобы ваше имя использовали для рекламы чужого продукта.

Лицензия Apache 2.0 является самой защищенной, хотя у нее нет полноценного пункта о запрете рекламы от имени автора (только при согласовании), но она максимально защищает патенты. Еще одно отличие - нужно указывать изменения в коде, если мы модифицируем библиотеку. Такую лицензию выбирают, если проект серьезный и имеет патенты.

Еще одно важное отличие - совместимость с лицензиями GPLv3. MIT и BSD-3-Clause имеют совместимость только с GPLv2, поэтому их можно использовать в проектах с GPLv3, но не наоборот. А вот у Apache 2.0 есть полная совместимость.

P.S. В 2024 году мы анонсировали набор библиотек Amiga Dev Screen. Сейчас мы его активно заканчиваем, а также выбрали для него лицензию MIT.

Hola, Amigos! Мы постоянно стремимся уменьшить написание boilerplate кода, поэтому вводим новую рубрику - полезные extensions, где будем рассказывать о небольших кусочках кода, которые спасают нас каждый день. А начинаем мы со String.

Первое расширение позволит нам ускорить проверку на пустую строку.

extension NullableStringX on String? {
  bool get isNullOrBlank => this == null || this.trim().isEmpty();
}

Пример:

final String? s = null;
s.isNullOrBlank; // true

'   '.isNullOrBlank // true
'test'.isNullOrBlank // false

Второе позволяет сделать первую букву строки заглавной, а также сделать это для предложений.

extension StringX on String {
  String capitalize() => this.trim().isEmpty ? this : '${this.trim()[0].toUpperCase()}${this.trim().substring(1).toLowerCase()}';

  String capitalizeSentense() => this.split('.').map((e) => e.capitalize()).join('. ').trim();
}

Пример:

'мое ПрЕдЛоЖеНиЕ РАЗНОГО размера'.capitalize() // Мое предложение разного размера

'три. слова. точка.'.capitalizeSentense() // Три. Слова. Точка.

Еще одно позволяет скопировать в Clipboard для дальнейшей вставки вместо дополнительного создания объектов в коде.

extension StringX on String {
  void copyToClipboard() => Clipboard.setData(ClipboardData(text: this));
}

В следующий раз мы разберемся с расширениями, которые помогут нам с валидацией данных и конвертацией.

Рассказывайте в комментариях, используете ли вы extensions на проектах?

Hola, Amigos! На связи Павел Гершевич, Mobile Team Lead в Amiga. Сегодня поговорим о том, как защитить свой код от любопытных глаз и сделать реверс-инжиниринг практически невозможным, используя обфускацию.

Обфускация - процесс преобразования кода, чтобы он перестал быть понятным для человека, но его работоспособность не изменилась.

Как обфусцировать сборку?

Делать это, разумеется, необходимо при сборке для публикации. Например, мы собираем Android App Bundle:

flutter build appbundle --obfuscate --split-debug-info=/symbols

Параметр obfuscate запускает саму обфускацию, а уже split-debug-info выдает специальные файлы, которые помогут расшифровать информацию. Для этого мы указываем директорию, куда их нужно сложить.

Как расшифровать Stack Trace?

Для расшифровки также существует команда, в которую нужно будет передать файл Stack Trace и файл для расшифровки.

flutter symbolize \
  -i <stack-trace-file> \
  -d <obfuscated-symbols-file>

Сам файл расшифровки нужен для нужной нам архитектуры. Например, для Android на arm64 нужен будет файл app.android-arm64.symbols.

Добавляем файл в Crashlytics

Если мы используем Firebase Crashlytcs или любую подобную систему, то и там мы будем видеть нерасшифрованный Stack Trace. Чтобы этого не случалось, нужно выполнить команду для загрузки символов. Для Firebase она такая:

firebase crashlytics:symbols:upload --app=<firebase-app-id> <path-to-symbols>/symbols

Учтите, что Firebase App ID должен еще и соответствовать платформе - отдельно для Android, отдельно для iOS.

Если вы уже автоматически отправляете dSYM файлы для iOS в Crashlytics, то вам ничего не нужно делать, так как символы уже будут загружены.

Делитесь в комментариях, используете ли обфускацию на проектах?

Hola, Amigos! Сегодня мы посмотрим, чем отличаются 2 виджета для вывода текста - RichText и Text.rich, а также разберемся, какой из них лучше использовать.

RichText из них основной. Он позволяет нам отрисовывать текст с применением нескольких стилей, а также добавлением виджетов внутрь. Простой пример применения - выделение части текста жирным или курсивом:

RichText(
  text: TextSpan(
    children: [
      TextSpan(text: ‘Обычный текст. ‘, style: TextStyle(fontSize: 14, color: Colors.black)),
      TextSpan(text: Жирный текст. ‘, style: TextStyle(fontSize: 14, color: Colors.black, fontWeight: FontWeight.bold)),
      TextSpan(text: ‘Снова обычный текст.‘, style: TextStyle(fontSize: 14, color: Colors.black)),
    ],
  ),
);

С другой стороны, нам нужно каждый раз применять стиль текста к RichText, а также передавать ему textScaler. Эту проблему можно решить при помощи Text.rich, но он уже менее гибкий, чем RichText, так как в нем сложнее сделать что-то по-максимуму кастомное.

Text.rich(
  TextSpan(
    children: [
      TextSpan(text: ‘Обычный текст. ‘),
      TextSpan(text: Жирный текст. ‘, style: TextStyle(fontSize: 14, color: Colors.black, fontWeight: FontWeight.bold)),
      TextSpan(text: ‘Снова обычный текст.‘),
    ],
  ),
);

Получается, что для большинства случаев нам подойдет именно Text.rich, а RichText нужен для максимальной кастомизации.

Рассказывайте в комментариях, какой из них чаще используете в своей работе?

Hola, Amigos! На связи Павел Гершевич, Mobile Team Lead в Amiga.

Иногда бэкенд не может помочь с поиском по строкам или его нужно реализовать полностью на локальных данных. Мы столкнулись именно с такой задачей.

В новой статье на Хабре разбираем, как прокачать локальный поиск с помощью математических алгоритмов и делимся нашим опытом реализации на Dart & Flutter.

🔗 Ссылка на статью

Делитесь в комментариях, сталкивались ли вы с похожими кейсами?

Hola, Amigos! Наш Mobile Team Lead Павел Гершевич примет участие в активности под названием “Квартирник” на конференции CodeFest 16.

Квартирник - особый формат, где спикеры и эксперты общаются с залом на определенную тему. Павел вместе с Егором Поповым из Открытых Мобильных Платформ обсудят и ответят на вопросы касаемо кроссплатформы:

Почему одни фреймворки постоянно на слуху, а про другие мы не видим множества статей и докладов?
Есть ли границы у кроссплатформы? Можем ли мы написать одно приложение под все существующие устройства?
В чем преимущества и недостатки кроссплатформы?

Готовьте вопросы и приходите пообщаться с Павлом лично. Встречаемся 30 мая в 15:00 (11:00 МСК) на "Квартирнике" в Новосибирске!

Ссылка на квартирник

Hola, Amigos! Начинаем новую рубрику, где будем рассказывать вам про полезные Snippet’ы, которые вы можете добавить к себе в IDE для ускорения разработки. В дальнейшем ее найдете по хештегу #snippet. Сегодня поговорим про сниппеты для жизненного цикла StatefulWidget.

Сниппет для быстрого добавления initState - initS:

@override
void initState() {
  super.initState();

  // Your code here
}

Сниппеты для быстрого добавления dispose - dis и disF:

@override
void dispose() {
  // Your code here

  super.dispose();
}

@override
Future<void> dispose() async {
  // Your code here

  super.dispose();
}

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

Hola, Amigos! Продолжаем рубрику с полезными extensions. Сегодня поговорим про расширение DateTime.

Можно получить информацию совпадает ли дата с сегодняшней, вчерашней или завтрашней:

extension DateTimeX on DateTime {
  bool get isToday {
    final now = DateTime.now();
    return day == now.day && month == now.month && year == now.year;
  }

  bool get isTomorrow {
    final tomorrow = DateTime.now().add(Duration(days: 1));
    return day == tomorrow.day + 1 && month == tomorrow.month && year == tomorrow.year;
  }

  bool get isYesterday {
    final yesterday = DateTime.now().subtract(Duration(days: 1));
    return day == yesterday.day - 1 && month == yesterday.month && year == yesterday.year;
  }
}

Можно получить сколько дней разницы до сегодня:

extension DateTimeX on DateTime {
  int get daysDiff => this.difference(DateTime.now).inDays;
}

Делитесь в комментариях, про расширения для каких классов вы еще хотите узнать?

#extensions