Парсинг YAML в Flutter с помощью пакета yaml

FlutterPulse

Эта статья переведена специально для канала FlutterPulse. В этом канале вы найдёте много интересных вещей, связанных с Flutter. Не забывайте подписываться! 🚀

Пакет: yaml

Файлы конфигурации повсюду в разработке приложений — от определения настроек сборки до управления средами приложений. Хотя JSON распространен, многие разработчики предпочитают YAML за его более чистый и читаемый формат.

В Flutter и Dart пакет yamlpackage делает простым чтение и парсинг файлов YAML непосредственно в вашем приложении.

Что такое пакет `yaml`?

Пакет yaml — это библиотека Dart, которая позволяет вам:

Парсить строки YAML в объекты Dart (Map, List и т. д.)
Читать файлы конфигурации YAML (например, config.yaml)
Обрабатывать вложенные и сложные структуры YAML с легкостью

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

️ Установка

Добавьте его в ваш pubspec.yaml:

dependencies:
  yaml: ^3.1.3

Выполните:

flutter pub get

Использование в проекте Flutter

1. Парсинг простой строки YAML

import 'package:yaml/yaml.dart';

void main() {
  const yamlString = '''
  name: MyApp
  version: 1.0.0
  features:
    - login
    - dark_mode
    - notifications
  ''';
  final doc = loadYaml(yamlString);
  print('Имя приложения: ${doc['name']}');
  print('Функции: ${doc['features']}');
}

Вывод:

Имя приложения: MyApp
Функции: [login, dark_mode, notifications]

2. Чтение из файла YAML

Предположим, у вас есть файл config.yaml:

api:
  url: https://api.example.com
  timeout: 5000
features:
  enableLogin: true
  enableAnalytics: false

Загрузите и проанализируйте его:

import 'dart:io';
import 'package:yaml/yaml.dart';

void main() {
  final file = File('config.yaml');
  final yamlString = file.readAsStringSync();
  final config = loadYaml(yamlString);
  print('API URL: ${config['api']['url']}');
  print('Включена авторизация: ${config['features']['enableLogin']}');
}

Реальные случаи использования

Управление конфигурациями приложения (URL-адреса API, ключи, флаги функций)
Определение настроек темы или макета вне приложения
Поддержка конфигураций для нескольких сред (dev, staging, prod)
Загрузка структурированного содержимого или метаданных в приложениях

Почему использовать пакет `yaml`?

Читаемые конфигурации по сравнению с JSON
Легко интегрируется с Flutter и Dart
Идеально подходит для приложений с динамическими или средо-зависимыми настройками
Официальный пакет Dart с широким внедрением в сообществе

Заключительные мысли

Пакет yaml — это простой, но мощный инструмент для управления структурированными данными в приложениях Flutter. Вместо того, чтобы жестко кодировать конфигурации, вы можете хранить их в файлах YAML и загружать динамически — что делает ваше приложение более гибким и поддерживаемым.

Если вы хотите чистые конфигурации и легкое управление средой, попробуйте YAML в своих проектах Flutter.