Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 30fb8399ae4737dfa1043a99c4b8092a844123c1 / . / BlissRoms / build-tips / index.html
blob: 52d7837c46645185aa780a89684d0182e7e791ae [file] [log] [blame]
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]1
2
3
4
5<!doctype html>
6<html lang="en" class="no-js">
7 <head>
8
9 <meta charset="utf-8">
10 <meta name="viewport" content="width=device-width,initial-scale=1">
11 <meta http-equiv="x-ua-compatible" content="ie=edge">
12
13
14
15
16 <meta name="lang:clipboard.copy" content="Copy to clipboard">
17
18 <meta name="lang:clipboard.copied" content="Copied to clipboard">
19
20 <meta name="lang:search.language" content="en">
21
22 <meta name="lang:search.pipeline.stopwords" content="True">
23
24 <meta name="lang:search.pipeline.trimmer" content="True">
25
26 <meta name="lang:search.result.none" content="No matching documents">
27
28 <meta name="lang:search.result.one" content="1 matching document">
29
30 <meta name="lang:search.result.other" content="# matching documents">
31
32 <meta name="lang:search.tokenizer" content="[\s\-]+">
33
34 <link rel="shortcut icon" href="../../assets/images/favicon.png">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.3">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]36
37
38
39 <title>Build Tips - Team Bliss</title>
40
41
42
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]43 <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.css">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]44
45
46
47
48 <script src="../../assets/javascripts/modernizr.74668098.js"></script>
49
50
51
52 <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
53 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700|Roboto+Mono&display=fallback">
54 <style>body,input{font-family:"Roboto","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono","Courier New",Courier,monospace}</style>
55
56
57 <link rel="stylesheet" href="../../assets/fonts/material-icons.css">
58
59
60
61
62
63
64 </head>
65
66 <body dir="ltr">
67
68 <svg class="md-svg">
69 <defs>
70
71
72 </defs>
73 </svg>
74 <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
75 <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
76 <label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
77
78 <a href="#build-tips" tabindex="1" class="md-skip">
79 Skip to content
80 </a>
81
82
83 <header class="md-header" data-md-component="header">
84 <nav class="md-header-nav md-grid">
85 <div class="md-flex">
86 <div class="md-flex__cell md-flex__cell--shrink">
87 <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo">
88
89 <i class="md-icon"></i>
90
91 </a>
92 </div>
93 <div class="md-flex__cell md-flex__cell--shrink">
94 <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
95 </div>
96 <div class="md-flex__cell md-flex__cell--stretch">
97 <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
98
99 <span class="md-header-nav__topic">
100 Team Bliss
101 </span>
102 <span class="md-header-nav__topic">
103
104 Build Tips
105
106 </span>
107
108 </div>
109 </div>
110 <div class="md-flex__cell md-flex__cell--shrink">
111
112 <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
113
114<div class="md-search" data-md-component="search" role="dialog">
115 <label class="md-search__overlay" for="__search"></label>
116 <div class="md-search__inner" role="search">
117 <form class="md-search__form" name="search">
118 <input type="text" class="md-search__input" name="query" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
119 <label class="md-icon md-search__icon" for="__search"></label>
120 <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
121 &#xE5CD;
122 </button>
123 </form>
124 <div class="md-search__output">
125 <div class="md-search__scrollwrap" data-md-scrollfix>
126 <div class="md-search-result" data-md-component="result">
127 <div class="md-search-result__meta">
128 Type to start searching
129 </div>
130 <ol class="md-search-result__list"></ol>
131 </div>
132 </div>
133 </div>
134 </div>
135</div>
136
137 </div>
138
139 </div>
140 </nav>
141</header>
142
143 <div class="md-container">
144
145
146
147
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]148 <main class="md-main" role="main">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]149 <div class="md-main__inner md-grid" data-md-component="container">
150
151
152 <div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
153 <div class="md-sidebar__scrollwrap">
154 <div class="md-sidebar__inner">
155 <nav class="md-nav md-nav--primary" data-md-level="0">
156 <label class="md-nav__title md-nav__title--site" for="__drawer">
157 <a href="../.." title="Team Bliss" class="md-nav__button md-logo">
158
159 <i class="md-icon"></i>
160
161 </a>
162 Team Bliss
163 </label>
164
165 <ul class="md-nav__list" data-md-scrollfix>
166
167
168
169
170
171
172 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]173 <a href="../.." title="Home" class="md-nav__link">
174 Home
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]175 </a>
176 </li>
177
178
179
180
181
182
183
184 <li class="md-nav__item md-nav__item--nested">
185
186 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2">
187
188 <label class="md-nav__link" for="nav-2">
189 Bliss OS
190 </label>
191 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
192 <label class="md-nav__title" for="nav-2">
193 Bliss OS
194 </label>
195 <ul class="md-nav__list" data-md-scrollfix>
196
197
198
199
200
201
202
203 <li class="md-nav__item">
204 <a href="../../Bliss OS/" title="Index" class="md-nav__link">
205 Index
206 </a>
207 </li>
208
209
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]210
211
212
213
214
215 <li class="md-nav__item">
Eric Park5e3a1012019-08-12 13:17:03 +0800[diff] [blame]216 <a href="../../Bliss OS/build-guide/" title="Build Guide" class="md-nav__link">
217 Build Guide
218 </a>
219 </li>
220
221
222
223
224
225
226
227 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]228 <a href="../../Bliss OS/extras/" title="Extras" class="md-nav__link">
229 Extras
230 </a>
231 </li>
232
233
234
235
236
237
238
239 <li class="md-nav__item">
240 <a href="../../Bliss OS/installation-guide/" title="Installation Guide" class="md-nav__link">
241 Installation Guide
242 </a>
243 </li>
244
245
246
247
248
249
250
251 <li class="md-nav__item">
252 <a href="../../Bliss OS/troubleshooting/" title="Troubleshooting" class="md-nav__link">
253 Troubleshooting
254 </a>
255 </li>
256
257
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]258 </ul>
259 </nav>
260 </li>
261
262
263
264
265
266
267
268
269
270 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
271
272 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3" checked>
273
274 <label class="md-nav__link" for="nav-3">
275 BlissRoms
276 </label>
277 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
278 <label class="md-nav__title" for="nav-3">
279 BlissRoms
280 </label>
281 <ul class="md-nav__list" data-md-scrollfix>
282
283
284
285
286
287
288
289 <li class="md-nav__item">
290 <a href="../" title="Index" class="md-nav__link">
291 Index
292 </a>
293 </li>
294
295
296
297
298
299
300
301 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]302 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
303 Build Guide
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]304 </a>
305 </li>
306
307
308
309
310
311
312
313
314
315 <li class="md-nav__item md-nav__item--active">
316
317 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
318
319
320
321
322 <label class="md-nav__link md-nav__link--active" for="__toc">
323 Build Tips
324 </label>
325
326 <a href="./" title="Build Tips" class="md-nav__link md-nav__link--active">
327 Build Tips
328 </a>
329
330
331<nav class="md-nav md-nav--secondary">
332
333
334
335
336
337 <label class="md-nav__title" for="__toc">Table of contents</label>
338 <ul class="md-nav__list" data-md-scrollfix>
339
340 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]341 <a href="#repo-optimization-tips" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]342 repo optimization tips
343 </a>
344
345 <nav class="md-nav">
346 <ul class="md-nav__list">
347
348 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]349 <a href="#threads" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]350 Threads
351 </a>
352
353</li>
354
355 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]356 <a href="#current-branch-only" class="md-nav__link">
357 Current branch only
358 </a>
359
360</li>
361
362 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]363 <a href="#current-history-only" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]364 Current history only
365 </a>
366
367</li>
368
369 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]370 <a href="#minimal-fetch" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]371 Minimal fetch
372 </a>
373
374</li>
375
376 <li class="md-nav__item">
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]377 <a href="#force-sync" class="md-nav__link">
378 Force sync
379 </a>
380
381 <nav class="md-nav">
382 <ul class="md-nav__list">
383
384 <li class="md-nav__item">
385 <a href="#why-not-use-f-as-well" class="md-nav__link">
386 Why not use -f as well?
387 </a>
388
389</li>
390
391 </ul>
392 </nav>
393
394</li>
395
396 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]397 <a href="#reposync-alias" class="md-nav__link">
398 reposync alias
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]399 </a>
400
401</li>
402
403 </ul>
404 </nav>
405
406</li>
407
408 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]409 <a href="#delete-all-device-trees-and-local-manifests" class="md-nav__link">
410 Delete all device trees and local manifests
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]411 </a>
412
413</li>
414
415 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]416 <a href="#github-cherry-pick" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]417 GitHub cherry-pick
418 </a>
419
420</li>
421
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]422
423
424
425
426 </ul>
427
428</nav>
429
430 </li>
431
432
433 </ul>
434 </nav>
435 </li>
436
437
438
439
440
441
442
443 <li class="md-nav__item md-nav__item--nested">
444
445 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
446
447 <label class="md-nav__link" for="nav-4">
448 Common
449 </label>
450 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
451 <label class="md-nav__title" for="nav-4">
452 Common
453 </label>
454 <ul class="md-nav__list" data-md-scrollfix>
455
456
457
458
459
460
461
462 <li class="md-nav__item">
463 <a href="../../common/" title="Index" class="md-nav__link">
464 Index
465 </a>
466 </li>
467
468
469
470
471
472
473
474 <li class="md-nav__item">
475 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
476 Git Started
477 </a>
478 </li>
479
480
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]481
482
483
484
485
486 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame]487 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
488 Maintaining proper authorship
489 </a>
490 </li>
491
492
493
494
495
496
497
498 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]499 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
500 Using `dippy-bird`
501 </a>
502 </li>
503
504
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]505 </ul>
506 </nav>
507 </li>
508
509
510
511
512
513
514
515 <li class="md-nav__item md-nav__item--nested">
516
517 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
518
519 <label class="md-nav__link" for="nav-5">
520 Infrastructure
521 </label>
522 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
523 <label class="md-nav__title" for="nav-5">
524 Infrastructure
525 </label>
526 <ul class="md-nav__list" data-md-scrollfix>
527
528
529
530
531
532
533
534 <li class="md-nav__item">
535 <a href="../../infrastructure/" title="Index" class="md-nav__link">
536 Index
537 </a>
538 </li>
539
540
541 </ul>
542 </nav>
543 </li>
544
545
546 </ul>
547</nav>
548 </div>
549 </div>
550 </div>
551
552
553 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
554 <div class="md-sidebar__scrollwrap">
555 <div class="md-sidebar__inner">
556
557<nav class="md-nav md-nav--secondary">
558
559
560
561
562
563 <label class="md-nav__title" for="__toc">Table of contents</label>
564 <ul class="md-nav__list" data-md-scrollfix>
565
566 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]567 <a href="#repo-optimization-tips" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]568 repo optimization tips
569 </a>
570
571 <nav class="md-nav">
572 <ul class="md-nav__list">
573
574 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]575 <a href="#threads" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]576 Threads
577 </a>
578
579</li>
580
581 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]582 <a href="#current-branch-only" class="md-nav__link">
583 Current branch only
584 </a>
585
586</li>
587
588 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]589 <a href="#current-history-only" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]590 Current history only
591 </a>
592
593</li>
594
595 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]596 <a href="#minimal-fetch" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]597 Minimal fetch
598 </a>
599
600</li>
601
602 <li class="md-nav__item">
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]603 <a href="#force-sync" class="md-nav__link">
604 Force sync
605 </a>
606
607 <nav class="md-nav">
608 <ul class="md-nav__list">
609
610 <li class="md-nav__item">
611 <a href="#why-not-use-f-as-well" class="md-nav__link">
612 Why not use -f as well?
613 </a>
614
615</li>
616
617 </ul>
618 </nav>
619
620</li>
621
622 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]623 <a href="#reposync-alias" class="md-nav__link">
624 reposync alias
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]625 </a>
626
627</li>
628
629 </ul>
630 </nav>
631
632</li>
633
634 <li class="md-nav__item">
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]635 <a href="#delete-all-device-trees-and-local-manifests" class="md-nav__link">
636 Delete all device trees and local manifests
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]637 </a>
638
639</li>
640
641 <li class="md-nav__item">
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]642 <a href="#github-cherry-pick" class="md-nav__link">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]643 GitHub cherry-pick
644 </a>
645
646</li>
647
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]648
649
650
651
652 </ul>
653
654</nav>
655 </div>
656 </div>
657 </div>
658
659
660 <div class="md-content">
661 <article class="md-content__inner md-typeset">
662
663
664
665 <h1 id="build-tips">Build Tips</h1>
666<p>Here's a collective list of things you can try to improve your builds. Have fun!</p>
667<h2 id="repo-optimization-tips"><code>repo</code> optimization tips</h2>
668<h3 id="threads">Threads</h3>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]669<p>By default, <code>repo</code> only utilizes four threads (or whatever the ROM manifest declares.) If you have a stronger machine with more threads, you can increase this number. For example, to use 8 threads:</p>
670<pre><code>repo sync -j8
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]671</code></pre>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]672<p>To use all of the threads on your machine, use:</p>
673<pre><code>repo sync -j$(nproc --all)
674</code></pre>
675<h3 id="current-branch-only">Current branch only</h3>
676<p>This is usually set by default in your ROM manifest, but just in case, you can tell <code>repo</code> to only fetch the branch you want to work on:</p>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]677<pre><code>repo sync -c
678</code></pre>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]679<h3 id="current-history-only">Current history only</h3>
680<p>To only download the most recent changes, use this flag:</p>
681<pre><code>repo sync --depth=1
682</code></pre>
683<p>This will make <code>repo</code> fetch the most recent changes.</p>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]684<h3 id="minimal-fetch">Minimal fetch</h3>
685<p>To disable syncing clone bundles and tags, use:</p>
686<pre><code>repo sync --no-clone-bundle --no-tags
687</code></pre>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]688<p><code>repo</code> uses <code>git</code> bundles over HTTP to download repositories. To disable this behavior, we use the <code>--no-clone-bundle</code> flag. We also don't need all of the <code>git</code> tags in each repository, so we disable that too with <code>--no-tags</code>.</p>
Eric Parkf7befcf2020-01-17 07:17:51 +0800[diff] [blame]689<h3 id="force-sync">Force sync</h3>
690<p>Sometimes, bad Internet conditions may cause your <code>.repo</code> directory to become corrupt and not sync. <code>repo</code> keeps two copies of a repository - one under <code>.repo</code>, and one in the root of your source directory. If the repository in <code>.repo</code> is corrupted, it will not sync over to the source directory.</p>
691<p>To resolve this problem, you need to sometimes tell <code>repo</code> to forcefully sync the repository in <code>.repo</code> again with the remote repository so that changes can be synced over to the main source tree. Use the <code>--force-sync</code> flag to achieve this:</p>
692<pre><code>repo sync --force-sync
693</code></pre>
694<h4 id="why-not-use-f-as-well">Why not use <code>-f</code> as well?</h4>
695<p>Starting from <code>repo</code> 1.26, the use of the flags <code>-f</code> and <code>--force-sync</code> together has been deprecated. <code>repo</code> will warn you of this change if you try and use those two flags together. To make sure your scripts do not break in future <code>repo</code> versions, it is recommended to not use the <code>-f</code> flag at all.</p>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]696<h3 id="reposync-alias"><code>reposync</code> alias</h3>
697<pre><code>repo sync -c -j$(nproc --all) --no-clone-bundle --no-tags
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]698</code></pre>
699<p>That's quite long! How about we add this to our <code>.bashrc</code> as a alias? That way, we only have to type one phrase for <code>bash</code> to automatically type that out for us.</p>
700<p>Open up <code>~/.bashrc</code> and add these lines:</p>
701<pre><code># Alias to sync
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]702alias reposync='repo sync -c -j$(nproc --all) --no-clone-bundle --no-tags'
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]703</code></pre>
704<p>This way, next time you want to sync, just type <code>reposync</code> and <code>bash</code> will substitute the command for you. Easy! Just don't forget to <code>source ~/.bashrc</code> otherwise <code>bash</code> will not know of this new alias.</p>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]705<h2 id="delete-all-device-trees-and-local-manifests">Delete all device trees and local manifests</h2>
706<p><strong>WARNING</strong>: If you have any changes in your device trees, commit them and push them to a remote repository. This tip will permanently delete your local changes, so back them up!</p>
707<p>While messing around with device specific folders, you may break something and the build process might not work. Or, you may have multiple devices synced and you want to delete it all and start over. This tip/command will let you delete only the device trees.</p>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]708<p>Add this function to your <code>~/.bashrc</code>:</p>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]709<pre><code># Remove all device trees/local manifests
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]710function resettree() {
711 rm -rf device kernel vendor out .repo/local_manifests
712 reposync
713}
714</code></pre>
715<p>Let's go over what this does, word by word:</p>
716<ul>
717<li><code>rm -rf</code>: Destructive command to erase all of the following:</li>
718<li><code>device</code> folder: Holds all device-related files</li>
719<li><code>kernel</code> folder: Holds all kernel-related files for devices</li>
720<li><code>vendor</code> folder: Holds all vendor-related files for devices AND ROM-specific vendor customizations</li>
721<li><code>out</code> folder: Stores artifacts of builds</li>
722<li><code>.repo/local_manifests</code> folder: Stores "manifest" information of devices to sync.</li>
723<li><code>reposync</code>: Executes the <code>repo sync</code> alias we made earlier.</li>
724</ul>
725<p>The last line is important, because by deleting the <code>vendor</code> folder, we also delete some crucial files for building Bliss. To fix that, we rerun a sync. Note that because we did not delete any other folders, syncing and updating files only take a fraction of a time compared to starting from scratch.</p>
Eric Parkf1180122019-12-28 17:11:20 +0900[diff] [blame]726<p>After running <code>resettree</code>, make sure to initialize a new tree by running <code>breakfast &lt;devicename&gt;</code>.</p>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]727<h2 id="github-cherry-pick">GitHub cherry-pick</h2>
728<p>Thanks to @blueyes for providing the script!</p>
729<p>Copy the following into your <code>~/.bashrc</code>:</p>
730<pre><code>function gcp() {
731 COMMIT=`echo "$1" | cut -d/ -f6`
732 GH=`echo "$1" | cut -d/ -f1-3`
733 if [ "$COMMIT" != "commit" ]; then
734 echo -e "Please use a commit URL."
735 elif [ "$GH" != "https://github.com" ]; then
736 echo -e "Please use an https://github.com/ URL."
737 else
738 PROJECT=`echo "$1" | cut -d/ -f1-5`
739 git fetch $PROJECT
740 CP=`echo "$1" | cut -d/ -f7`
741 git cherry-pick $CP
742 fi
743}
744</code></pre>
745<p>To use this, <code>source ~/.bashrc</code> and then run <code>gcp &lt;GitHub commit URL here&gt;</code>.</p>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]746
747
748
749
750
751
752
753
754
755 </article>
756 </div>
757 </div>
758 </main>
759
760
761<footer class="md-footer">
762
763 <div class="md-footer-nav">
764 <nav class="md-footer-nav__inner md-grid">
765
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]766 <a href="../build-guide/" title="Build Guide" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]767 <div class="md-flex__cell md-flex__cell--shrink">
768 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
769 </div>
770 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
771 <span class="md-flex__ellipsis">
772 <span class="md-footer-nav__direction">
773 Previous
774 </span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]775 Build Guide
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]776 </span>
777 </div>
778 </a>
779
780
781 <a href="../../common/" title="Index" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
782 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
783 <span class="md-flex__ellipsis">
784 <span class="md-footer-nav__direction">
785 Next
786 </span>
787 Index
788 </span>
789 </div>
790 <div class="md-flex__cell md-flex__cell--shrink">
791 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
792 </div>
793 </a>
794
795 </nav>
796 </div>
797
798 <div class="md-footer-meta md-typeset">
799 <div class="md-footer-meta__inner md-grid">
800 <div class="md-footer-copyright">
801
802 powered by
803 <a href="https://www.mkdocs.org">MkDocs</a>
804 and
805 <a href="https://squidfunk.github.io/mkdocs-material/">
806 Material for MkDocs</a>
807 </div>
808
809 </div>
810 </div>
811</footer>
812
813 </div>
814
Eric Park45174ca2019-10-21 01:38:33 +0800[diff] [blame]815 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]816
817 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
818
819
820 </body>
821</html>