flutter-setting-up-on-linux

Original：🇺🇸 English
Translated

Sets up a Linux environment for Flutter development. Use when configuring a Linux machine to run, build, or deploy Flutter applications.

5installs
Sourceflutter/skills
Added on

NPX Install

npx skill4agent add flutter/skills flutter-setting-up-on-linux

Tags

Translated version includes tags in frontmatter
flutter-developmentlinux-environment-setupsnapcraft-packaginglxd-configurationflutter-doctor

SKILL.md Content

View Translation Comparison →

Setting Up a Linux Environment for Flutter Development

Contents

System Dependencies

To build and run Flutter applications on a Linux desktop, install the required C/C++ toolchain and system libraries. Flutter relies on 
dart:ffi
to interface with Linux system calls and the GTK framework for UI rendering.
Required packages for Debian/Ubuntu-based distributions:
  • Core Utilities: 
    curl
    , 
    git
    , 
    unzip
    , 
    xz-utils
    , 
    zip
  • Build Tools: 
    clang
    , 
    cmake
    , 
    ninja-build
    , 
    pkg-config
  • Libraries: 
    libglu1-mesa
    , 
    libgtk-3-dev
    , 
    libstdc++-12-dev

Workflow: Configuring the Linux Toolchain

Follow this sequential workflow to prepare the Linux host for Flutter desktop development.
Task Progress:
  • 1. Update package lists and upgrade existing packages.
  • 2. Install core utilities and build dependencies.
  • 3. Configure IDE/Editor with Flutter support.
  • 4. (Conditional) Enable Linux support on ChromeOS.
1. Update and Install Dependencies Execute the following command to install all required packages on Debian/Ubuntu systems:
bash
sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev
2. Conditional: ChromeOS Setup
  • If developing on a Chromebook: Turn on Linux support in the ChromeOS settings. Ensure the Linux container is fully updated using the 
    apt-get
    commands above before proceeding.
3. IDE Configuration Install Visual Studio Code, Android Studio, or an IntelliJ-based IDE. Install the official Dart and Flutter extensions/plugins to enable language server features and debugging capabilities.

Workflow: Validating the Environment

Run this feedback loop to ensure the toolchain is correctly recognized by the Flutter SDK.
Task Progress:
  • 1. Run environment validator.
  • 2. Verify connected Linux devices.
  • 3. Resolve toolchain errors.
1. Run Validator Execute the Flutter diagnostic tool with verbose output:
bash
flutter doctor -v
2. Review and Fix (Feedback Loop)
  • If errors exist under the "Linux toolchain" section: Review the missing dependencies, install the flagged packages, and re-run 
    flutter doctor -v
    . Repeat until the Linux toolchain section passes.
3. Verify Device Availability Ensure the Linux desktop is recognized as a valid deployment target:
bash
flutter devices
Expected Output: At least one entry must display with the platform marked as linux.

Workflow: Preparing for Distribution (Snapcraft)

When preparing a release build for the Snap Store, configure the Snapcraft build environment.
Task Progress:
  • 1. Install Snapcraft and LXD.
  • 2. Configure LXD.
  • 3. Build the Snap package.
1. Install Build Tools
bash
sudo snap install snapcraft --classic
sudo snap install lxd
2. Configure LXD Initialize LXD and add the current user to the 
lxd
group:
bash
sudo lxd init
sudo usermod -a -G lxd <your_username>
Note: Log out and log back in to apply the group changes.
3. Build the Snap Navigate to the project root containing the 
snap/snapcraft.yaml
file and execute the build:
bash
snapcraft --use-lxd

Examples

Baseline 
snapcraft.yaml
Configuration

Use this template for the 
<project_root>/snap/snapcraft.yaml
file when packaging a Flutter Linux app for the Snap Store.
yaml
name: super-cool-app
version: 0.1.0
summary: Super Cool App
description: Super Cool App that does everything!

confinement: strict
base: core22
grade: stable

slots:
  dbus-super-cool-app:
    interface: dbus
    bus: session
    name: org.bar.super_cool_app

apps:
  super-cool-app:
    command: super_cool_app
    extensions: [gnome]
    plugs:
    - network
    slots:
      - dbus-super-cool-app

parts:
  super-cool-app:
    source: .
    plugin: flutter
    flutter-target: lib/main.dart