Установка Dart на Debian 13, 12, 11: подробное руководство

Dart — это язык программирования от Google, оптимизированный для создания пользовательских интерфейсов. Он используется во Flutter для мобильной и десктопной разработки, а также для серверных приложений и веб-фронтенда. Debian не включает Dart в свои репозитории, поэтому нужно добавить официальный репозиторий Google. Главные сложности для новичка: правильно добавить GPG-ключ и репозиторий (в формате DEB822), а также выбрать нужный канал — stable (рекомендован), beta или dev. Также важно проверить, поддерживается ли архитектура вашего процессора.

💡 В этом руководстве вы установите Dart SDK на Debian из официального репозитория Google. Вы также узнаете, как создать и скомпилировать тестовое приложение, а также решить типичные проблемы.

В этой статье вы узнаете:

  • Как добавить GPG-ключ и репозиторий Google для Dart
  • Как установить Dart SDK через APT
  • Как создать и запустить тестовое Dart-приложение
  • Как скомпилировать приложение в нативный исполняемый файл
  • Как решить типичные проблемы: ошибки GPG, проблемы с архитектурой, command not found

Для кого: разработчики мобильных приложений (Flutter), веб-разработчики, а также все, кто хочет изучать Dart на Debian 11, 12 или 13.

1. 🔧 Предварительные требования

Перед установкой убедитесь, что:

  • У вас установлена Debian 11, 12 или 13
  • Подключение к интернету стабильно
  • У вас есть права sudo

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

Что делает: sudo выполняет команду от имени суперпользователя, whoami показывает имя текущего пользователя.

Зачем: Эта команда проверяет, есть ли у вас права sudo. Без них вы не сможете устанавливать пакеты.

✅ Если выводит root — всё в порядке, можете продолжать.

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

1.1 Обновление системы

Перед установкой всегда обновляйте список пакетов.

sudo apt update && sudo apt upgrade -y

Что делает: Обновляет список пакетов и устанавливает последние обновления.

1.2 Установка вспомогательных пакетов

sudo apt install wget ca-certificates gnupg -y

Что делает: Устанавливает инструменты для безопасного скачивания и работы с GPG-ключами.

2. 📊 Выбор канала Dart

Google предоставляет три канала обновлений:

КаналЧастота обновленийСтабильностьДля кого
StableКаждые 3 месяцаProduction-readyБольшинство
пользователей
BetaЕжемесячноPreviewТестирование новых фич
DevДважды в неделюЭкспериментальнаяРазработчики,
которым нужны
последние правки

💡 Рекомендация: Используйте Stable для разработки.

3. 📦 Установка Dart из официального репозитория Google

3.1 Импорт GPG-ключа Google

wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg

3.2 Добавление репозитория (Stable, рекомендовано)

sudo tee /etc/apt/sources.list.d/dart.sources > /dev/null <<EOF
Types: deb
URIs: https://storage.googleapis.com/download.dartlang.org/linux/debian
Suites: stable
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /usr/share/keyrings/dart.gpg
EOF

Для Beta (опционально): замените Suites: stable на Suites: testing.

Для Dev (опционально): замените Suites: stable на Suites: unstable.

3.3 Обновление списка пакетов

sudo apt update

3.4 Установка Dart SDK

sudo apt install dart -y

Что делает: Устанавливает Dart SDK, включая dart (VM), pub (менеджер пакетов), dart2js (компилятор в JS) и dart analyze.

3.5 Проверка версии

dart --version

Ожидаемый вывод в терминале:

Dart SDK version: 3.10.7 (stable) (Tue Dec 23 00:01:57 2025 -0800) on "linux_x64"

4. 🧪 Создание и запуск тестового приложения

4.1 Создание проекта

dart create -t console my_dart_app
cd my_dart_app

4.2 Запуск (JIT)

dart run

Ожидаемый вывод: Hello world: 42!

4.3 Компиляция в нативный исполняемый файл (AOT)

dart compile exe bin/my_dart_app.dart

4.4 Запуск скомпилированного файла

time bin/my_dart_app.exe

Ожидаемый вывод: Hello world: 42! (AOT-компиляция даёт очень быстрый запуск).

5. 🔄 Обновление Dart

sudo apt update
sudo apt install --only-upgrade dart -y

6. ⚠️ Решение типичных проблем

6.1 Ошибка: GPG key import fails

Симптом: Ошибка при импорте GPG-ключа.

Решение: Проверьте интернет-соединение и повторите:

wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg

6.2 Ошибка: Signature verification failed

Симптом: sudo apt update выдаёт ошибку подписи.

Решение: Проверьте, что файл ключа существует:

ls -la /usr/share/keyrings/dart.gpg

Если отсутствует — повторите импорт ключа.

6.3 Ошибка: dart: command not found

Симптом: dart --version не работает.

Решение: Проверьте, установлен ли пакет:

dpkg -l dart

Если пакет установлен, но команда не найдена — переустановите:

sudo apt reinstall dart

6.4 Ошибка: архитектура не поддерживается

Симптом: Репозиторий не добавляется, так как архитектура не в списке поддержки.

Поддерживаемые архитектуры: amd64, arm64, armhf, riscv64.

Решение: Если ваша архитектура не поддерживается, скачайте Dart вручную с официального сайта.

7. ❌ Удаление Dart

sudo apt remove --purge dart -y
sudo apt autoremove -y
sudo rm -f /etc/apt/sources.list.d/dart.sources
sudo rm -f /usr/share/keyrings/dart.gpg
sudo apt update

Удаление кэша пакетов и проектов (опционально):

rm -rf ~/.pub-cache
rm -rf ~/my_dart_app

8. 📝 Чек-лист: всё готово к работе

  • [ ] Система обновлена (sudo apt update && sudo apt upgrade -y)
  • [ ] GPG-ключ и репозиторий Google добавлены
  • [ ] sudo apt update не показывает ошибок для репозитория Dart
  • [ ] Пакет dart установлен (dart --version показывает версию)
  • [ ] Тестовое приложение создано и запускается (dart run выводит Hello world: 42!)
  • [ ] Приложение скомпилировано в нативный исполняемый файл

Заключение

Вы установили Dart SDK на Debian. Теперь вы можете разрабатывать на Dart: серверные приложения, веб-фронтенд (через dart2js) или кроссплатформенные мобильные/десктопные приложения с Flutter. Главное, что нужно запомнить: Dart не входит в стандартные репозитории Debian, поэтому репозиторий Google нужно добавлять вручную. Используйте stable-канал для повседневной разработки. Тестовое приложение доказывает, что Dart работает в режиме JIT (быстрая разработка) и AOT (быстрый запуск в production).

Что дальше:

  • Изучите официальную документацию Dart
  • Установите Flutter для мобильной разработки (требует Dart)
  • Настройте редактор: VS Code или PyCharm с плагином Dart
  • Установите Git для управления версиями
  • Изучите управление пакетами через pub (pub get, pub add)