Index: docs/chromeos_build_instructions.md |
diff --git a/docs/chromeos_build_instructions.md b/docs/chromeos_build_instructions.md |
deleted file mode 100644 |
index 45f936c4d90671f048193b66d7bdda8dd4d9e52b..0000000000000000000000000000000000000000 |
--- a/docs/chromeos_build_instructions.md |
+++ /dev/null |
@@ -1,88 +0,0 @@ |
-# ChromeOS Build Instructions (Chromium OS on Linux) |
- |
-Chromium on Chromium OS is built from a mix of code sourced from Chromium |
-on Linux and Chromium on Windows. Much of the user interface code is |
-shared with Chromium on Windows. |
- |
-If you make changes to Chromium on Windows, they may affect Chromium |
-on Chromium OS. Fortunately to test the effects of your changes you |
-don't need to build all of Chromium OS, you can just build Chromium for |
-Chromium OS directly on Linux. |
- |
-First, follow the [normal Linux build |
-instructions](https://chromium.googlesource.com/chromium/src/+/master/docs/linux_build_instructions.md) |
-as usual to get a Chromium checkout. |
- |
-## Building and running Chromium with Chromium OS UI on your local machine |
- |
-If you plan to test the Chromium build on your dev machine and not a |
-Chromium OS device, run the following in your chromium checkout: |
- |
- $ gn gen out/Default --args='target_os="chromeos"' |
- $ ninja -C out/Default |
- |
-NOTE: You may wish to replace 'Default' with something like 'Cros' if |
-you switch back and forth between Linux and Chromium OS builds, or 'Debug' |
-if you want to differentiate between Debug and Release builds (see below) |
-or DebugCros or whatever you like. |
- |
-Now, when you build, you will build with Chromium OS features turned on. |
- |
-See [GN Build Configuration](https://www.chromium.org/developers/gn-build-configuration) |
-for more information about configuring your build. |
- |
-If you have not already done so, be sure to set the following to prevent |
-'gclient runhooks' from executing 'gyp_chromium': |
- |
- export GYP_CHROMIUM_NO_ACTION=1 |
- |
-Some additional options you may wish to set by passing in **--args** to |
-**gn gen** or running **gn args out/Default**: |
- |
- is_component_build = true |
- use_goma = true |
- is_debug = false # Release build |
- dcheck_always_on = true # Enable DCHECK (with is_debug = false) |
- is_official_build = true |
- is_chrome_branded = true |
- |
-## Notes |
- |
-When you build Chromium OS Chromium, you'll be using the TOOLKIT\_VIEWS |
-front-end just like Windows, so the files you'll probably want are in |
-src/ui/views and src/chrome/browser/ui/views. |
- |
-When target_os = "chromeos", then toolkit\_views need not (and should not) |
-be specified. |
- |
-The Chromium OS build requires a functioning GL so if you plan on |
-testing it through Chromium Remote Desktop you might face drawing |
-problems (e.g. Aura window not painting anything). Possible remedies: |
- |
-* --ui-enable-software-compositing --ui-disable-threaded-compositing |
-* --use-gl=osmesa, but it's ultra slow, and you'll have to build |
- osmesa yourself. |
-* ... or just don't use Remote Desktop. :) |
- |
-To more closely match the UI used on devices, you can install fonts used |
-by Chrome OS, such as Roboto, on your Linux distro. |
- |
-To specify a logged in user: |
- |
-* For first run, add the following options to the command line: |
- **--user-data-dir=/tmp/chrome --login-manager** |
-* Go through the out-of-the-box UX and sign in as |
- **username@gmail.com** |
-* For subsequent runs, add the following to the command line: |
- **--user-data-dir=/tmp/chrome --login-user=username@gmail.com**. |
-* To run in guest mode instantly, you can run add the arguments |
- **--user-data-dir=/tmp/chrome --bwsi --incognito |
- --login-user='$guest' --login-profile=user** |
- |
-Signing in as a specific user is useful for debugging features like sync |
-that require a logged in user. |
- |
-## Compile Chromium for a Chromium OS device using the Chromium OS SDK |
- |
-See [Building Chromium for a Chromium OS device](https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/building-chromium-browser) |
-for information about building and testing chromium for Chromium OS. |