ENMUmobile

In our CS 458, Android Development course, we embraced the challenge of addressing a pressing issue faced by students at Eastern New Mexico University. Despite a vibrant student body of over 4,000, the university lacked a dedicated campus-specific application to cater to student needs. Drawing from our own experiences as students, we had a clear vision of the ideal functionalities and features of such an application. To bring this vision to life, we utilized Flutter, a cutting-edge UI software development kit, ensuring seamless cross-compatibility across both Android and IOS platforms. This project not only enhanced our technical skills but also will contribute significantly to the student community at ENMU.

Getting Started

This guide walks you through the process of downloading and setting up the project in Android Studio, assuming Flutter and Dart are already installed.

Steps

This guide walks you through the process of downloading and setting up the project in Android Studio, assuming Flutter and Dart are already installed.

Download to Android Studio

1. Clone the Repository

Open Android Studio and follow these steps:

• Navigate to File > New > Project from Version Control.
• In the URL field, enter https://github.com/nwc6624/ENMU_CS_458_Semester_Project.git.
• Select the directory to clone into and click Clone.

2. Open the Cloned Project

If the project isn't automatically opened:

• Go to File > Open.
• Select the cloned project directory.

3. Install Flutter and Dart Plugins

If not already installed:

• Go to File > Settings > Plugins.
• Search and install Flutter. This should also install Dart.
• Restart Android Studio.

4. Get Dependencies

Within Android Studio's terminal:

• Run flutter pub get in the project's root directory.

5. Run the Project

• Select a device or emulator.
• Click the 'Run' icon.

Prerequisites

Project Prerequisites

Before setting up the project, ensure you have the following software installed:

Required Software

• Flutter: Used for mobile app development.
• Dart SDK: Programming language used by Flutter.
• Android Studio: IDE for Android development.

Installation Guide

Installing Flutter

• Download Flutter SDK from Flutter's official website.
• Extract the SDK to a preferred location on your system.
• Add Flutter to your system's PATH.
• Run flutter doctor in a terminal to check for any additional dependencies.

Installing Android Studio

• Download Android Studio from Android's official website.
• Run the installer and follow the setup wizard.
• Open Android Studio, go to File > Settings > Plugins.
• Search for the Flutter plugin and install it (this should automatically install Dart).

Flutter Dependencies

Add the following (Android) dependencies to your pubspec.yaml file:

dependencies:
  flutter:
    sdk: flutter
  connectivity: ^3.0.6   
  latlong2: ^0.9.0      # Upgraded to ^0.9.0 to resolve the version conflict
  url_launcher: ^6.2.1
  cupertino_icons: ^1.0.2
  image_gallery_saver: ^2.0.3
  connectivity_plus: ^5.0.1
  syncfusion_flutter_pdfviewer: ^23.1.43
  webview_flutter: ^3.0.3
  flutter_map: ^6.0.1
  http: ^1.0.0
  html: ^0.15.0
  flutter_native_splash: ^2.3.5

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true
  assets:
    - assets/images/
    - assets/pdfs/

Installing

After adding (Or verifying) the dependencies, save the pubspec.yaml file.

Android Studio will prompt you to get packages. You can click on Get dependencies in the bar that appears at the top of the editor.

Alternatively, you can open the terminal within Android Studio (usually located at the bottom of the IDE) and run the command:

flutter pub get

Verify Installation:

Once the dependencies are fetched, you should see a message in the terminal indicating that the process is complete.

Your project is now ready to use these dependencies.

Sync Your Project:

If needed, click on Sync Now in the bar that appears at the top of the IDE to ensure everything is up to date.

Deployment

Running the App on an Android Device

1. Enable Developer Options and USB Debugging:
   • On your Android device, go to Settings > About phone, tap Build number 7 times.
   • Go to Settings > System > Advanced > Developer options, enable USB debugging.
2. Connect Device to Computer:

   Use a USB cable to connect your device to the computer.

3. Run the App from Android Studio:
   • Open your project in Android Studio.
   • Select your device from the dropdown in the toolbar.
   • Click the ‘Run’ button.

Note: This project is TBA for Google Play Store deployment.

Built With

• Flutter - UI SDK used
• Dart - Language used
• Open Street Maps - Used to display real time-map of the city of Portales

Authors

• Noah Caulfield - Senior in Computer Science - Github
• Jake Gill - Senior in Industrial Mathematics - Github

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

We hope that this code will serve as basis for further development for an ENMU resources application.