0
Files
src/docs/ui/android/overview.md
Lijin Shen cea7dbebb8 Fix typos and links in android night_mode docs
1. Fix some typos.
2. Some links are out-of-date.

Bug: 775198
Change-Id: I11d56530427d61c727ece0c8632d40b7e8faca9f
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2163627
Auto-Submit: Lijin Shen <lazzzis@google.com>
Reviewed-by: Theresa  <twellington@chromium.org>
Commit-Queue: Theresa  <twellington@chromium.org>
Cr-Commit-Position: refs/heads/master@{#762072}
2020-04-23 19:58:05 +00:00

2.8 KiB

Chrome for Android UI

Ramping-up

Android has a number of developer guides that are helpful for getting ramped up on general Android development. We recommend reading the following as primers for developing UI:

Colors and text styles

Chrome for Android has a color palette defined in //ui/android/java/res/values/color_palette.xml and a set of reusable semantic colors defined in //ui/android/java/res/values/semantic_colors_adaptive.xml. The semantic colors from semantc_colors_adaptive.xml should be used to ensure colors adapt properly for dark mode and can be consistently and easily updated during product-wide visual refreshes.

For more information on selecting the right color, see Night Mode on Chrome Android.

Text should be styled with a pre-defined text appearance from //ui/android/java/res/values-v17/styles.xml. If leading (aka line height) is needed, use org.chromium.ui.widget.TextViewWithLeading with app:leading set to one of the pre-defined *_leading dimensions in //ui/android/java/res/values/dimens.xml.

Widgets

The Chromium code base contains a number of wrappers around Android classes (to smooth over bugs or save on binary size) and many UI widgets that provide Chrome-specific behavior and/or styling.

These can be found in //components/browser_ui/widget/android/, //ui/android/, and //chrome/android/java/src/org/chromium/chrome/browser/widget/. There is an ongoing effort to consolidate all widgets in //components/browser_ui/widget/android.

MVC

UI development should follow a modified Model-View-Controller pattern. MVC base classes live in //ui/android/java/src/org/chromium/ui/modelutil.

The following guides introduce MVC in Chrome for Android: