Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 8584edae205cb7f7b7652e72000f057281af161c / . / BlissRoms / build-tips / index.html
blob: f1b70d095c30a23f16b963164abf2524a28384dc [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">
35 <meta name="generator" content="mkdocs-1.0.4, mkdocs-material-4.4.0">
36
37
38
39 <title>Build Tips - Team Bliss</title>
40
41
42
43 <link rel="stylesheet" href="../../assets/stylesheets/application.0284f74d.css">
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
148 <main class="md-main">
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">
341 <a href="#repo-optimization-tips" title="repo optimization tips" class="md-nav__link">
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">
349 <a href="#threads" title="Threads" class="md-nav__link">
350 Threads
351 </a>
352
353</li>
354
355 <li class="md-nav__item">
356 <a href="#current-history-only" title="Current history only" class="md-nav__link">
357 Current history only
358 </a>
359
360</li>
361
362 <li class="md-nav__item">
363 <a href="#force" title="Force" class="md-nav__link">
364 Force
365 </a>
366
367</li>
368
369 <li class="md-nav__item">
370 <a href="#minimal-fetch" title="Minimal fetch" class="md-nav__link">
371 Minimal fetch
372 </a>
373
374</li>
375
376 <li class="md-nav__item">
377 <a href="#putting-it-all-together" title="Putting it all together" class="md-nav__link">
378 Putting it all together
379 </a>
380
381</li>
382
383 </ul>
384 </nav>
385
386</li>
387
388 <li class="md-nav__item">
389 <a href="#reset-tree" title="Reset tree" class="md-nav__link">
390 Reset tree
391 </a>
392
393</li>
394
395 <li class="md-nav__item">
396 <a href="#github-cherry-pick" title="GitHub cherry-pick" class="md-nav__link">
397 GitHub cherry-pick
398 </a>
399
400</li>
401
402 <li class="md-nav__item">
403 <a href="#make-and-go-inside" title="Make and go inside" class="md-nav__link">
404 Make and go inside
405 </a>
406
407</li>
408
409
410
411
412
413 </ul>
414
415</nav>
416
417 </li>
418
419
420 </ul>
421 </nav>
422 </li>
423
424
425
426
427
428
429
430 <li class="md-nav__item md-nav__item--nested">
431
432 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
433
434 <label class="md-nav__link" for="nav-4">
435 Common
436 </label>
437 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
438 <label class="md-nav__title" for="nav-4">
439 Common
440 </label>
441 <ul class="md-nav__list" data-md-scrollfix>
442
443
444
445
446
447
448
449 <li class="md-nav__item">
450 <a href="../../common/" title="Index" class="md-nav__link">
451 Index
452 </a>
453 </li>
454
455
456
457
458
459
460
461 <li class="md-nav__item">
462 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
463 Git Started
464 </a>
465 </li>
466
467
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]468
469
470
471
472
473 <li class="md-nav__item">
Eric Park8584eda2019-09-02 09:45:55 +0800[diff] [blame^]474 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
475 Maintaining proper authorship
476 </a>
477 </li>
478
479
480
481
482
483
484
485 <li class="md-nav__item">
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]486 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
487 Using `dippy-bird`
488 </a>
489 </li>
490
491
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]492 </ul>
493 </nav>
494 </li>
495
496
497
498
499
500
501
502 <li class="md-nav__item md-nav__item--nested">
503
504 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
505
506 <label class="md-nav__link" for="nav-5">
507 Infrastructure
508 </label>
509 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
510 <label class="md-nav__title" for="nav-5">
511 Infrastructure
512 </label>
513 <ul class="md-nav__list" data-md-scrollfix>
514
515
516
517
518
519
520
521 <li class="md-nav__item">
522 <a href="../../infrastructure/" title="Index" class="md-nav__link">
523 Index
524 </a>
525 </li>
526
527
528 </ul>
529 </nav>
530 </li>
531
532
533 </ul>
534</nav>
535 </div>
536 </div>
537 </div>
538
539
540 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
541 <div class="md-sidebar__scrollwrap">
542 <div class="md-sidebar__inner">
543
544<nav class="md-nav md-nav--secondary">
545
546
547
548
549
550 <label class="md-nav__title" for="__toc">Table of contents</label>
551 <ul class="md-nav__list" data-md-scrollfix>
552
553 <li class="md-nav__item">
554 <a href="#repo-optimization-tips" title="repo optimization tips" class="md-nav__link">
555 repo optimization tips
556 </a>
557
558 <nav class="md-nav">
559 <ul class="md-nav__list">
560
561 <li class="md-nav__item">
562 <a href="#threads" title="Threads" class="md-nav__link">
563 Threads
564 </a>
565
566</li>
567
568 <li class="md-nav__item">
569 <a href="#current-history-only" title="Current history only" class="md-nav__link">
570 Current history only
571 </a>
572
573</li>
574
575 <li class="md-nav__item">
576 <a href="#force" title="Force" class="md-nav__link">
577 Force
578 </a>
579
580</li>
581
582 <li class="md-nav__item">
583 <a href="#minimal-fetch" title="Minimal fetch" class="md-nav__link">
584 Minimal fetch
585 </a>
586
587</li>
588
589 <li class="md-nav__item">
590 <a href="#putting-it-all-together" title="Putting it all together" class="md-nav__link">
591 Putting it all together
592 </a>
593
594</li>
595
596 </ul>
597 </nav>
598
599</li>
600
601 <li class="md-nav__item">
602 <a href="#reset-tree" title="Reset tree" class="md-nav__link">
603 Reset tree
604 </a>
605
606</li>
607
608 <li class="md-nav__item">
609 <a href="#github-cherry-pick" title="GitHub cherry-pick" class="md-nav__link">
610 GitHub cherry-pick
611 </a>
612
613</li>
614
615 <li class="md-nav__item">
616 <a href="#make-and-go-inside" title="Make and go inside" class="md-nav__link">
617 Make and go inside
618 </a>
619
620</li>
621
622
623
624
625
626 </ul>
627
628</nav>
629 </div>
630 </div>
631 </div>
632
633
634 <div class="md-content">
635 <article class="md-content__inner md-typeset">
636
637
638
639 <h1 id="build-tips">Build Tips</h1>
640<p>Here's a collective list of things you can try to improve your builds. Have fun!</p>
641<h2 id="repo-optimization-tips"><code>repo</code> optimization tips</h2>
642<h3 id="threads">Threads</h3>
643<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. So, for example, if you have 24 threads, you would type:</p>
644<pre><code>repo sync -j24
645</code></pre>
646<h3 id="current-history-only">Current history only</h3>
647<p>This should be set by default in your ROM manifest, but just in case, you can tell <code>repo</code> to only fetch recent changes. This allows for smaller downloads, which makes the sync quicker. Add the flag:</p>
648<pre><code>repo sync -c
649</code></pre>
650<h3 id="force">Force</h3>
651<p><strong>Warning! Dangerous option. Read before proceeding!</strong> Sometimes, your local history may go out of sync with remote repositories. This wouldn't be a problem if <code>repo</code> can handle it gracefully, but it doesn't and gives off a sync error. If you do not commit much, it may be worthwhile to add the force flags. Be warned though, <strong>any changes you make to the repositories WILL BE DELETED.</strong> Later down the line, if you commit a lot, you may want to remove this flag. To force sync, add the flag:</p>
652<pre><code>repo sync -f --force-sync
653</code></pre>
654<h3 id="minimal-fetch">Minimal fetch</h3>
655<p>To disable syncing clone bundles and tags, use:</p>
656<pre><code>repo sync --no-clone-bundle --no-tags
657</code></pre>
658<p>More documentation on this required, but for most developers these flags will be OK to use. This makes the sync faster as there is less information to sync over.</p>
659<h3 id="putting-it-all-together">Putting it all together</h3>
660<pre><code>repo sync -c -f -j24 --force-sync --no-clone-bundle --no-tags
661</code></pre>
662<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>
663<p>Open up <code>~/.bashrc</code> and add these lines:</p>
664<pre><code># Alias to sync
665alias reposync='repo sync -c -f -j24 --force-sync --no-clone-bundle --no-tags'
666</code></pre>
667<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>
668<h2 id="reset-tree">Reset tree</h2>
669<p><strong>Warning! Very destructive tip. Do not use if you don't know what you are doing!</strong></p>
670<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. However, you might have limited bandwidth, and might not want to download the source over again.</p>
671<p>Add this function to your <code>~/.bashrc</code>:</p>
672<pre><code># Script to clean the source
673function resettree() {
674 rm -rf device kernel vendor out .repo/local_manifests
675 reposync
676}
677</code></pre>
678<p>Let's go over what this does, word by word:</p>
679<ul>
680<li><code>rm -rf</code>: Destructive command to erase all of the following:</li>
681<li><code>device</code> folder: Holds all device-related files</li>
682<li><code>kernel</code> folder: Holds all kernel-related files for devices</li>
683<li><code>vendor</code> folder: Holds all vendor-related files for devices AND ROM-specific vendor customizations</li>
684<li><code>out</code> folder: Stores artifacts of builds</li>
685<li><code>.repo/local_manifests</code> folder: Stores "manifest" information of devices to sync.</li>
686<li><code>reposync</code>: Executes the <code>repo sync</code> alias we made earlier.</li>
687</ul>
688<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>
689<p>To use this, after copying, don't forget to <code>source ~/.bashrc</code>. Then, run <code>resettree</code> at the base folder of the source code. Once you're done, don't forget to initialize a new device using <code>breakfast &lt;devicename&gt;</code>.</p>
690<h2 id="github-cherry-pick">GitHub cherry-pick</h2>
691<p>Thanks to @blueyes for providing the script!</p>
692<p>Copy the following into your <code>~/.bashrc</code>:</p>
693<pre><code>function gcp() {
694 COMMIT=`echo "$1" | cut -d/ -f6`
695 GH=`echo "$1" | cut -d/ -f1-3`
696 if [ "$COMMIT" != "commit" ]; then
697 echo -e "Please use a commit URL."
698 elif [ "$GH" != "https://github.com" ]; then
699 echo -e "Please use an https://github.com/ URL."
700 else
701 PROJECT=`echo "$1" | cut -d/ -f1-5`
702 git fetch $PROJECT
703 CP=`echo "$1" | cut -d/ -f7`
704 git cherry-pick $CP
705 fi
706}
707</code></pre>
708<p>To use this, <code>source ~/.bashrc</code> and then run <code>gcp &lt;GitHub commit URL here&gt;</code>.</p>
709<h2 id="make-and-go-inside">Make and go inside</h2>
710<p>This is a quick way to create and go inside a folder. Once again, copy this to your <code>~/.bashrc</code>:</p>
711<pre><code>function mkcdir ()
712{
713 mkdir -p -- "$1" &amp;&amp;
714 cd -P -- "$1"
715}
716</code></pre>
717<p>Don't forget to <code>source</code>, and run <code>mkcdir &lt;directory name&gt;</code>.</p>
718
719
720
721
722
723
724
725
726
727 </article>
728 </div>
729 </div>
730 </main>
731
732
733<footer class="md-footer">
734
735 <div class="md-footer-nav">
736 <nav class="md-footer-nav__inner md-grid">
737
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]738 <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]739 <div class="md-flex__cell md-flex__cell--shrink">
740 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
741 </div>
742 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
743 <span class="md-flex__ellipsis">
744 <span class="md-footer-nav__direction">
745 Previous
746 </span>
Eric Park608ce5a2019-08-07 21:27:46 +0800[diff] [blame]747 Build Guide
Eric Parkc9931992019-07-29 13:10:53 +0900[diff] [blame]748 </span>
749 </div>
750 </a>
751
752
753 <a href="../../common/" title="Index" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
754 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
755 <span class="md-flex__ellipsis">
756 <span class="md-footer-nav__direction">
757 Next
758 </span>
759 Index
760 </span>
761 </div>
762 <div class="md-flex__cell md-flex__cell--shrink">
763 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
764 </div>
765 </a>
766
767 </nav>
768 </div>
769
770 <div class="md-footer-meta md-typeset">
771 <div class="md-footer-meta__inner md-grid">
772 <div class="md-footer-copyright">
773
774 powered by
775 <a href="https://www.mkdocs.org">MkDocs</a>
776 and
777 <a href="https://squidfunk.github.io/mkdocs-material/">
778 Material for MkDocs</a>
779 </div>
780
781 </div>
782 </div>
783</footer>
784
785 </div>
786
787 <script src="../../assets/javascripts/application.245445c6.js"></script>
788
789 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
790
791
792 </body>
793</html>