0

Update doc references to ninja to also mention autoninja.

Change-Id: Ib45d3f86a0b68f6d0b10847cf7e3859b640e34a3
Reviewed-on: https://chromium-review.googlesource.com/c/1292403
Commit-Queue: Dirk Pranke <dpranke@chromium.org>
Reviewed-by: Bruce Dawson <brucedawson@chromium.org>
Cr-Commit-Position: refs/heads/master@{#602453}
This commit is contained in:
Dirk Pranke
2018-10-24 21:22:10 +00:00
committed by Commit Bot
parent 749181de7b
commit 8bd55f2862
10 changed files with 34 additions and 27 deletions

@ -147,13 +147,12 @@ Build Chromium with Ninja using the command:
autoninja -C out/Default chrome_public_apk autoninja -C out/Default chrome_public_apk
``` ```
`autoninja` is a wrapper that automatically provides optimal values for the (`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`. arguments passed to `ninja`.)
You can get a list of all of the other build targets from GN by running `gn ls You can get a list of all of the other build targets from GN by running `gn ls
out/Default` from the command line. To compile one, pass the GN label to Ninja out/Default` from the command line. To compile one, pass the GN label to Ninja
with no preceding "//" (so, for `//chrome/test:unit_tests` use `ninja -C with no preceding "//" (so, for `//chrome/test:unit_tests` use `autoninja -C
out/Default chrome/test:unit_tests`). out/Default chrome/test:unit_tests`).
### Multiple Chrome APK Targets ### Multiple Chrome APK Targets

@ -144,9 +144,12 @@ require you to set `CHROMIUM_OUTPUT_DIR=out/Default`.
Build `cast_shell_apk` with Ninja using the command: Build `cast_shell_apk` with Ninja using the command:
```shell ```shell
$ ninja -C out/Default cast_shell_apk $ autoninja -C out/Default cast_shell_apk
``` ```
(`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`.)
## Installing and Running `cast_shell_apk` on a device ## Installing and Running `cast_shell_apk` on a device
### Plug in your Android device ### Plug in your Android device
@ -176,7 +179,7 @@ unplugging and reattaching your device.
### Build the APK ### Build the APK
```shell ```shell
ninja -C out/Release cast_shell_apk autoninja -C out/Release cast_shell_apk
``` ```
And deploy it to your Android device: And deploy it to your Android device:

@ -42,6 +42,9 @@ Run the following in your chromium checkout:
$ autoninja -C out/Default chrome $ autoninja -C out/Default chrome
$ out/Default/chrome $ out/Default/chrome
(`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`).
Some additional options you may wish to set by passing in `--args` to `gn gen` Some additional options you may wish to set by passing in `--args` to `gn gen`
or running `gn args out/Default`: or running `gn args out/Default`:

@ -140,8 +140,8 @@ example:
$ autoninja -C out/fuchsia base_unittests $ autoninja -C out/fuchsia base_unittests
``` ```
`autoninja` is a wrapper that automatically provides optimal values for the (`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`. arguments passed to `ninja`.)
## Run ## Run

@ -81,13 +81,16 @@ it does not exist). Look at `src/ios/build/tools/setup-gn.config` for
available configuration options. available configuration options.
From this point, you can either build from Xcode or from the command line using From this point, you can either build from Xcode or from the command line using
`ninja`. `setup-gn.py` creates sub-directories named `autoninja`. `setup-gn.py` creates sub-directories named
`out/${configuration}-${platform}`, so for a `Debug` build for simulator use: `out/${configuration}-${platform}`, so for a `Debug` build for simulator use:
```shell ```shell
$ ninja -C out/Debug-iphonesimulator gn_all $ autoninja -C out/Debug-iphonesimulator gn_all
``` ```
(`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`.)
Note: you need to run `setup-gn.py` script every time one of the `BUILD.gn` Note: you need to run `setup-gn.py` script every time one of the `BUILD.gn`
file is updated (either by you or after rebasing). If you forget to run it, file is updated (either by you or after rebasing). If you forget to run it,
the list of targets and files in the Xcode solution may be stale. the list of targets and files in the Xcode solution may be stale.
@ -191,7 +194,7 @@ step will fail and will print the bundle identifier of the bundle that could not
be signed on the command line, e.g.: be signed on the command line, e.g.:
```shell ```shell
$ ninja -C out/Debug-iphoneos ios_web_shell $ autoninja -C out/Debug-iphoneos ios_web_shell
ninja: Entering directory `out/Debug-iphoneos' ninja: Entering directory `out/Debug-iphoneos'
FAILED: ios_web_shell.app/ios_web_shell ios_web_shell.app/_CodeSignature/CodeResources ios_web_shell.app/embedded.mobileprovision FAILED: ios_web_shell.app/ios_web_shell ios_web_shell.app/_CodeSignature/CodeResources ios_web_shell.app/embedded.mobileprovision
python ../../build/config/ios/codesign.py code-sign-bundle -t=iphoneos -i=0123456789ABCDEF0123456789ABCDEF01234567 -e=../../build/config/ios/entitlements.plist -b=obj/ios/web/shell/ios_web_shell ios_web_shell.app python ../../build/config/ios/codesign.py code-sign-bundle -t=iphoneos -i=0123456789ABCDEF0123456789ABCDEF01234567 -e=../../build/config/ios/entitlements.plist -b=obj/ios/web/shell/ios_web_shell ios_web_shell.app

