/ThisTweet

Primary LanguageJava

Project 4 - ThisTweet

ThisTweet 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: 15 hours spent in total

User Stories

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
  • 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:

The following additional features are implemented:

  • List anything else that you can get done to improve the app functionality!

Video Walkthrough

Here's a walkthrough of implemented user stories:

Video via Dropbox Link.

Video created with AZ Screen Recorder.

Notes

Describe any challenges encountered while building the app.

A difficult part of the assignment was getting the Coordinator layout scrolling behavior working for the user profile screen. I found it difficult to get the views arranged correctly to obtain the desired scrolling, collapsing effect. Another difficult aspect was having the FloatingActionButton behave correctly after refactoring from Activity to Fragment. I was able to solve the issue by moving the FloatingActionButton to the Activity level instead of Fragment level.

Open-source libraries used

  • Okhttp - An HTTP+HTTP/2 client for Android and Java applications.
  • Glide - An image loading and caching library for Android focused on smooth scrolling.
  • Gson - A Java serialization/deserialization library to convert Java Objects into JSON and back.
  • Apache Commons IO - The Apache Commons IO library contains utility classes, stream implementations, file filters, file comparators, endian transformation classes, and much more.
  • BottomDialog - An Android library that shows a customizable Material-based bottom sheet.
  • Date4J - Lightweight alternative to Java's built-in date-time classes.
  • glide-transformations - An Android transformation library providing a variety of image transformations for Glide.
  • okhttp-signpost - OAuth signing with signpost and okhttp
  • signpost - A light-weight client-side OAuth library for Java
  • android-oauth-handler - Android OAuth Wrapper makes authenticating with APIs simple

License

Copyright 2017 Robert Lee

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.