IMACS Setup

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 https://docs.flutter.dev/get-started/install/windows 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. https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022

  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: https://github.com/UWARG/IMACS-2

  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: https://codelabs.developers.google.com/codelabs/flutter-codelab-first#0