/American_Express_Sponsored_Hack

Primary LanguageJava

Data Science Society American Express Challenge

Android mobile application for American Express users that recommends AMEX small businesses that they could visit to complete their day’s tasks/itinerary

Live demonstration of the app

A demonstration of the app and its services, showing how a typical user may use the app: https://youtu.be/ypjqgxlNZtI

Set up your phone

  1. Connect your device to your development machine with a USB cable. If you developed on Windows, you might need to install the appropriate USB driver for your device.
  2. Perform the following steps to enable USB debugging in the Developer options window.
  3. Open the Settings app.
  4. If your device uses Android v8.0 or higher, select System. Otherwise, proceed to the next step.
  5. Scroll to the bottom and select About phone.
  6. Scroll to the bottom and tap Build number seven times.
  7. Return to the previous screen, scroll to the bottom, and tap Developer options.
  8. In the Developer options window, scroll down to find and enable USB debugging

Option I: Run the app using APK file

  1. Open your Android’s Settings
  2. Scroll down and tap Security
  3. Allow app installation from external sources. (The process might be different in different devices)
  4. Connect the Android device to the PC using a USB cable
  5. Tap the USB for... notification on your Android and choose Transfer files
  6. Locate APK file in location AMEX_Hack/app-debug.apk
  7. Send over the APK file to your phone
  8. Open your Android’s file manager, locate the APK file and install it by clicking.

Option II: Open project in Android studio

Installation

  1. Clone the project into a folder.
  2. Make sure you have Android studio downloaded (https://developer.android.com/studio)
  3. Make sure you have JAVA JDK 11 downloaded (https://www.oracle.com/java/technologies/javase-jdk11-downloads.html)

Run the app

  1. Open Android Studio
  2. Go to File -> Open -> Naviagte to the folder that you cloned the folder in and open app
  3. Select your app from the run/debug configurations drop-down menu in the toolbar.
  4. In the toolbar, select the device that you want to run your app on from the target device drop-down menu.
  5. Click run

Help

See more detailed explanation on how to run android applications here https://developer.android.com/training/basics/firstapp/running-app.html

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License