IMACS Setup

Owned by Aaron Wang
Last updated: 2024-06-05 by Balaji Leninrajan
2 min read

Prerequisites

Follow the the guide at WIP - Flutter Setup for flutter setup. Note that the android part is not needed for this project. You only need the desktop setup for IMACS2.

 

Below is a TLDR; of the steps required

(Optional for most tasks) Set up Mission Planner

Note: We currently do not have a way to run Mission Planner on MacOS or Linux.

Open the Mission Planner application and follow the steps inMission Planner Simulated Ardupilot | MAVLink Forwarding to forward MAVLink messages to port 14550.

 

Setting up flutter windows development

  1. Follow the guide at Choose your first type of app to install the flutter software development kit

  2. Make sure you have “Desktop development with C++” workload installed, this can be downloaded from visual studio build tools

    1. Download Visual Studio Tools - Install Free for Windows, Mac, Linux

  3. Run flutter --version to check if installation was successful

  4. Enable windows developer mode, you can access this setting by typing start ms-settings:developers into command prompt

IMACS Setup

  1. Visit the UWARG github and locate the IMACS 2.0 repo: GitHub - UWARG/IMACS-2: New IMACS written in Dart

  2. Clone the IMACS 2.0 repository to local:

git clone git@github.com:UWARG/IMACS-2.git

  1. Navigate to the flutter_app directory

  2. In the flutter_app directory directory, run flutter create --platforms=windows,macos,linux .

    1. You may exclude operating systems you don’t intend to build for

    2. E.g. If you only want to build for Windows, run flutter create --platforms=windows .

  3. To start the app either

    1. Run flutter run in the flutter_app directory

    2. Click the 'run and debug’ button or press the F5 key in VSCode. Make sure you have selected the correct device as shown by the status bar.image-20240601-094118.png

  4. The IMACS GUI should pop up (this step might take a while for the first time.

Next Steps

  1. Join the weekly meetings to get assigned a task

  2. Try building the app using flutter build [target platform]

  3. (Optional) complete this codelab to familiarize yourself with Flutter: Your first Flutter app  |  Google Codelabs