Skip to content

A collection of samples to discuss and showcase different architectural tools and patterns for Android apps.

License

Notifications You must be signed in to change notification settings

andyfun/android-architecture

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Android Architecture Blueprints [beta]

Join the chat at https://gitter.im/googlesamples/android-architecture

The Android framework offers a lot of flexibility when it comes to defining how to organize and architect an Android app. This freedom, whilst very valuable, can also result in apps with large classes, inconsistent naming and architectures (or lack of) that can make testing, maintaining and extending difficult.

Android Architecture Blueprints is meant to demonstrate possible ways to help with these common problems. In this project we offer the same application implemented using different architectural concepts and tools.

You can use these samples as a reference or as a starting point for creating your own apps. The focus here is on code structure, architecture, testing and maintainability. However, bear in mind that there are many ways to build apps with these architectures and tools, depending on your priorities, so these shouldn't be considered canonical examples. The UI is deliberately kept simple.

What does beta mean?

We're still making decisions that could affect all samples so we're keeping the initial number of variants low before the stable release.

Samples

All projects are released in their own branch. Check each project's README for more information.

In progress:

Also, see "New sample" issues for planned samples.

Why a to-do application?

The aim of the app is to be simple enough that it's understood quickly, but complex enough to showcase difficult design decisions and testing scenarios. Check out the app's specification.

Screenshot

Also, a similar project exists to compare JavaScript frameworks, called TodoMVC.

Which sample should I choose for my app?

That's for you to decide: each sample has a README where you'll find metrics and subjective assessments. Your mileage may vary depending on the size of the app, the size and experience of your team, the amount of maintenance that you foresee, whether you need a tablet layout or support multiple platforms, how compact you like your codebase, etc.

Who is behind this project?

This project is built by the community and curated by Google and core maintainers.

External contributors

David González - Core developer (Content Providers sample)

Karumi - Developers (MVP Clean architecture sample)

Erik Hellman - Developer (MVP RxJava sample)

Googlers

Jose Alcérreca - Lead/Core developer

Natalie Masse - Core developer

Stephan Linzner - Core developer

Mustafa Kurtuldu - UX/design

Want to be part of it? Read how to become a contributor and the contributor's guide

About

A collection of samples to discuss and showcase different architectural tools and patterns for Android apps.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published