A gardening app illustrating Android development best practices with Android Jetpack.
Android Sunflower is currently released as an alpha and is under heavy development. To view the latest changes, please visit the Releases page. Note that some changes (such as database schema modifications) are not backwards compatible during this alpha period and may cause the app to crash. In this case, please uninstall and re-install the app.
Android Jetpack is a set of components, tools and guidance to make great Android apps. They bring together the existing Support Library and Architecture Components and arranges them into four categories:
Android Sunflower demonstrates utilizing these components to create a simple gardening app.
This project uses the Gradle build system. To build this project, use the
gradlew build command or use "Import Project" in Android Studio.
There are two Gradle tasks for testing the project:
connectedAndroidTest- for running Espresso on a connected device
test- for running unit tests
- Foundation - Components for core system capabilities, Kotlin extensions and support for multidex and automated testing.
- Architecture - A collection of libraries that help you design robust, testable, and
maintainable apps. Start with classes for managing your UI component lifecycle and handling data
- Data Binding - Declaratively bind observable data to UI elements.
- Lifecycles - Create a UI that automatically responds to lifecycle events.
- LiveData - Build data objects that notify views when the underlying database changes.
- Navigation - Handle everything needed for in-app navigation.
- Room - Access your app's SQLite database with in-app objects and compile-time checks.
- ViewModel - Store UI-related data that isn't destroyed on app rotations. Easily schedule asynchronous tasks for optimal execution.
- WorkManager - Manage your Android background jobs.
- UI - Details on why and how to use UI Components in your apps - together or separate
- Third party
- Glide for image loading
Updates will include incorporating additional Jetpack components and updating existing components as the component libraries evolve.
Interested in seeing a particular feature of the Android Framework or Jetpack implemented in this app? Please open a new issue.
Android Studio IDE setup
For development, the latest version of Android Studio 3.2 is required. The latest version can be downloaded from here.
Close Android Studio if it's open
curl -sSLO https://github.com/shyiko/ktlint/releases/download/0.29.0/ktlint && chmod a+x ktlint
Inside the project root directory run:
ktlint --apply-to-idea-project --android
Remove ktlint if desired:
Start Android Studio
- Google+ Community: https://plus.google.com/communities/105153134372062985968
- Stack Overflow:
If you've found an error in this sample, please file an issue: https://github.com/googlesamples/android-sunflower/issues
Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub.
Copyright 2018 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.