flutter_to_debian 1.0.4 flutter_to_debian: ^1.0.4 copied to clipboard
A command application to help you easily bundle your flutter app build into a debian package ready for production.
A simple command-line application to help you easily bundle your flutter app build into a debian package ready for production.
Overview of our debian packaging 📦 #
This plugin is a tool that builds debian package based on the instructions listed in a debian.yaml file. To get a basic understanding and its core concepts, take a look at the debian documentation. Additional links and information are listed at the bottom of this page.
Flutter debian.yaml example #
Place the YMAL file in your Flutter project under <project root>/debian/debian.yaml. (And remember the YMAL files are sensitive to white space!) For example:
flutter_app: command: mega_cool_app arch: x64 parent: /usr/local/lib control: Package: Mega Cool App Version: 1.0.0 Architecture: amd64 Essential: no Priority: optional Depends: Maintainer: Description: Mega Cool App that does everything!
The following sections explain the various pieces of the YAML file.
Flutter app #
This section of the debain.yaml file defines the application that will be packaged into a debian.
flutter_app: command: mega_cool_app arch: x64 parent: /usr/local/lib
Points to the binary at your project's linux release bundle, and runs when debian package is invoked.
the build architecture of your app.
the app will be installed in a subdirectory (like mega_cool_app) in this directory.
the target directory is: /usr/local/lib/mega_cool_app
Additional files: #
If a directory debian/skeleton exists that files will be copied into the package.
This can be used for default configuration files.
Example: The file debian/skeleton/etc/megacool/main.conf will be installed as /etc/megacool/main.conf
This is what describes to the apt package manager or what ever piece of software you are using to install your app what it's all about.
List the libraries your project depends on and they will be installed by the apt package manager before your app in installed on the system.
the pub.dev package flutter_secure_storage linux version depends on
libsecret-1-0 and libjsoncpp1
NB: more than one Depends are separated by " , " .
Desktop file and icon 🖥️ #
Desktop entry files are used to add an application to the desktop menu. These files specify the name and icon of your application, the categories it belongs to, related search keywords and more. These files have the extension .desktop and follow the XDG Desktop Entry Specification.
Flutter mega-cool-app.desktop example #
Place the .desktop file in your Flutter project under <project root>/debian/gui/mega-cool-app.desktop.
Notice: icon and .desktop file name must be the same as your app name in yaml file!
[Desktop Entry] Version=1.0 Name=Mega Cool App GenericName=Mega Cool App Comment=A Mega Cool App that does everything Terminal=false Type=Application Categories=Utility Keywords=Flutter;share;files;
Place your icon with .png extension in your Flutter project under <project root>/debian/gui/mega-cool-app.png.
Build the debian package 📦 #
Once the gui/ folder and debian.yaml file are complete. Run flutter_to_debian as follows from the root directory of the project.
first build your project
$ flutter build linux
install flutter_to_debian if not done yet.
$ dart pub global activate flutter_to_debian
Run flutter_to_debian as follows.
Locate and install your .deb app's package 📦 #
From the root directory of the project, Find it at.
$ cd debian/packages && ls
$ sudo dpkg -i [package_name].deb
Dependency Finder #
The command flutter_to_debian can be used to find the dependencies of an amount of library files.
flutter_to_debian help to see this description:
Usage: flutter_to_debian [<mode> [<options>] ] <mode>: help Print this usage. create Creates a Debian package file *.deb. This is the default mode. dependencies [<opts>] [<file1> [ <file2>...]] Detects the dependencies of a amount of library files. <fileX> can be a file or a directory. <opts>: --excluded-packages=<comma-separated-list-of-names> That packages will be excluded from detection --excluded-libraries=<pattern> Excludes that library files from detection. <pattern> is a regular expr. Examples: flutter_to_debian Creates the Debian package described in ./debian/debian.yaml flutter_to_debian dependencies Detects the dependencies of the files in ./build/linux/x64/release/bundle/lib and uses the information of debian/debian.yaml flutter_to_debian dependencies --excl-lib=-dev|^my_lib release/libs Detects the dependencies of the files in release/libs without the excluded specified by "-dev|^my_lib": The file release/libs/our_lib-dev.2.so and release/libs/my_lib-dev.2.so will be excluded from detection. flutter_to_debian dependencies --excluded-packages=lintian,my-project prod/libs Detects the dependencies of the files in prod/libs The packages lintian and my-project will be excluded from processing. Note: modes and options can be abbreviated: --ex-pack means --excluded-packages
Contributions 🤝 #
Please all PR's and found issues are highly welcome at flutter_to_debian
Additional resources #
You can learn more from the following links:
Support 🤗 #
Please download, install, use and share our cross platform Local File sharing app WhoShares with your friends 💙 💙 💙.