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

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.