Setting Up a Linux Environment for Flutter Development

Contents

• System Dependencies
• Workflow: Configuring the Linux Toolchain
• Workflow: Validating the Environment
• Workflow: Preparing for Distribution (Snapcraft)
• Examples

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:

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:

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:

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

sudo snap install snapcraft --classic
sudo snap install lxd

2. Configure LXD
Initialize LXD and add the current user to the lxd group:

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:

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.

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