This application allows users to search for images in the Imgur gallery and display the top images of the week in a list. It provides a search functionality where users can enter text as part of the search query to retrieve relevant results.
- Search: Enter a search query to find images in the Imgur gallery.
- Display: View the top images of the week in a list.
- Toggle: Switch between list and grid view to change the display results.
- Image Details: Each search result displays the title, date of the post, number of additional images, and the image itself.
Include screenshots or GIFs of your application here to give users a visual representation of the application's interface and functionality.
Follow these instructions to get the project up and running on your local machine.
- Android Studio installed
- Android SDK configured
- Clone the repository:
git clone https://github.com/your-repo.git
- Open the project in Android Studio.
- Build and run the application on an emulator or physical device.
- Launch the application on your device.
- Enter a search query in the search bar.
- Press Enter or the search button to perform the search.
- View the search results in the list.
- Use the toggle button to switch between list and grid view.
- Coil: Image loading and caching library
- Retrofit: HTTP client for making API requests
- Gson: JSON serialization/deserialization library
- RecyclerView: Displaying the search results in a list/grid view
- etc.
To access the Imgur API and perform image searches, you will need to obtain an API key. Follow the instructions provided by Imgur to register your application and obtain the API key. Once obtained, add the API key to the appropriate place in the code.
Specify the license under which your code is distributed (e.g., MIT, Apache 2.0, etc.).
Specify guidelines for contributing to your project, such as the process for submitting pull requests, coding standards, etc.