Gitiles
Code Review Sign In
review.blissroms.org / Documentation-release / 0509f659f77e5d471e3877c47481b06dd5d72180 / . / Bliss OS / taking-bug-reports / index.html
blob: c95ada09dce594ae32701367cb5af19dff1ab613 [file] [log] [blame]
Eric Park0509f652020-03-01 01:54:39 +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.3">
36
37
38
39 <title>Taking bug reports - Team Bliss</title>
40
41
42
43 <link rel="stylesheet" href="../../assets/stylesheets/application.30686662.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="#taking-bug-reports" 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 Taking bug reports
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" role="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">
173 <a href="../.." title="Home" class="md-nav__link">
174 Home
175 </a>
176 </li>
177
178
179
180
181
182
183
184
185
186 <li class="md-nav__item md-nav__item--active md-nav__item--nested">
187
188 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked>
189
190 <label class="md-nav__link" for="nav-2">
191 Bliss OS
192 </label>
193 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
194 <label class="md-nav__title" for="nav-2">
195 Bliss OS
196 </label>
197 <ul class="md-nav__list" data-md-scrollfix>
198
199
200
201
202
203
204
205 <li class="md-nav__item">
206 <a href="../" title="Index" class="md-nav__link">
207 Index
208 </a>
209 </li>
210
211
212
213
214
215
216
217 <li class="md-nav__item">
218 <a href="../build-guide/" title="Build Guide" class="md-nav__link">
219 Build Guide
220 </a>
221 </li>
222
223
224
225
226
227
228
229 <li class="md-nav__item">
230 <a href="../extras/" title="Extras" class="md-nav__link">
231 Extras
232 </a>
233 </li>
234
235
236
237
238
239
240
241 <li class="md-nav__item">
242 <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link">
243 Installation Guide (Misc)
244 </a>
245 </li>
246
247
248
249
250
251
252
253 <li class="md-nav__item">
254 <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link">
255 Installation Guide (Surface devices)
256 </a>
257 </li>
258
259
260
261
262
263
264
265 <li class="md-nav__item">
266 <a href="../installation-guide/" title="Installation Guide" class="md-nav__link">
267 Installation Guide
268 </a>
269 </li>
270
271
272
273
274
275
276
277
278
279 <li class="md-nav__item md-nav__item--active">
280
281 <input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
282
283
284
285
286 <label class="md-nav__link md-nav__link--active" for="__toc">
287 Taking bug reports
288 </label>
289
290 <a href="./" title="Taking bug reports" class="md-nav__link md-nav__link--active">
291 Taking bug reports
292 </a>
293
294
295<nav class="md-nav md-nav--secondary">
296
297
298
299
300
301 <label class="md-nav__title" for="__toc">Table of contents</label>
302 <ul class="md-nav__list" data-md-scrollfix>
303
304 <li class="md-nav__item">
305 <a href="#what-information-is-required" class="md-nav__link">
306 What information is required?
307 </a>
308
309</li>
310
311 <li class="md-nav__item">
312 <a href="#capturing-logcat" class="md-nav__link">
313 Capturing logcat
314 </a>
315
316</li>
317
318 <li class="md-nav__item">
319 <a href="#drivers" class="md-nav__link">
320 Drivers
321 </a>
322
323</li>
324
325 <li class="md-nav__item">
326 <a href="#im-done-where-should-i-send-this-to" class="md-nav__link">
327 I'm done, where should I send this to?
328 </a>
329
330</li>
331
332
333
334
335
336 </ul>
337
338</nav>
339
340 </li>
341
342
343
344
345
346
347
348 <li class="md-nav__item">
349 <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link">
350 Troubleshooting
351 </a>
352 </li>
353
354
355 </ul>
356 </nav>
357 </li>
358
359
360
361
362
363
364
365 <li class="md-nav__item md-nav__item--nested">
366
367 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3">
368
369 <label class="md-nav__link" for="nav-3">
370 BlissRoms
371 </label>
372 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
373 <label class="md-nav__title" for="nav-3">
374 BlissRoms
375 </label>
376 <ul class="md-nav__list" data-md-scrollfix>
377
378
379
380
381
382
383
384 <li class="md-nav__item">
385 <a href="../../BlissRoms/" title="Index" class="md-nav__link">
386 Index
387 </a>
388 </li>
389
390
391
392
393
394
395
396 <li class="md-nav__item">
397 <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link">
398 Build Guide
399 </a>
400 </li>
401
402
403
404
405
406
407
408 <li class="md-nav__item">
409 <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link">
410 Build Tips
411 </a>
412 </li>
413
414
415 </ul>
416 </nav>
417 </li>
418
419
420
421
422
423
424
425 <li class="md-nav__item md-nav__item--nested">
426
427 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4">
428
429 <label class="md-nav__link" for="nav-4">
430 Common
431 </label>
432 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
433 <label class="md-nav__title" for="nav-4">
434 Common
435 </label>
436 <ul class="md-nav__list" data-md-scrollfix>
437
438
439
440
441
442
443
444 <li class="md-nav__item">
445 <a href="../../common/" title="Index" class="md-nav__link">
446 Index
447 </a>
448 </li>
449
450
451
452
453
454
455
456 <li class="md-nav__item">
457 <a href="../../common/git-started/" title="Git Started" class="md-nav__link">
458 Git Started
459 </a>
460 </li>
461
462
463
464
465
466
467
468 <li class="md-nav__item">
469 <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link">
470 Maintaining proper authorship
471 </a>
472 </li>
473
474
475
476
477
478
479
480 <li class="md-nav__item">
481 <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link">
482 Using `dippy-bird`
483 </a>
484 </li>
485
486
487 </ul>
488 </nav>
489 </li>
490
491
492
493
494
495
496
497 <li class="md-nav__item md-nav__item--nested">
498
499 <input class="md-toggle md-nav__toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5">
500
501 <label class="md-nav__link" for="nav-5">
502 Infrastructure
503 </label>
504 <nav class="md-nav" data-md-component="collapsible" data-md-level="1">
505 <label class="md-nav__title" for="nav-5">
506 Infrastructure
507 </label>
508 <ul class="md-nav__list" data-md-scrollfix>
509
510
511
512
513
514
515
516 <li class="md-nav__item">
517 <a href="../../infrastructure/" title="Index" class="md-nav__link">
518 Index
519 </a>
520 </li>
521
522
523 </ul>
524 </nav>
525 </li>
526
527
528 </ul>
529</nav>
530 </div>
531 </div>
532 </div>
533
534
535 <div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
536 <div class="md-sidebar__scrollwrap">
537 <div class="md-sidebar__inner">
538
539<nav class="md-nav md-nav--secondary">
540
541
542
543
544
545 <label class="md-nav__title" for="__toc">Table of contents</label>
546 <ul class="md-nav__list" data-md-scrollfix>
547
548 <li class="md-nav__item">
549 <a href="#what-information-is-required" class="md-nav__link">
550 What information is required?
551 </a>
552
553</li>
554
555 <li class="md-nav__item">
556 <a href="#capturing-logcat" class="md-nav__link">
557 Capturing logcat
558 </a>
559
560</li>
561
562 <li class="md-nav__item">
563 <a href="#drivers" class="md-nav__link">
564 Drivers
565 </a>
566
567</li>
568
569 <li class="md-nav__item">
570 <a href="#im-done-where-should-i-send-this-to" class="md-nav__link">
571 I'm done, where should I send this to?
572 </a>
573
574</li>
575
576
577
578
579
580 </ul>
581
582</nav>
583 </div>
584 </div>
585 </div>
586
587
588 <div class="md-content">
589 <article class="md-content__inner md-typeset">
590
591
592
593 <h1 id="taking-bug-reports">Taking bug reports</h1>
594<div class="admonition warning">
595<p class="admonition-title">Warning</p>
596<p>If you were redirected here from Telegram, <strong>please</strong> read this entire page in full! We cannot help you if you submit an incomplete bug report.</p>
597</div>
598<h2 id="what-information-is-required">What information is required?</h2>
599<p>As stated in the XDA post and various "Update" posts, we require some debugging information in order to help troubleshoot your issue.</p>
600<p>When you are asking for help on any of the platforms we are on, such as Telegram or XDA, we ask that you provide the following information:
601 - Device details (as much info about your device as possible)
602 - The exact filename of the Bliss OS <code>.iso</code> file used for installation
603 - Logs from Android <code>logcat</code></p>
604<p>The last bit is <strong>extremely important</strong>! We're not psychics, and certainly not psychics capable of debugging binary issues over the air. Without logs, we don't know what your device is trying to do, or rather, failing to do. So here is a brief rundown on the process of capturing logs.</p>
605<h2 id="capturing-logcat">Capturing logcat</h2>
606<div class="admonition question">
607<p class="admonition-title">Question</p>
608<p><strong>Q: Can I follow the instructions below, but use local terminals?</strong></p>
609<p>Yes, but <strong>only</strong> if you have <strong>root permissions</strong>. We include a default terminal app that you can enable by going to Developer Options. There's also a Terminal Emulator app available on Google Play.</p>
610</div>
611<p>If you would rather not use a terminal app, you can use another virtual console (<code>tty</code>) in order to troubleshoot. Linux has multiple virtual consoles that you can navigate by using shortcuts. On Bliss OS, we use the Alt key and the corresponding function keys (F1 for root terminal, F7 for GUI, etc.) to navigate those virtual consoles.</p>
612<p>Start off by entering the root terminal (Alt-F1). Then type:</p>
613<pre><code>su
614logcat &gt; sdcard/logcat.txt
615</code></pre>
616<p>Then come back to the GUI (Alt-F7) and repeat what caused your issue. Once done, return to the root terminal and end the log collection by pressing Ctrl-C.</p>
617<p>Then grab the <code>logcat.txt</code> file from your root directory (<code>/sdcard</code>) and share it with us in order for us to help you!</p>
618<h2 id="drivers">Drivers</h2>
619<p>If your device already runs well on a Linux distro, sharing information about that distro with us may help us debug driver issues.</p>
620<h2 id="im-done-where-should-i-send-this-to">I'm done, where should I send this to?</h2>
621<p>Our <a href="https://t.me/blissx86">Telegram chat for Bliss OS would be a good place to send bug reports!</a></p>
622<p>We are working on an official bug-tracker, it's not ready just yet. If we make it available we will update the documentation!</p>
623
624
625
626
627
628
629
630
631
632 </article>
633 </div>
634 </div>
635 </main>
636
637
638<footer class="md-footer">
639
640 <div class="md-footer-nav">
641 <nav class="md-footer-nav__inner md-grid">
642
643 <a href="../installation-guide/" title="Installation Guide" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
644 <div class="md-flex__cell md-flex__cell--shrink">
645 <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
646 </div>
647 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
648 <span class="md-flex__ellipsis">
649 <span class="md-footer-nav__direction">
650 Previous
651 </span>
652 Installation Guide
653 </span>
654 </div>
655 </a>
656
657
658 <a href="../troubleshooting/" title="Troubleshooting" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
659 <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
660 <span class="md-flex__ellipsis">
661 <span class="md-footer-nav__direction">
662 Next
663 </span>
664 Troubleshooting
665 </span>
666 </div>
667 <div class="md-flex__cell md-flex__cell--shrink">
668 <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
669 </div>
670 </a>
671
672 </nav>
673 </div>
674
675 <div class="md-footer-meta md-typeset">
676 <div class="md-footer-meta__inner md-grid">
677 <div class="md-footer-copyright">
678
679 powered by
680 <a href="https://www.mkdocs.org">MkDocs</a>
681 and
682 <a href="https://squidfunk.github.io/mkdocs-material/">
683 Material for MkDocs</a>
684 </div>
685
686 </div>
687 </div>
688</footer>
689
690 </div>
691
692 <script src="../../assets/javascripts/application.ac79c3b0.js"></script>
693
694 <script>app.initialize({version:"1.0.4",url:{base:"../.."}})</script>
695
696
697 </body>
698</html>