snapp_installer

KO | EN

gitlite — search

#react #machine-learning #linux #docker #macos #java #awesome #cli #vue #awesome-list #pytorch #security #ios #open-source

snapp_installer

(★ 60)

command-line tool that simplifies the installation and development of Flutter applications on your Raspberry Pi. This Bash script automates the process of setting up the Flutter environment, installs essential files and dependencies, and offers additional features like running your Flutter apps in kiosk mode.

snapp_installer 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# snapp_installer: Raspberry Pi Flutter Development Toolkit

**snapp_installer** is a command-line tool that simplifies the installation and development of Flutter applications on your Raspberry Pi. This Bash script automates the process of setting up the Flutter environment, installs essential files and dependencies, and offers additional features like running your Flutter apps in **kiosk** mode.

With **snapp_installer**, you can effortlessly configure your Raspberry Pi for Flutter app development and create immersive user experiences by running your apps in kiosk mode.

## Prerequisites

Before running the installer script, ensure you have the following prerequisites:

- **Raspberry Pi 4 with Raspberry pi OS 64-bit** (Raspbian)
- **Bash shell** (version 4.0 or higher) - by default is available
- **Curl** - by default is available

## Kiosk Mode Result

https://github.com/Snapp-Embedded/snapp_installer/assets/47558577/0f2e99bc-b2eb-45f7-b4a9-3bcc17770a02

## Getting Started

To quickly install `snapp_installer` on your Raspberry Pi, open a terminal and simply run the following command:

```bash
bash <(curl -fSL https://raw.githubusercontent.com/Snapp-X/snapp_installer/main/installer.sh) && source ~/.bashrc
```

## Usage

Once `snapp_installer` is installed on your Raspberry Pi, you can use it by simply running the desired command in your terminal. Here are the available commands:

- **doctor**: Check the installation status and dependencies.
- **install**: Install Flutter and set up the environment.
- **uninstall**: Uninstall Flutter (Note: Uninstallation is not implemented yet).
- **kiosk**: Run a Flutter app bundle in kiosk mode.
- **disable_kiosk**: Disable the kiosk mode.
- **autologin**: Enable auto login on your device.
- **disable_autologin**: Disable auto login on your device.
- **enable_fullscreen**: Enable Full Screen in your Flutter project.

For example, to check the installation status, kiosk mode state, and dependencies, simply run:

```bash
snapp_installer doctor
```

## Install Flutter Environment

The "install" command in `snapp_installer` automates the installation of Flutter on your Raspberry Pi and prepares the environment for Flutter app development. Here's what it does:

- **Installs Linux Dependencies**: It ensures that essential Linux packages, such as `curl`, `git`, and more, are installed on your Raspberry Pi.

- **Clones Flutter from GitHub**: fetches the Flutter repository from GitHub and places it in your specified directory.

- **Sets Up PATH**: It configures your system's PATH environment variable to include the Flutter binary directory, making the `flutter` command globally executable.

- **Installs Development Dependencies**: it installs necessary Linux development dependencies required for Flutter app development, including compilers and libraries.

- **Chooses Flutter Channel**: You can specify your preferred Flutter channel (e.g., stable, beta) to ensure you're using the desired Flutter release.

- **Runs Flutter Doctor**: This command checks your Flutter installation and displays any missing components or configuration issues.

- **Precaches Assets**: It precaches Linux-specific assets, ensuring a smooth development experience.

To use the "install" command, simply follow the Getting Started section in this README and run:

```bash
snapp_installer install
```

**Note**: After running the "install" command, you need to restart your terminal or run `source ~/.bashrc` to apply the changes to your PATH environment variable.

## Kiosk Mode

`snapp_installer` allows you to run your Flutter app in a kiosk mode on your Raspberry Pi, ensuring a seamless and focused user experience. To enable kiosk mode, follow these steps:

#### By Flutter Project
If you have a Flutter project on your machine, you can simply enable kiosk mode by running the following command in your project directory:

```bash
snapp_installer kiosk
```

It will take care of the rest and run your Flutter app in kiosk mode.

#### By Flutter App Bundle
1. **Build Your Flutter App**: Ensure you have built your Flutter app for the Linux platform in release mode. You can use the following command to generate the app bundle:

```bash
 flutter build linux --release
```
1. **Enable Kiosk Mode**:To run your Flutter app in kiosk mode, use the following command, replacing `<file_path>`  with the path to the Flutter app bundle you built in step 1:

```bash
snapp_installer kiosk <file_path>
```

For example:

```bash
snapp_installer kiosk /home/pi/app/build/linux/arm64/release/bundle/app
```
Ensure that the specified file path exists, points to an executable file, and is the path to your Flutter app bundle.

**Auto Login**: 
Kiosk mode typically requires auto login on your Raspberry Pi. If auto login is not already enabled, snapp_installer will enable it for you.

You can also enable the auto login manually, by using the following command:

```bash
snapp_installer autologin
```

**Disable Kiosk Mode (Optional)**:

To disable the kiosk mode and return your Raspberry Pi to a standard desktop environment, follow these steps:

1. **Exit Full-Screen Mode**:
   If your Raspberry Pi is currently in full-screen kiosk mode, you need to exit this mode before disabling kiosk mode. You can typically exit full-screen mode by pressing `Alt+F4`(Close the app) or `F11`(Exit Fullscreen mode).

2. **Disable Kiosk Mode**:
   Open a terminal on your Raspberry Pi and execute the following command to disable kiosk mode:

```bash
snapp_installer disable_kiosk
```

This command will remove the kiosk-related settings and restore your desktop environment.

Please note that enabling kiosk mode may affect the default behavior of your Raspberry Pi desktop environment. Ensure you have a backup or can access your Raspberry Pi via SSH in case you need to make any adjustments.

## Contributing

If you encounter any issues with the installer script or have suggestions for improvements, please [open an issue](https://github.com/Snapp-X/snapp_installer/issues). You are welcome to contribute to the development of this project by forking the repository and submitting pull requests.

## License

This project is licensed under the MIT License

snapp_installer

snapp_installer 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

snapp_installer

snapp_installer 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README