FPL Assistant

Android App

About the project   |    Technologies   |    Getting started   |    How to contribute   |    License

👨🏻‍💻 About the project

• An Android app that shows a useful info and stats about football players in fantasy premier league

• It shows for each player:-
  • A prediction for price change
  • The amount of price change
  • Ownership
  • Point per price
  • Form
  • Total points
  • Fixtures

This app gets these data from an external api. To see this api, click here: FPL Assistant Rest API

🚀 Technologies

Technologies that I used to develop this mobile client

• Android 11 (Api level 30)
• Kotlin
• Material Design
• Shimmer
• Coroutines
• Retrofit
• Glide
• Firebase

💻 Getting started

Requirements

• Have this application's API running

Clone the project and access the folder

$ git clone https://github.com/MohamedAmgd/FPL-Assistant.git && cd FPL-Assistant

Configre Api

• Add the api url in baseUrl in This file

Configre firebase

• Generate a google-services.json file How to get google-services.json file
• Replace the empty google-services.json file by the generated one

Working with Android Studio.

Android Studio is currently the official Android IDE. Due to this, it is recommended as the IDE to use in your development environment.

It is recommended to use the last version available in the stable channel of Android Studio updates. See what update channel is your Android Studio checking for updates in the menu path 'Help'/'Check for Update...'/link 'Updates' in the dialog.

To set up the project in Android Studio follow the next steps:

• Open Android Studio and select 'Import Project (Eclipse ADT, Gradle, etc)'. Browse through your file system to the folder 'android' where the project is located. Android Studio will then create the '.iml' files it needs. If you ever close the project but the files are still there, you just select 'Open Project...'. The file chooser will show an Android face as the folder icon, which you can select to reopen the project.
• Android Studio will try to build the project directly after importing it. To build it manually, follow the menu path 'Build'/'Make Project', or just click the 'Play' button in the tool bar to build and run it in a mobile device or an emulator. The resulting APK file will be saved in the 'build/outputs/apk/' subdirectory in the project folder.

Working in a terminal with Gradle:

Gradle is the build system used by Android Studio to manage the building operations on Android apps. You do not need to install Gradle in your system, and Google recommends not to do it, but instead trusting on the Gradle wrapper included in the project.

• Open a terminal and go to the 'android' directory that contains the repository.
• Run the 'clean' and 'build' tasks using the Gradle wrapper provided
  • Windows: gradlew.bat clean build
  • Mac OS/Linux: ./gradlew clean build

The first time the Gradle wrapper is called, the correct Gradle version will be downloaded automatically. An Internet connection is needed for it works. The generated APK file is saved in android/build/outputs/apk as android-debug.apk

🤔 How to contribute

Make a fork of this repository

# Fork using GitHub official command line
# If you don't have the GitHub CLI, use the web site to do that.

$ gh repo fork MohamedAmgd/FPL-Assistant

Follow the steps below

# Clone your fork
$ git clone your-fork-url && cd FPL-Assistant

# Create a branch with your feature
$ git checkout -b my-feature

# Make the commit with your changes
$ git commit -m 'feat: My new feature'

# Send the code to your remote branch
$ git push origin my-feature

After your pull request is merged, you can delete your branch

📝 License

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

---

Made by Mohamed Amgd 👋 See my linkedin