Skip to content

A GUI app that will help autoware users to build their packages in a simpler way

License

Notifications You must be signed in to change notification settings

autowarefoundation/autoware-build-gui

Repository files navigation

Autoware Build GUI

Autoware Build GUI is a Tauri / NextJS application designed to simplify the process of building Autoware packages. Instead of relying on command prompts, users can now utilize a user-friendly graphical interface.

Table of Contents

Dependencies

To run the .deb file directly you will need to first check if these dependencies are installed.

sudo apt install libwebkit2gtk-4.1-0 libjavascriptcoregtk-4.1-0 libsoup-3.0-0 libsoup-3.0-common

To develop the Autoware Build GUI, you'll need to have both Rust and Node.js installed on your system.

Installing Rust

  1. To install Rust, run the following command:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs/ | sh
  2. Follow the on-screen instructions to complete the installation.

  3. Once installed, you can verify your Rust installation with:

    rustc --version

Installing Node.js

  1. You can download and install Node.js from the official website.

  2. Alternatively, if you're using a package manager like apt for Ubuntu/Debian or brew for macOS, you can install Node.js with:

    • For Ubuntu/Debian:

      sudo apt update
      sudo apt install nodejs
  3. Verify your Node.js installation with:

    node --version
  4. It's also recommended to install pnpm as it's not included:

    npm install -g pnpm

Once Rust and Node.js are set up, you can proceed with the Installation steps mentioned above.

Installation

Using the .deb File

For most users, the easiest way to get started is by downloading and installing the provided .deb file.

For Developers

If you're interested in developing additional features or want to run the project from source:

  1. Clone the repository:

    git clone https://github.com/leo-drive/autoware-build-gui.git
  2. Navigate to the project directory:

    cd autoware-build-gui
  3. Install the required packages:

    pnpm i
  4. Run the development version of the app:

    pnpm tauri dev

Usage

For a comprehensive guide on how to use the Autoware Build GUI, please refer to our demo video. In essence, the process involves:

Demo Video

Autoware Build GUI Demo

  1. Launching the app.
  2. Setting the path to the Autoware folder.
  3. Selecting the packages you wish to build.

If you haven't cloned the packages yet (i.e., no src folder exists), the app will handle this for you, following the same procedure outlined in the Autoware source installation instructions documentation.

Features

  • Initialization: Automatically creates an src folder and clones necessary packages if they aren't present.
  • Adding Calibration Packages: Ability to add calibration packages to the project.
  • Pre-configured Setups: Offers minimal setups for AWSIM, Planning Simulator, and Logging Simulator and Calibration tools.
  • Config Management: Ability to save and load configurations for specific selected packages.
  • Log Management: Save build logs for future reference.
  • Build Process: Seamlessly build selected packages with a click.

Contributing

We welcome contributions from the community! If you're interested in enhancing the Autoware Build GUI, please follow the installation instructions for developers and feel free to submit pull requests.

Author

Khalil Selyan - Creator and maintainer of Autoware Build GUI.

License

This project is licensed under the MIT License. See the LICENSE file for details.