vaxpdeb

A new Flutter project.

Getting Started

VAXP DEB Converter

A beautiful Flutter application that converts Flutter projects into .deb packages for Linux distributions.

Features

• Beautiful Modern UI: Clean, gradient-based interface with smooth animations
• Easy Project Selection: Click to browse and select Flutter project folders
• Custom Icon Support: Upload your own PNG, JPG, or SVG icons for your application
• Desktop Entry Form: Configure desktop entry details with a user-friendly form
• Auto-Fill Functionality: Automatically populate form fields based on project selection
• One-Click Conversion: Simple "Convert to DEB" button for easy packaging
• Real-time Progress: Status updates during the conversion process
• Automatic Package Structure: Creates proper DEB package structure with control files
• Desktop Integration: Generates .desktop files for application menu integration
• Default Icon Generation: Creates a default icon if none is provided

How to Use

1. Launch the Application: Run the Flutter app using flutter run -d linux
2. Select Project: Click "Select Project Folder" to browse and choose your Flutter project
3. Select Icon (Optional): Click "Select Icon File" to choose a custom icon (PNG, JPG, or SVG)
4. Configure Desktop Entry: Fill in the desktop entry form or use "Auto Fill" to populate fields automatically
5. Convert: Click the "Convert to DEB" button to start the conversion process
6. Wait: The app will build your Flutter project and create the DEB package
7. Install: Find your .deb file in the project directory and install it with sudo dpkg -i your-app.deb

Requirements

• Flutter SDK installed
• Linux system with dpkg-deb utility
• Flutter project with Linux support enabled

What It Does

The converter performs the following steps:

1. Builds Flutter App: Runs flutter build linux --release on your project
2. Creates DEB Structure: Sets up proper DEB package directories (DEBIAN/, usr/bin/, etc.)
3. Copies Runtime Dependencies: Automatically includes Flutter engine libraries and dependencies
4. Handles Icons: Copies your custom icon or generates a default one
5. Generates Control File: Creates package metadata with proper system dependencies
6. Creates Desktop Entry: Generates .desktop file for application menu integration
7. Creates Executable Script: Generates proper launcher script with library path setup
8. Packages Everything: Uses dpkg-deb to create the final .deb file

Technical Details

• Built with Flutter 3.7.2+
• Uses Material Design 3 components
• Implements file picking with file_picker package
• Creates proper Linux package structure
• Generates executable scripts for app launching
• Automatically includes Flutter runtime dependencies
• Handles multiple Flutter installation locations
• Creates proper library path setup for executables

Dependency Handling

The converter automatically detects and includes Flutter runtime dependencies by:

1. Searching Multiple Locations: Checks common Flutter installation paths
2. Copying Essential Libraries: Includes libflutter_linux_gtk.so and related libraries
3. Runtime Library Setup: Configures LD_LIBRARY_PATH in the launcher script
4. Fallback Warning: Creates a warning file if dependencies aren't found
5. System Dependencies: Lists required system packages in the control file

If dependencies aren't found automatically, the converter will create a DEPENDENCY_WARNING.txt file with instructions for manual dependency installation.

Installation

1. Clone or download this project
2. Run flutter pub get to install dependencies
3. Run flutter run -d linux to launch the application

License

This project is provided as-is for educational and development purposes.

VAXP-DEB