Flutter-Calculator

This is a simple calculator mobile application built on Flutter and Spring 📱
This guide was created by Hayden Hanson, Joshua Hilbert, Nicholas Thor Page and Willie Warren

Getting Started...

If you get lost, check out Flutters official documentation at https://docs.flutter.dev/get-started/install and clicking on your OS

Installation Guide for Windows

Step 1: Download Flutter SDK

Here is the link: https://docs.flutter.dev/get-started/install/windows
Keep track of where you download this SDK, you will need to keep hold of the file path

Step 2: Update your PATH

This allows you to run Flutter commands from Command Prompt

1. To do this, go to the Start search bar and type in 'environment' and you should see Edit the system environment variables
   
2. Click on 'Environment Variables...
   
3. Double click on 'Path'
   
4. Click 'Edit...'
   
5. Click 'New'
   
6. Now, go to your command line and type the command 'where flutter', you should see a file path similar to:
   C:\Users\Hayden Hanson\Developer Tools\flutter\bin
   
7. Paste this file path into your 'New' entry, then click OK.
   

Flutter is now added to your machines Path!

Step 3: Run 'flutter doctor' from the command prompt

Now that Flutter is added to your Path, you can run flutter commands from your command prompt

1. Open command prompt and type 'flutter doctor', if everything up until now was done correctly you should see Flutter working
   This tool will tell you what you still need to install to be fully operational
2. Follow the instructions that flutter doctor provides.
   

Step 4: Install Andriod Studio

Visit https://docs.flutter.dev/get-started/install/windows and scroll down to 'Andriod Setup' to complete this step

Step 5: Set up your Andriod emulator

Visit https://docs.flutter.dev/get-started/install/windows and scroll down to 'Set up the Android emulator' to complete this step

Step 6: Agree to Andriod Licesnses

1. Run 'flutter doctor --android-licesnses on the command line
   
2. Review each term, pressing 'y' for each one until you are finished
   

Step 7 (Yes, you're almost done...): Download Visual Studio 2022

Here is the link: https://visualstudio.microsoft.com/downloads/

1. Click on 'Community Edition' and the download should begin
   
2. Once the download is complete, open the installer and be sure to click the option 'Desktop development with C++'
   

Step 8: Set up an editor

I personally reccomend VS Code...
But here is the link to get you set up in your favorite IDE: https://docs.flutter.dev/get-started/editor?tab=vscode

Now you can begin writing Flutter programs!

Windows users can skip to Setting up the Calculator

Installation Guide for Mac

Step 1: Download Flutter SDK

You can download the SDK either directly or from git
Here is the link: https://docs.flutter.dev/get-started/install/macos
Keep track of where you download this SDK, you will need to keep hold of the file path
Don't forget to add Flutter to your Macs' PATH, instructions are included in the link above

Step 2: Run 'flutter doctor' from the terminal

Now that Flutter is added to your Path, you can run flutter commands from your terminal

1. Open terminal and type 'flutter doctor', if everything up until now was done correctly you should see Flutter working
   This tool will tell you what you still need to install to be fully operational
2. Follow the instructions that flutter doctor provides.
   

Step 3: iOS setup

1. Install Xcode from the mac app store
   
2. Configure the Xcode command-line tools by running the following commands:
   
   1. sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
      
   2. sudo xcodebuild -runFirstLaunch
      
3. Accept the Xcode license agreements
   

Step 4: Set up your iOS simulator

1. Open terminal and run 'open -a Simulator'
   
2. Choose the iPhone you want to preview your Flutter apps on.
   

Step 5: Create and run a simple Flutter app

We are doing this to initialize some settings with Xcode and the Flutter developement evironment

I could explain how to do this, but the offical website does a very nice job
Here is the link: https://docs.flutter.dev/get-started/install/macos Scroll down to "Create and run a simple Flutter app

Step 6: Set up an editor

I personally reccomend VS Code...
But here is the link to get you set up in your favorite IDE: https://docs.flutter.dev/get-started/editor?tab=vscode

Now you can begin writing Flutter programs!

Move on to Setting up the Calculator to use our calculator demo

Setting up the Calculator

Step 1: Clone our repo onto your computer
Step 2: Download and install Java 11
Step 3: Set your JAVA_HOME environment variable to Java 11
Step 4: Navigate to Flutter-Calculator/CalculatorAppBackend/CalculatorApp and run mvnw spring-boot:run
Step 5: Open the file with your IDE
Step 6: Open an emulator, iOS or android
Step 7: Navigate to the file flutter_calculator in your terminal or command prompt and run flutter run --dart-define="EVAL_REMOTE=false"

All finished! 😄