Chrome Release Bot (LUCI) 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
..
accelerators 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
accelerometer 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
accessibility 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ambient 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
animation 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
app_list 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
app_menu 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ash_strings_grd 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
assistant 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
bubble 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
calendar 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
capture_mode 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
child_accounts 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
clipboard 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
components 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
constants 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
controls 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
dbus 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
detachable_base 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
display 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
drag_drop 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
events 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
fast_ink 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
frame 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
frame_throttler 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
glanceables 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
high_contrast 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
highlighter 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
host 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
hud_display 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ime 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
in_session_auth 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
keyboard 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
lock_screen_action 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
login 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
media 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
metrics 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
multi_capture 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
multi_device_setup 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
multi_user 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
perftests 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
policy 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
power 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
projector 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
public 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
quick_pair 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
resources 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
rgb_keyboard 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
rotator 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
search_box 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
services 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
session 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shelf 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shortcut_viewer 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
strings 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
style 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
system 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
test 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
tooltips 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
touch 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
tray_action 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
utility 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
wallpaper 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
webui 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
wm 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
BUILD.gn 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
DEPS 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
DIR_METADATA 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
OWNERS 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
README.md 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ash_export.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ash_interfaces.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ash_prefs.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
ash_strings.grd 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
autotest_private_api_utils.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
bluetooth_devices_observer.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
bluetooth_devices_observer.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
cancel_mode.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
cancel_mode.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
debug.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
debug.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
dip_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
extended_desktop_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
focus_cycler.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
focus_cycler.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
focus_cycler_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
login_status.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
multi_profile_uma.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
multi_profile_uma.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
root_window_controller.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
root_window_controller.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
root_window_controller_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
root_window_settings.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
root_window_settings.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
scoped_animation_disabler.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
scoped_animation_disabler.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
screen_util.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
screen_util.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
screen_util_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_delegate.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_delegate.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_init_params.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_init_params.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_observer.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_tab_handler.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_tab_handler.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_test_api.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shell_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shutdown_controller_impl.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shutdown_controller_impl.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shutdown_reason.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
shutdown_reason.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
test_media_client.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
test_media_client.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
test_shell_delegate.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
test_shell_delegate.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
window_tree_host_lookup.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
window_user_data.h 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago
window_user_data_unittest.cc 4762b62e7d Publish DEPS for 106.0.5249.13 1 year ago

README.md

Ash

Ash is the «Aura Shell», the window manager and system UI for Chrome OS. Ash uses the views UI toolkit (e.g. views::View, views::Widget, etc.) backed by the aura native widget and layer implementations.

Dependencies

Ash sits below chrome in the dependency graph (i.e. it cannot depend on code in //chrome). For historical reasons, ash has multiple dependency levels:

  • General //ash code is on top (//ash/system, //ash/wm, etc.)
  • //ash/components sit below //ash, see README
  • //ash/constants sit near the bottom of the dependency graph, see README

Access to Ash internals is controlled by DEPS files. Unless explicitly allowed by DEPS, code outside Ash should depend on the interfaces in //ash/public. Check with OWNERS if you have questions.

Tests

Tests should be added to the ash_unittests target.

Tests can bring up most of the ash UI and simulate a login session by deriving from AshTestBase. This is often needed to test code that depends on ash::Shell and the controllers it owns.

Test support code (TestFooDelegate, FooControllerTestApi, etc.) lives in the same directory as the class under test (e.g. //ash/foo rather than //ash/test). Test code uses namespace ash; there is no special «test» namespace.

Prefs

Ash supports both per-user prefs and device-wide prefs. These are called «profile prefs» and «local state» to match the naming conventions in chrome. Ash also supports «signin screen» prefs, bound to a special profile that allows users to toggle features like spoken feedback at the login screen.

Pref names are in //ash/public/cpp so that code in chrome can also use the names. Prefs are registered in the classes that use them because those classes have the best knowledge of default values.

Historical notes

Ash shipped on Windows for a couple years to support Windows 8 Metro mode. Windows support was removed in 2016.

The mash (some times called mus-ash or mustash) project was an effort to move ash into its own process and the browser in its own process. Communication between the two processes was done over mojo. Windowing was done using the window-service (some times called mus), which ran with Ash. Many of the mojo interfaces have been converted to pure virtual interfaces, with the implementation in ash. The mash project was stopped around 42019.