Устройство pubspec.yaml
Объявляйте метаданные, зависимости и ограничения
«Устройство pubspec.yaml» — бесплатный урок Dart Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Dart Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Dart Academy содержит 4 уроков всего.
Знакомство с pubspec.yaml
В корне каждого проекта Dart находится файл pubspec.yaml. Это манифест, в котором описан проект и перечислены все его зависимости. 📄
Зачем нужен YAML
Dart использует здесь YAML, потому что этот формат легко читать: отступы показывают структуру, а ключи записываются перед двоеточием и значением. Фигурные скобки не нужны.
name: my_app
version: 1.0.0Поле name
Поле name обязательно. Оно должно содержать строчные буквы и символы подчёркивания, а затем становится идентификатором, который другой код использует для импорта Вашего пакета.
name: weather_clientОписание и версия
Добавьте краткое description, чтобы пользователи понимали назначение пакета, а также version в формате major.minor.patch, например 1.2.0.
description: A tiny weather client.
version: 1.2.0Ключ environment
Ключ environment указывает, какие версии Dart SDK поддерживает проект. Инструменты откажутся запускаться, если версия SDK находится вне этого диапазона.
environment:
sdk: ^3.0.0Зависимости среды выполнения
Раздел dependencies перечисляет пакеты, необходимые Вашему коду во время выполнения. Каждая запись сопоставляет имя пакета с ограничением версии.
dependencies:
http: ^1.2.0dev_dependencies
Используйте dev_dependencies для инструментов, нужных только во время разработки, например пакетов для тестов или проверки стиля. Они не поставляются пользователям Вашего пакета.
dev_dependencies:
test: ^1.24.0Ограничения версий с кареткой
Символ caret, например ^1.2.0, означает любую версию от 1.2.0 включительно до 2.0.0 не включительно. Это позволяет принимать безопасные совместимые обновления.
http: ^1.2.0Отступы важны
YAML использует пробелы, а не табуляцию, для обозначения вложенности. Неправильное выравнивание ключа нарушит файл, поэтому повсюду сохраняйте одинаковые отступы в два пробела.
dependencies:
http: ^1.2.0Другие полезные поля
Также можно добавить поля homepage, repository и publish_to. Они предоставляют пользователям ссылки и позволяют при необходимости оставить пакет закрытым.
homepage: https://example.com
publish_to: noneОткуда pub читает данные
При запуске команд pub инструмент сначала читает pubspec.yaml, чтобы узнать о зависимостях, а затем загружает и разрешает их за Вас. 🔧
Быстрая проверка
Куда помещать пакеты, нужные только во время разработки?
Итоги
Вы узнали, что pubspec.yaml задаёт имя проекта и диапазон SDK, а также перечисляет зависимости среды выполнения и разработки. Это основа каждого проекта Dart. 🎉
Часто задаваемые вопросы
Урок «Устройство pubspec.yaml» бесплатный?
Да — полный текст урока «Устройство pubspec.yaml» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Dart Academy, подпишись на CoddyKit PRO. Курс Dart Academy содержит 4 уроков всего.
Чему я научусь в уроке «Устройство pubspec.yaml»?
Объявляйте метаданные, зависимости и ограничения Ты практикуешь Dart Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Dart Academy?
Предыдущий опыт не требуется. Dart Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Устройство pubspec.yaml»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Dart Academy?
Да. Каждый урок Dart Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Устройство pubspec.yaml
- Добавление зависимостей с помощью dart pub
- Импорты, экспорты и библиотеки
- Ограничения версий и lock-файл