Vaani/docs/linux_build_guide.md

Linux Build Guide

Determining Package Size

To determine the installed size for your Linux package configuration, you can use the following script:

#!/bin/bash

# Build the Linux app
flutter build linux

# Get size in KB and add 17% buffer for runtime dependencies
SIZE_KB=$(du -sk build/linux/x64/release/bundle | cut -f1)
BUFFER_SIZE_KB=$(($SIZE_KB + ($SIZE_KB * 17 / 100)))

echo "Actual bundle size: $SIZE_KB KB"
echo "Recommended installed_size (with 17% buffer): $BUFFER_SIZE_KB KB"

Save this as get_package_size.sh in your project root and make it executable:

chmod +x get_package_size.sh

Usage

1. Run the script:

   ./get_package_size.sh
   

2. Use the output value for installed_size in your linux/packaging/deb/make_config.yaml file:

   installed_size: 75700  # Replace with the value from the script
   

Why add a buffer?

The 17% buffer is added to account for:

• Runtime dependencies
• Future updates
• Potential additional assets
• Prevent installation issues on systems with limited space

Notes

• The installed size should be specified in kilobytes (KB)
• Always round up the buffer size to be safe
• Re-run this script after significant changes to your app (new assets, dependencies, etc.)