A collection of samples to discuss and showcase different architectural tools and patterns for Android apps.
Android Architecture Blueprints is a project to showcase different architectural approaches to developing Android apps. In its different branches you'll find the same app (a TODO app) implemented with small differences.
In this branch you'll find: * Kotlin Coroutines for background operations. * A single-activity architecture, using the Navigation component to manage fragment operations. * A presentation layer that contains a fragment (View) and a ViewModel per screen (or feature). * Reactive UIs using LiveData observables and Data Binding. * A data layer with a repository and two data sources (local using Room and remote) that are queried with one-shot operations (no listeners or data streams). * Two product flavors,
prod, to ease development and testing (except in the Dagger branch). * A collection of unit, integration and e2e tests, including "shared" tests that can be run on emulator/device or Robolectric.
This project hosts each sample app in separate repository branches. For more information, see the
README.mdfile in each branch.
| Sample | Description |
| ------------- | ------------- |
| master | The base for the rest of the branches.
Uses Kotlin, Architecture Components, coroutines, Data Binding, etc. and uses Room as source of truth, with a reactive UI. | | dagger-android
[compare] | A simple Dagger setup that uses
dagger-androidand removes the two flavors. | | usecases
Blueprints v1 had a collection of samples that are not maintained anymore, but can still be useful. See all project branches.
The app in this project aims to be simple enough that you can understand it quickly, but complex enough to showcase difficult design decisions and testing scenarios. For more information, see the app's specification.
To open one of the samples in Android Studio, begin by checking out one of the sample branches, and then open the root directory in Android Studio. The following series of steps illustrate how to open the usecases sample.
Clone the repository:
git clone [email protected]:googlesamples/android-architecture.git
This step checks out the master branch. If you want to change to a different sample:
git checkout usecases
Note: To review a different sample, replace
usecaseswith the name of sample you want to check out.
Finally open the
android-architecture/directory in Android Studio.
Copyright 2019 Google, 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
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.