A gardening app illustrating Android development best practices with Android Jetpack.
Android Sunflower is currently under heavy development. Note that some changes (such as database schema modifications) are not backwards compatible 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 arrange them into four categories:
Android Sunflower demonstrates utilizing these components to create a simple gardening app. Read the Introducing Android Sunflower article for a walkthrough of the 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 devicetest
- for running unit testsFor more resources on learning Android development, visit the Developer Guides at developer.android.com.
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.
For development, the latest version of Android Studio is required. The latest version can be downloaded from here.
Sunflower uses ktlint to enforce Kotlin coding styles. Here's how to configure it for use with Android Studio (instructions adapted from the ktlint README):
Close Android Studio if it's open
Download ktlint using these installation instructions
Inside the project root directory run:
./ktlint --apply-to-idea-project --android
Start Android Studio
Check out these Wiki pages to learn more about Android Sunflower:
The focus of this project is on Android Jetpack and the Android framework. Thus, there are no immediate plans to implement features outside of this scope.
A note on dependency injection - while many projects (such as Plaid) use Dagger 2 for DI, there are no plans to incorporate DI into Sunflower. This allows developers unfamiliar with dependency injection to better understand Sunflower's code without having to learn DI.
If you've found an error in this sample, please file an issue: https://github.com/android/sunflower/issues
Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub.
Select text used for describing the plants (in plants.json
) are used from Wikipedia via CC BY-SA 3.0 US (license in ASSETS_LICENSE
).
"seed" by Aisyah is licensed under CC BY 3.0
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
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.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。