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 |