Simple Tweets is an Android app that allows a user to view home and mentions timelines, view user profiles with user timelines, as well as compose and post a new tweet. The app utilizes Twitter REST API.
Time spent: 18 hours spent in total
The following required functionality is completed:
- The app includes all required user stories from Week 3 Twitter Client
- User can switch between Timeline and Mention views using tabs
- User can view their home timeline tweets.
- User can view the recent mentions of their username.
- User can navigate to view their own profile
- User can see picture, tagline, # of followers, # of following, and tweets on their profile.
- User can click on the profile image in any tweet to see another user's profile.
- User can see picture, tagline, # of followers, # of following, and tweets of clicked user.
- Profile view includes that user's timeline
- User can infinitely paginate any of these timelines (home, mentions, user) by scrolling to the bottom
The following optional features are implemented:
- User can view following / followers list through the profile
- Implements robust error handling, check if internet is available, handle error cases, network failures
- When a network request is sent, user sees an indeterminate progress indicator
- User can "reply" to any tweet on their home timeline
- The user that wrote the original tweet is automatically "@" replied in compose
- User can click on a tweet to be taken to a "detail view" of that tweet
- User can take favorite (and unfavorite) or retweet actions on a tweet
- Improve the user interface and theme the app to feel twitter branded
- User can search for tweets matching a particular query and see results
- Usernames and hashtags are styled and clickable within tweets using clickable spans
The following bonus features are implemented:
- Use Parcelable instead of Serializable using the popular Parceler library.
- Leverages the data binding support module to bind data into layout templates.
- On the profile screen, leverage the CoordinatorLayout to apply scrolling behavior as the user scrolls through the profile timeline.
- User can view their direct messages (or send new ones)
The following additional features are implemented:
- Tweets of different timelines are saved in the database independently of each other, so that when the app is started in offline mode, each timeline can be independently restored from the data cached in the database
- Use of a login manager and an offline mode manager in order to pull this business-level logic out of the low-level implementation
Here's a walkthrough of implemented user stories:
GIF created with LiceCap.
- Abstraction of the timeline fragments can be improved: there is still a lot of replicated code in the different concrete subclasses.
- The manager approach (i.e. pulling business logic out of the low-level implementation) seems to be very powerful, but it's not trivial for novices how to best use it.
- Currently, identical tweets belonging to different timelines (e.g. home and user timeline) are saved independently of each other in the database. This should be improved to save each tweet only once.
- The "last update" timestamp of the user timelines is currently not specific to the corresponding user, but there's only a single timestamp for all user timelines. This could be fixed by storing the last update of each user timeline in an additional database table.
- Codepath OAuth Handler - Android library for simplifying the handling of OAuth requests (uses ScribeJava and Android Async HTTP)
- ScribeJava - Simple OAuth client Java library
- Android Async HTTP - Simple asynchronous HTTP requests with JSON parsing
- Gson - Java serialization/deserialization library for converting JSON objects to Java objects and vice versa
- Picasso - Image loading and caching library for Android
- DBFlow - Object-relational mapper (ORM) for Android
- Retrolambda - Enable lambda expressions and method references for Java < 8
- Stetho - Chrome-based Android debugging bridge (used for inspecting SQLite database)
- EventBus - Pass events between Android application components
Copyright 2017 Daniel Weibel
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.