Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 Windows (or MacOS if that is your OS) 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 inhttps://uwarg-docs.atlassian.net/wiki/spaces/CV/pages/2240643073/Ardupilot+Simulation+with+Mission+Planner#MAVLink-Forwarding to forward MAVLink messages to port 14550.

...

  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:

Code Block
git clone [repository link]git@github.com:UWARG/IMACS-2.git
  1. Navigate to the flutter_app directory

  2. In the repository flutter_app directory directory, run flutter build windows to build the windows runnerStart debugging using the ‘run 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

    windows (or Mac) as the device used.
    1. the correct device as shown by the status bar.image-20240601-094118.pngImage Added

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

    1. It will error out if your mission planner is not setup to send data (due to current implementation)

...

  1. .

...

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