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 нужен для максимальной кастомизации.

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