Skip to content
This repository has been archived by the owner on Oct 8, 2021. It is now read-only.

Latest commit

 

History

History
91 lines (61 loc) · 5.19 KB

README.md

File metadata and controls

91 lines (61 loc) · 5.19 KB

Alt

Native App

Check your student loan's length of repayment and amount of savings.

This project is a native Android app that is one of two parts of an experimental study—the other part being course material, and it is designed to supplement the course material. The combination of both parts is dubbed an instructional app. Users select an estimated cost, select the interest rate of their loan, and select a monthly payment. The app will estimate how long repayments will take and how much users can save by paying more than the minimum. (This app will not tell you how much money you have loaned. Contact your school's bursar office for that information. Once you have that information, use this app.)

Features:

  • Automatic estimation
  • Swipe leftward to view how estimates were calculated.

Designed for phones running Android 4.2 (Jelly Bean) or above

Alternative downloads:
Version 1.x Alpha for Formal Field Test*  :white_check_mark:[No malware detected]
Version 1.x Alpha for Informal Field Test*^  :white_check_mark:[No malware detected]
Version 1.x Alpha for Focus Groups^  :white_check_mark:[No malware detected]
Version 1.x Alpha - Final  :white_check_mark:[No malware detected]

* renamed ^ identical

Install alternative downloads directly on phones running Android 4.2 (Jelly Bean) or above.

Build from Source Code

Download Android Studio from Google, and install it.
(For help with installing the application, follow its installation instructions.)

Do not run Android Studio in a virtual machine, though. Run it in a user's host operating system.
Otherwise, the app may not run successfully or quickly in an Android Virtual Device.

Also, download and install Git.

Open a terminal, and clone the project:

git clone https://gitlab.com/check-student-loans/android.git

(Recommended) Verify the project's authenticity: Look upward for "Verified," next to the commit SHA.

(Recommended) Open a terminal, and verify the project's integrity:

cd android
git show-ref --heads --hash

Check that the hash matches the commit SHA.

Open the project in Android Studio, and build the native app:

  • For a virtual or connected Android phone, select Build > Make Project.
  • Otherwise, select Build > Build APK(s).

Usage

Run the native app in a virtual device (e.g., Galaxy Nexus with API 28 x86) or on a connected device.
Or, install the APK file directly on a user's own Android phone.

Move the thumb of the slider, to select an estimated cost nearest to yours.
Press ▼ to select the interest rate of your loan.
Press − or + to select a monthly payment nearest to yours.

Known to work in Android Studio 3.4.2 and phones running Android 4.2 (Jelly Bean) or above.

Contributing

This project has been archived.
Please contribute to the project's counterpart, which is based on iOS, by going here.

History

Oct 31, 2019: enhanced accessibility
Sep 25, 2019: unified author name and email of all commits
Sep 17, 2019: starting signing commits, signed and re-committed old ones, inadvertently lost empty commits but they were empty anyway
Oct 12, 2018: refreshed entire project but inadvertently purged commit history
Sep 26, 2018 · Version 1.x: initial commit

Known Issues

This native app is an alpha build that is outdated.
Access the native app's most recent build, which is based on iOS, here.

License

MIT

Copyright (c) 2018-2020 Ed Silkworth