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

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.