Github Browser Sample with Android Architecture Components

This app is based on sample app that uses Android Architecture Components with Dagger 2.
Here is the file diff:

Table of Contents

• Github Browser Sample with Android Architecture Components
  • Table of Contents
  • Introduction
    • Functionality
      • UserSearchFragment
      • RepoFragment
      • UserFragment
    • GitHub Service APIs
    • Building
    • Demo
    • Download
    • Testing
      • Device Tests
        • Database Tests
      • Local Unit Tests
        • ViewModel Tests
        • Repository Tests
        • Webservice Tests
    • Libraries
  • License

Introduction

Functionality

The app is composed of 3 main screens.

UserSearchFragment

• Allows you to search users on Github.
• Each search result is kept in the database in UserSearchResult table where the list of repository IDs are denormalized into a single column.
• The actual User instances live in the User table.
• Each time a new page is fetched, the same UserSearchResult record in the Database is updated with the new list of user ids. (NOTE The UI currently loads all User items at once, which would not perform well on lower end devices. Instead of manually writing lazy adapters, we've decided to wait until the built in support in Room is released.)

RepoFragment

• This fragment displays the details of a repository and its contributors.

UserFragment

• This fragment displays a user and their repositories.

GitHub Service APIs

Building

You can open the project in Android studio and press run.

Demo

Download

You can download the apk through the following QR code for installation.

Testing

The project uses both instrumentation tests that run on the device and local unit tests that run on your computer.

Device Tests

Database Tests

The project creates an in memory database for each database test but still runs them on the device.

Local Unit Tests

ViewModel Tests

Each ViewModel is tested using local unit tests with mock Repository implementations.

Repository Tests

Each Repository is tested using local unit tests with mock web service and mock database.

Webservice Tests

The project uses MockWebServer project to test REST api interactions.

Libraries

• Android Support Library
• Android Architecture Components
• Android Data Binding
• Dagger 2 for dependency injection
• Retrofit for REST api communication
• Glide for image loading
• Timber for logging
• espresso for UI tests
• mockito for mocking in tests

License

Copyright 2017 The Android Open Source Project, Inc.

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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.