This application is an android based e-commerce application, developed as a project for the subject of Mobile Computing. The presented content in this repository is an android application developed according to the proposal submitted as a part of the final project of the semester. The android application helps its users by providing them a platform to Sell/Buy products by uploading the images of the product and entering details about the same like name, description, price, location, and contact information.
Splash Screen
- /documentation - Contains the proposal submitted to the instructor. documentation
- /app - Contains the source code and the library files necessary for running this application in android studios. code
- /img - Contains all the image file of this project. img
- /LICENSE - Contains the details of the license for this project. LICENSE
- An android based device.
- The version on the android phone should be at least or above android version KitKat 4.4
- The mobile phone should be able to the internet.
To install the LISTINGS application, the user needs to follow any of the two ways shown below according to their convenience and preference:
BY RUNNING THE APPLICATION IN THE ANDROID STUDIOS:
To install the application by downloading the project, follow the steps below:
- Download and install android studios in the laptop/pc.
- Traverse to File
- Click on New -> Project from Version Control...
- Enter the URL https://github.com/akashsingh11596/LISTINGS
- Click on Clone option.
PREQUISITES:
Register your app package in Google Firebase
For adding Database to your Project.
- Open Android Studios.
- Traverse to Tools in android studios.
- Click on Tools -> Firebase
- Click on Realtime Database
- Click on 'Add the Realtime Database SDK to your app'.
For adding authentication to your Project.
- Open Android Studios.
- Traverse to Tools in android studios.
- Click on Tools -> Firebase
- Click on Authentication
- Add all the dependencies as mentioned.
For adding Cloud Storage for Firebase storage to your Project.
- Open Android Studios.
- Traverse to Tools in android studios.
- Click on Tools -> Firebase
- Click on Cloud Storage for Firebase
- Click on 'Add the Cloud Storage SDK to your app'.
BY DOWNLOADING THE APK:
To install the application by downloading the apk, follow the steps below:
- Click on apk
- Download the file.
- After the file is downloaded, copy it to the mobile device you want to install the application.
- After the application is installed provide the permission it requires to access the internet (if the alert on the device occurs).
- Run/Open the application.
- You can now use the application.
Below are the steps that the user needs to follow for operating the Listings android application:
If the user is not already signed up for the Listings application, then the user will first sign up for the application.
To sign up for the Listings, application the user has to enter the following details:
- Full Name
- Email Id
- Username
- Password
- Gender
- Age
- Phone Number
The screenshots of the SignUp pages of the application are shown below:
SignUp Screens
After the user has entered the details during signing up , they will receive an OTP for the verfication of the account. A code will be send onto their devices. If the user is using the same device to as the phone number they have entered, the OTP will automatically be verified, without having the need to enter the OTP received manually. Below is the screenshot of the OTP screen.
OTP Screens
After the user has signed up for the Listings android application, then they can follow the below steps to log in to the application:
- Click on the Country Picker to select your country (if your country is not selected).
- Enter the phone number which you have entered while creating an account.
- Enter the password.
- Click on Login button.
If user has not Signed Up for the application click on 'SIGN UP FOR LISTINGS'
Login Screen
After the user has entered into the application, they can see the listings of the products uploaded by the users to sell. They can scroll through the listings and then can contact the user on the contact information provided by the sellers. The description and price of the product entered by the seller are also shown under the image of the product.
Below is the screenshot of the listings on the application.
Sample Listing Screen
To sell the products, the seller has to follow the steps as mentioned below:
- Click on the drawer menu on the top left of the screen/ Swipe the screen from left to right.
- Select the 'Sell' option.
- Click the 'Choose Photo' option.
- Select the image of the product to upload.
- User will be able to see the image in the blank box.
Enter the details of the products:
- Click on the 'Enter Product Name'.
- Enter the name of the product.
- Click on the 'Enter Phone Number/Email Id'.
- Enter the contact information on which the buyer will be able to contact you.
- Click on the 'Description'.
- Enter the description of the product along with the price.
- Click on the Location option.
- Enter the location of the product.
After the user has entered the details of the product, Click on the 'UPLOAD' button. This will upload the image to the listings and the user will able to see their product under the listings section, with other items that are uploaded to be sold.
Below are the screenshots:
Selling Products on Listings
The user can look up their information and details that they have entered while signing up for the application. The user has to follow the steps below to look up their information:
- Click on the drawer menu on the top left of the screen/ Swipe the screen from left to right.
- Select the 'User' option.
- The screen will now show the details of the user.
User Information
This section of the application is dedicated to information/about us section of the the LISTINGS application. The user under this section can learn about what the LISTINGS application is and what are the features of this application. This section of the application also provides the details about how to contact the developer if they want to update their information, remove their product from the platform, and if they are facing any technical issues.
To read about the application the user has to follow the steps below:
- Click on the drawer menu on the top left of the screen/ Swipe the screen from left to right.
- Select the 'About' option.
- The About section of the application will appear.
About Screen
'Need Help?' feature of the LISTINGS application provides the users with the instructions to operate the application. There are sections dedicated to solve user's problems: The user can also access this from the Login page of the application. The user has to follow the steps below to get access to this feature:
- Click on the drawer menu on the top left of the screen/ Swipe the screen from left to right.
- Select the 'Need Help?' option.
- This section of the application will appear which will show the instructions to operate this application.
Instructions to operate Listings
To access it directly from the Login Page, follow the steps below:
- Open Login Page
- Click on the Need Help button.
Instructions to operate Listings
To exit the Listings application, the user has to follow the steps below:
- Click on the drawer menu on the top left of the screen/ Swipe the screen from left to right.
- Select the 'Logout' option.
- You are logged out of the appllication.
Logging Out of Listings
Below are the Manifest of Files in MVC format:
MODEL
In the application the package with name 'DatabaseAndConnectors' contains the files which are reponsible to connect the application to the database. They are responsible to connect the application with the FireBase(database) and update, upload, and retrieve data from it. The list of files under this section are:
CONTROLLER
In the application there are three packages with the name of 'listings', 'Login_SignUp', and 'MainScreen'. These files are responsible to connect the view with the application using Listners, Intents and other methods. The purpose of the files under this section is to respond when the view of the application comes in contact with the user of the application. They trigger the methods and functions according to the selection of the user.
- FirstAppScreen
- MainActivity
- NeedHelp
- Login
- OTP_verification_screen
- SignUp
- SignUp2ndPageClass
- SignUp3rdPageClass
- AboutScreen
- MainScreenOfApp
- SellScreen
- userInfo
VIEW
This section of the application holds the list of all the view files in the 'resource layout', and string folder. The responsibility of the files under this folder is to create the UI which the user will interact with. Below are the list of all the files under this section:
- activity_first_app_screen
- activity_about_screen
- activity_login
- activity_main
- activity_main_screen_of_app
- activity_need_help
- activity_o_t_p_verification_screen
- activity_sell_screen
- activity_sign_up
- activity_sign_up2nd_page_class
- activity_sign_up3rd_page_class
- activity_user_info
- custom_grid_layout
- header
- strings
To secure applications from error and to prevent the wrong entries from the user there are some steps taken during the development of the Listings android application. Below are the errors and their screenshots.
- If the user is skipping enteried, they will be shown a red error on the right hand side of the text box wehere they are forgetting to insert the information.
- The user will also be shown a message for a few seconds, in some cases.
Errors if values are missing in Login and SignUp pages:
Login and SignUp Errors
If the device is not connected to the internet, following error will be shown in an alert box:
Internet Connection Error
If the OTP enterred by the user is wrong, then in that case a message of 'ERROR IN VERIFICATION' will be shown to the user.
OTP Error
The team for this project consists of:
Akash Singh (Role: Designing, Coding, Testing, and Documentation)
People who deserve credits for motivating me for this project:
- Dr. Trevor Tomesh, Instructor- CS 855 Mobile Computing
- Coding With Tea
- Coding in Flow
- Family and friends cannot be forgotten :)
© Akash Singh, Computer Science, University Of Regina
Licensed Under MIT LICENSE