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
/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