codepath.com - Flicks (week1) - An android application that uses the themoviedb.org API
Flicks shows the latest movies currently playing in theaters. The app utilizes the Movie Database API to display images and basic information about these movies to the user.
Time spent: 10-14 hours spent in total (not exactly sure how many hours, playing with layouts was the most time consuming piece when things didn't work as expected)
IMPORTANT: In order to use the application, developer needs to create a secrets.xml file accordingly to the"Secrets in resource files" codepath.com guide and store the following keys:
- api_key_movie_db : The Movie DB AP v3 Key
- api_key_youtube_data : YouTube Data API v3 Key, from Google Developers Console
secrets.xml sample:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="api_key_movie_db"> </string>
<string name="api_key_youtube_data"> </string>
</resources>
The following required functionality is completed:
- User can scroll through current movies from the Movie Database API
- Layout is optimized with the ViewHolder pattern.
- For each movie displayed, user can see the following details:
- Title, Poster Image, Overview (Portrait mode)
- Title, Backdrop Image, Overview (Landscape mode)
The following optional features are implemented:
- User can pull-to-refresh popular stream to get the latest movies.
- Display a nice default placeholder graphic for each image during loading.
- Improved the user interface through styling and coloring.
The following bonus features are implemented:
- Allow user to view details of the movie including ratings and popularity within a separate activity or dialog fragment.
- When viewing a popular movie (i.e. a movie voted for more than 5 stars) the video should show the full backdrop image as the layout. Uses Heterogenous ListViews or Heterogenous RecyclerView to show different layouts.
- Allow video trailers to be played in full-screen using the YouTubePlayerView.
- Overlay a play icon for videos that can be played.
- More popular movies should start a separate activity that plays the video immediately.
- Less popular videos rely on the detail page should show ratings and a YouTube preview.
- Apply the popular Butterknife annotation library to reduce boilerplate code.
- Apply rounded corners for the poster or background images using Picasso transformations
- Replaced android-async-http network client with the popular OkHttp or Volley networking libraries.
The following additional features are implemented:
- Allow user to see details of popular movies onLongItemClick
Here's a walkthrough of implemented user stories.
Note: Due to missing dependencies in the emulator, YouTube player in the git walkthrough doesn't displays the video, but it has been successfully tested on an Android device.
GIF created with LiceCap.
Describe any challenges encountered while building the app.
Copyright 2016 Eduardo Theiss Przysiezny
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.