Skip to content

A mobile application for students at ACS UPB.

License

Notifications You must be signed in to change notification settings

AlexContiu/acs-upb-mobile

 
 

Repository files navigation

ACS UPB Mobile

License Linter Tests codecov extra_pedantic on pub.dev

A mobile application for students at ACS UPB. For now, you can try it out by accessing https://acs-upb-mobile.web.app/. Android users can also download the apk from the latest release.

Please note that some features may not work perfectly in the web version, as Flutter web support is currently still in beta. However, please feel free to create an issue if you encounter any problem.

If you would like to contribute and don't know where to start, or you have any questions about this project, feel free to join us on Slack and ask anything on the #questions channel.

Preview

Contributors

Building from source with Android Studio

Prerequisites

  • Install Flutter as per the instructions here.
  • Open Android Studio.
  • Make sure you have the Flutter plugin installed, as well as the Dart plugin dependency. Restart the IDE if necessary.
  • Use the Check out project from Version Control option (or File > New > Project from Version Control) to clone the repository from https://github.com/acs-upb-mobile/acs-upb-mobile.
  • If the plugins are installed, Android Studio should automatically recognise it as being a Flutter project, so you should be able to just click Next on everything and create a new project.
  • When prompted, set up the Flutter SDK (the location is the flutter/ folder you downloaded when you installed it) and Dart SDK (it comes bundled with Flutter at flutter/bin/cache/dart-sdk/).
  • Open the project terminal and switch to the Beta Flutter channel in order to enable web support:
flutter channel beta
flutter upgrade
flutter config --enable-web
  • Install all of the required packages:
flutter pub get
  • You may need to restart the IDE for the changes to take effect.

Building for Android

  • Install and run an emulator in Android Studio (using AVD Manager), or connect a physical Android device (make sure USB debugging is enabled).
  • Select your device from the dropdown list and hit the play button (Shift+F10 or ^R). Note that Android Studio runs the app in debug mode by default.
On Android, ACS UPB Mobile uses a separate (development) environment in debug mode. That means a completely different Firebase project - separate data, including user info. In order to try the release (production) version, you need to run flutter run --release.

Building for iOS (MacOS only)

  • Make sure you have Xcode installed and up to date (it is free on the App Store).
  • Connect a physical iOS device or select Open iOS Simulator from the device drop-down menu to power on Xcode's simulator.
  • Select your device from the dropdown list and hit the play button (Shift+F10 or ^R).

Building for Web

  • You need to have Chrome installed in order to be able to run the web version of the app.
  • Select Chrome from the dropdown list and hit the play button (Shift+F10 or ^R).

Not working?

Possible fixes could be:

  • Run flutter doctor and fix any issues that may come up.
  • Run flutter clean to delete the build directory and then build again.
  • Restart Android Studio using File > Invalidate Caches / Restart.

Test your setup by creating and running a new Flutter project (Android Studio provides a sample). If that works but this project doesn't, feel free to open an issue and describe the problem.

License

This project is under the MIT License, which means that you can do whatever you want with it, as long as you add a copy of the original MIT license and copyright notice to your work.

About

A mobile application for students at ACS UPB.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Dart 97.1%
  • Ruby 1.5%
  • HTML 0.5%
  • JavaScript 0.4%
  • Java 0.3%
  • Kotlin 0.1%
  • Other 0.1%