| OLD | NEW |
| 1 // Copyright 2015 The Crashpad Authors. All rights reserved. | 1 // Copyright 2015 The Crashpad Authors. All rights reserved. |
| 2 // | 2 // |
| 3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
| 5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
| 6 // | 6 // |
| 7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
| 8 // | 8 // |
| 9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
| 10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
| (...skipping 65 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 76 | 76 |
| 77 [subs="verbatim,quotes"] | 77 [subs="verbatim,quotes"] |
| 78 ---- | 78 ---- |
| 79 $ *cd ~/crashpad/crashpad* | 79 $ *cd ~/crashpad/crashpad* |
| 80 $ *git pull -r* | 80 $ *git pull -r* |
| 81 $ *gclient sync* | 81 $ *gclient sync* |
| 82 ---- | 82 ---- |
| 83 | 83 |
| 84 == Building | 84 == Building |
| 85 | 85 |
| 86 Crashpad uses https://gyp.googlecode.com/[GYP] to generate | 86 Crashpad uses https://gyp.gsrc.io/[GYP] to generate |
| 87 https://martine.github.io/ninja/[Ninja] build files. The build is described by | 87 https://martine.github.io/ninja/[Ninja] build files. The build is described by |
| 88 `.gyp` files throughout the Crashpad source code tree. The | 88 `.gyp` files throughout the Crashpad source code tree. The |
| 89 `build/gyp_crashpad.py` script runs GYP properly for Crashpad, and is also | 89 `build/gyp_crashpad.py` script runs GYP properly for Crashpad, and is also |
| 90 called when you run `fetch crashpad`, `gclient sync`, or `gclient runhooks`. | 90 called when you run `fetch crashpad`, `gclient sync`, or `gclient runhooks`. |
| 91 | 91 |
| 92 The Ninja build files and build output are in the `out` directory. Both debug- | 92 The Ninja build files and build output are in the `out` directory. Both debug- |
| 93 and release-mode configurations are available. The examples below show the debug | 93 and release-mode configurations are available. The examples below show the debug |
| 94 configuration. To build and test the release configuration, substitute `Release` | 94 configuration. To build and test the release configuration, substitute `Release` |
| 95 for `Debug`. | 95 for `Debug`. |
| 96 | 96 |
| 97 [subs="verbatim,quotes"] | 97 [subs="verbatim,quotes"] |
| 98 ---- | 98 ---- |
| 99 $ *cd ~/crashpad/crashpad* | 99 $ *cd ~/crashpad/crashpad* |
| 100 $ *ninja -C out/Debug* | 100 $ *ninja -C out/Debug* |
| 101 ---- | 101 ---- |
| 102 | 102 |
| 103 Ninja is part of the | 103 Ninja is part of the |
| 104 https://dev.chromium.org/developers/how-tos/depottools[depot_tools]. There’s no | 104 https://dev.chromium.org/developers/how-tos/depottools[depot_tools]. There’s no |
| 105 need to install it separately. | 105 need to install it separately. |
| 106 | 106 |
| 107 == Testing | 107 == Testing |
| 108 | 108 |
| 109 Crashpad uses https://googletest.googlecode.com/[Google Test] as its | 109 Crashpad uses https://github.com/google/googletest/[Google Test] as its |
| 110 unit-testing framework, and some tests use | 110 unit-testing framework, and some tests use |
| 111 https://googlemock.googlecode.com/[Google Mock] as well. Its tests are currently | 111 https://github.com/google/googletest/tree/master/googlemock/[Google Mock] as |
| 112 split up into several test executables, each dedicated to testing a different | 112 well. Its tests are currently split up into several test executables, each |
| 113 component. This may change in the future. After a successful build, the test | 113 dedicated to testing a different component. This may change in the future. After |
| 114 executables will be found at `out/Debug/crashpad_*_test`. | 114 a successful build, the test executables will be found at |
| 115 `out/Debug/crashpad_*_test`. |
| 115 | 116 |
| 116 [subs="verbatim,quotes"] | 117 [subs="verbatim,quotes"] |
| 117 ---- | 118 ---- |
| 118 $ *cd ~/crashpad/crashpad* | 119 $ *cd ~/crashpad/crashpad* |
| 119 $ *out/Debug/crashpad_minidump_test* | 120 $ *out/Debug/crashpad_minidump_test* |
| 120 $ *out/Debug/crashpad_util_test* | 121 $ *out/Debug/crashpad_util_test* |
| 121 ---- | 122 ---- |
| 122 | 123 |
| 123 A script is provided to run all of Crashpad’s tests. It accepts a single | 124 A script is provided to run all of Crashpad’s tests. It accepts a single |
| 124 argument that tells it which configuration to test. | 125 argument that tells it which configuration to test. |
| (...skipping 81 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 206 License Agreement] as appropriate before any submission can be accepted, and | 207 License Agreement] as appropriate before any submission can be accepted, and |
| 207 must be listed in the `AUTHORS` file. Contributors may be listed in the | 208 must be listed in the `AUTHORS` file. Contributors may be listed in the |
| 208 `CONTRIBUTORS` file. | 209 `CONTRIBUTORS` file. |
| 209 | 210 |
| 210 == Buildbot | 211 == Buildbot |
| 211 | 212 |
| 212 The https://build.chromium.org/p/client.crashpad/[Crashpad Buildbot] performs | 213 The https://build.chromium.org/p/client.crashpad/[Crashpad Buildbot] performs |
| 213 automated builds and tests of Crashpad. Before checking out or updating the | 214 automated builds and tests of Crashpad. Before checking out or updating the |
| 214 Crashpad source code, and after checking in a new change, it is prudent to check | 215 Crashpad source code, and after checking in a new change, it is prudent to check |
| 215 the Buildbot to ensure that “the tree is green.” | 216 the Buildbot to ensure that “the tree is green.” |
| OLD | NEW |