@ -242,8 +242,8 @@ Build Chromium (the "chrome" target) with Ninja using the command:
$ autoninja -C out/Default chrome $ autoninja -C out/Default chrome
``` ```
`autoninja` is a wrapper that automatically provides optimal values for the (`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`. arguments passed to `ninja`.)
You can get a list of all of the other build targets from GN by running `gn ls You can get a list of all of the other build targets from GN by running `gn ls
out/Default` from the command line. To compile one, pass the GN label to Ninja out/Default` from the command line. To compile one, pass the GN label to Ninja

@ -1,7 +0,0 @@
# Linux Build Instructions Prerequisites
The contents of this page have been folded into the
[Linux build instructions](linux_build_instructions.md).
This file will be deleted in the future, please update your links.

@ -128,9 +128,12 @@ You might try some of the suggestions on the
Build cast\_shell with Ninja using the command: Build cast\_shell with Ninja using the command:
```shell ```shell
$ ninja -C out/Default cast_shell $ autoninja -C out/Default cast_shell
``` ```
(`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`.)
## Run cast\_shell ## Run cast\_shell
Once it is built, you can simply run it: Once it is built, you can simply run it:

@ -160,8 +160,8 @@ Build Chromium (the "chrome" target) with Ninja using the command:
$ autoninja -C out/Default chrome $ autoninja -C out/Default chrome
``` ```
`autoninja` is a wrapper that automatically provides optimal values for the (`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`. arguments passed to `ninja`.)
You can get a list of all of the other build targets from GN by running `gn ls You can get a list of all of the other build targets from GN by running `gn ls
out/Default` from the command line. To compile one, pass the GN label to Ninja out/Default` from the command line. To compile one, pass the GN label to Ninja
@ -233,7 +233,7 @@ slow, but it runs fairly well even **with indexing enabled**. Most people
build in the Terminal and write code with a text editor, though. build in the Terminal and write code with a text editor, though.
With hybrid builds, compilation is still handled by Ninja, and can be run from With hybrid builds, compilation is still handled by Ninja, and can be run from
the command line (e.g. `ninja -C out/gn chrome`) or by choosing the `chrome` the command line (e.g. `autoninja -C out/gn chrome`) or by choosing the `chrome`
target in the hybrid workspace and choosing Build. target in the hybrid workspace and choosing Build.
To use Xcode-Ninja Hybrid pass `--ide=xcode` to `gn gen`: To use Xcode-Ninja Hybrid pass `--ide=xcode` to `gn gen`:

@ -54,10 +54,13 @@ being distributed.
1. Build the Chromoting host binaries: 1. Build the Chromoting host binaries:
```shell ```shell
$ ninja -C out/Release remoting_me2me_host remoting_start_host \ $ autoninja -C out/Release remoting_me2me_host remoting_start_host \
remoting_native_messaging_host remoting_native_messaging_manifests remoting_native_messaging_host remoting_native_messaging_manifests
``` ```
(`autoninja` is a wrapper that automatically provides optimal values for the
arguments passed to `ninja`.)
1. When the build finishes, move into the installer directory: 1. When the build finishes, move into the installer directory:
`$ cd remoting/host/installer/` `$ cd remoting/host/installer/`
1. Generate a DEB package for your system's package manager: 1. Generate a DEB package for your system's package manager:
@ -89,7 +92,7 @@ as an extension.
```shell ```shell
$ GOOGLE_CLIENT_ID_REMOTING_IDENTITY_API=<client id> \ $ GOOGLE_CLIENT_ID_REMOTING_IDENTITY_API=<client id> \
ninja -C out/Release remoting_webapp autoninja -C out/Release remoting_webapp
``` ```
1. Install the extension into your Chromium (or Chrome) browser: 1. Install the extension into your Chromium (or Chrome) browser:
@ -114,7 +117,7 @@ source because no official version is being distributed.
https://www.chromium.org/developers/how-tos/android-build-instructions https://www.chromium.org/developers/how-tos/android-build-instructions
1. Move into the `src/` directory that contains your checkout of the Chromium 1. Move into the `src/` directory that contains your checkout of the Chromium
code. code.
1. Build the Android app: `$ ninja -C out/Release remoting_apk` 1. Build the Android app: `$ autoninja -C out/Release remoting_apk`
1. Connect your device and set up USB debugging: 1. Connect your device and set up USB debugging:
1. Plug your device in via USB. 1. Plug your device in via USB.
1. Open the Settings app and look for the `Developer options` choice. 1. Open the Settings app and look for the `Developer options` choice.