| |
| <!doctype html> |
| <html lang="en" class="no-js"> |
| <head> |
| |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| |
| |
| |
| <link rel="shortcut icon" href="../../assets/images/favicon.png"> |
| <meta name="generator" content="mkdocs-1.1.2, mkdocs-material-6.0.1"> |
| |
| |
| |
| <title>Taking bug reports - Team Bliss</title> |
| |
| |
| |
| <link rel="stylesheet" href="../../assets/stylesheets/main.38780c08.min.css"> |
| |
| |
| <link rel="stylesheet" href="../../assets/stylesheets/palette.3f72e892.min.css"> |
| |
| |
| |
| |
| |
| |
| |
| <link href="https://fonts.gstatic.com" rel="preconnect" crossorigin> |
| <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,400,400i,700%7CRoboto+Mono&display=fallback"> |
| <style>body,input{font-family:"Roboto",-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"Roboto Mono",SFMono-Regular,Consolas,Menlo,monospace}</style> |
| |
| |
| |
| |
| |
| |
| |
| |
| </head> |
| |
| |
| |
| |
| |
| |
| |
| <body dir="ltr" data-md-color-scheme="" data-md-color-primary="none" data-md-color-accent="none"> |
| |
| |
| <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off"> |
| <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off"> |
| <label class="md-overlay" for="__drawer"></label> |
| <div data-md-component="skip"> |
| |
| |
| <a href="#taking-bug-reports" class="md-skip"> |
| Skip to content |
| </a> |
| |
| </div> |
| <div data-md-component="announce"> |
| |
| </div> |
| |
| <header class="md-header" data-md-component="header"> |
| <nav class="md-header-nav md-grid" aria-label="Header"> |
| <a href="../.." title="Team Bliss" class="md-header-nav__button md-logo" aria-label="Team Bliss"> |
| |
| |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg> |
| |
| </a> |
| <label class="md-header-nav__button md-icon" for="__drawer"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2z"/></svg> |
| </label> |
| <div class="md-header-nav__title" data-md-component="header-title"> |
| |
| <div class="md-header-nav__ellipsis"> |
| <span class="md-header-nav__topic md-ellipsis"> |
| Team Bliss |
| </span> |
| <span class="md-header-nav__topic md-ellipsis"> |
| |
| Taking bug reports |
| |
| </span> |
| </div> |
| |
| </div> |
| |
| <label class="md-header-nav__button md-icon" for="__search"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> |
| </label> |
| |
| <div class="md-search" data-md-component="search" role="dialog"> |
| <label class="md-search__overlay" for="__search"></label> |
| <div class="md-search__inner" role="search"> |
| <form class="md-search__form" name="search"> |
| <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" data-md-state="active"> |
| <label class="md-search__icon md-icon" for="__search"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0116 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 019.5 16 6.5 6.5 0 013 9.5 6.5 6.5 0 019.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5z"/></svg> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> |
| </label> |
| <button type="reset" class="md-search__icon md-icon" aria-label="Clear" data-md-component="search-reset" tabindex="-1"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41z"/></svg> |
| </button> |
| </form> |
| <div class="md-search__output"> |
| <div class="md-search__scrollwrap" data-md-scrollfix> |
| <div class="md-search-result" data-md-component="search-result"> |
| <div class="md-search-result__meta"> |
| Initializing search |
| </div> |
| <ol class="md-search-result__list"></ol> |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| |
| </nav> |
| </header> |
| |
| <div class="md-container" data-md-component="container"> |
| |
| |
| |
| |
| <main class="md-main" data-md-component="main"> |
| <div class="md-main__inner md-grid"> |
| |
| |
| <div class="md-sidebar md-sidebar--primary" data-md-component="navigation"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| <nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0"> |
| <label class="md-nav__title" for="__drawer"> |
| <a href="../.." title="Team Bliss" class="md-nav__button md-logo" aria-label="Team Bliss"> |
| |
| |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 003-3 3 3 0 00-3-3 3 3 0 00-3 3 3 3 0 003 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54z"/></svg> |
| |
| </a> |
| Team Bliss |
| </label> |
| |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../.." title="Home" class="md-nav__link"> |
| Home |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--active md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-2" type="checkbox" id="nav-2" checked> |
| |
| <label class="md-nav__link" for="nav-2"> |
| Bliss OS |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Bliss OS" data-md-level="1"> |
| <label class="md-nav__title" for="nav-2"> |
| <span class="md-nav__icon md-icon"></span> |
| Bliss OS |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../build-guide/" title="Build Guide" class="md-nav__link"> |
| Build Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../extras/" title="Extras" class="md-nav__link"> |
| Extras |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../installation-guide-misc/" title="Installation Guide (Misc)" class="md-nav__link"> |
| Installation Guide (Misc) |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../installation-guide-surface-devices/" title="Installation Guide (Surface devices)" class="md-nav__link"> |
| Installation Guide (Surface devices) |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../installation-guide/" title="Installation Guide" class="md-nav__link"> |
| Installation Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--active"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="toc" type="checkbox" id="__toc"> |
| |
| |
| |
| |
| <label class="md-nav__link md-nav__link--active" for="__toc"> |
| Taking bug reports |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| |
| <a href="./" title="Taking bug reports" class="md-nav__link md-nav__link--active"> |
| Taking bug reports |
| </a> |
| |
| |
| <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> |
| |
| |
| |
| |
| |
| <label class="md-nav__title" for="__toc"> |
| <span class="md-nav__icon md-icon"></span> |
| Table of contents |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| <li class="md-nav__item"> |
| <a href="#what-information-is-required" class="md-nav__link"> |
| What information is required? |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#capturing-logcat" class="md-nav__link"> |
| Capturing logcat |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#drivers" class="md-nav__link"> |
| Drivers |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#im-done-where-should-i-send-this-to" class="md-nav__link"> |
| I'm done, where should I send this to? |
| </a> |
| |
| </li> |
| |
| </ul> |
| |
| </nav> |
| |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../troubleshooting/" title="Troubleshooting" class="md-nav__link"> |
| Troubleshooting |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-3" type="checkbox" id="nav-3"> |
| |
| <label class="md-nav__link" for="nav-3"> |
| BlissRoms |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="BlissRoms" data-md-level="1"> |
| <label class="md-nav__title" for="nav-3"> |
| <span class="md-nav__icon md-icon"></span> |
| BlissRoms |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/build-guide/" title="Build Guide" class="md-nav__link"> |
| Build Guide |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../BlissRoms/build-tips/" title="Build Tips" class="md-nav__link"> |
| Build Tips |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-4" type="checkbox" id="nav-4"> |
| |
| <label class="md-nav__link" for="nav-4"> |
| Common |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Common" data-md-level="1"> |
| <label class="md-nav__title" for="nav-4"> |
| <span class="md-nav__icon md-icon"></span> |
| Common |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/git-started/" title="Git Started" class="md-nav__link"> |
| Git Started |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/maintaining-proper-authorship/" title="Maintaining proper authorship" class="md-nav__link"> |
| Maintaining proper authorship |
| </a> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../common/using-dippy-bird/" title="Using `dippy-bird`" class="md-nav__link"> |
| Using `dippy-bird` |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item md-nav__item--nested"> |
| |
| <input class="md-nav__toggle md-toggle" data-md-toggle="nav-5" type="checkbox" id="nav-5"> |
| |
| <label class="md-nav__link" for="nav-5"> |
| Infrastructure |
| <span class="md-nav__icon md-icon"></span> |
| </label> |
| <nav class="md-nav" aria-label="Infrastructure" data-md-level="1"> |
| <label class="md-nav__title" for="nav-5"> |
| <span class="md-nav__icon md-icon"></span> |
| Infrastructure |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| |
| |
| |
| |
| |
| |
| <li class="md-nav__item"> |
| <a href="../../infrastructure/" title="Index" class="md-nav__link"> |
| Index |
| </a> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </li> |
| |
| |
| </ul> |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| |
| <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> |
| |
| |
| |
| |
| |
| <label class="md-nav__title" for="__toc"> |
| <span class="md-nav__icon md-icon"></span> |
| Table of contents |
| </label> |
| <ul class="md-nav__list" data-md-scrollfix> |
| |
| <li class="md-nav__item"> |
| <a href="#what-information-is-required" class="md-nav__link"> |
| What information is required? |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#capturing-logcat" class="md-nav__link"> |
| Capturing logcat |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#drivers" class="md-nav__link"> |
| Drivers |
| </a> |
| |
| </li> |
| |
| <li class="md-nav__item"> |
| <a href="#im-done-where-should-i-send-this-to" class="md-nav__link"> |
| I'm done, where should I send this to? |
| </a> |
| |
| </li> |
| |
| </ul> |
| |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div class="md-content"> |
| <article class="md-content__inner md-typeset"> |
| |
| |
| |
| <h1 id="taking-bug-reports">Taking bug reports</h1> |
| <div class="admonition warning"> |
| <p class="admonition-title">Warning</p> |
| <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> |
| </div> |
| <h2 id="what-information-is-required">What information is required?</h2> |
| <p>As stated in the XDA post and various "Update" posts, we require some debugging information in order to help troubleshoot your issue.</p> |
| <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: |
| - Device details (as much info about your device as possible) |
| - The exact filename of the Bliss OS <code>.iso</code> file used for installation |
| - Logs from Android <code>logcat</code></p> |
| <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> |
| <h2 id="capturing-logcat">Capturing logcat</h2> |
| <div class="admonition question"> |
| <p class="admonition-title">Question</p> |
| <p><strong>Q: Can I follow the instructions below, but use local terminals?</strong></p> |
| <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> |
| </div> |
| <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> |
| <p>Start off by entering the root terminal (Alt-F1). Then type:</p> |
| <pre><code>su |
| logcat > sdcard/logcat.txt |
| </code></pre> |
| <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> |
| <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> |
| <h2 id="drivers">Drivers</h2> |
| <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> |
| <h2 id="im-done-where-should-i-send-this-to">I'm done, where should I send this to?</h2> |
| <p>Our <a href="https://t.me/blissx86">Telegram chat for Bliss OS would be a good place to send bug reports!</a></p> |
| <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> |
| |
| |
| |
| |
| |
| |
| |
| </article> |
| </div> |
| </div> |
| </main> |
| |
| |
| <footer class="md-footer"> |
| |
| <div class="md-footer-nav"> |
| <nav class="md-footer-nav__inner md-grid" aria-label="Footer"> |
| |
| <a href="../installation-guide/" title="Installation Guide" class="md-footer-nav__link md-footer-nav__link--prev" rel="prev"> |
| <div class="md-footer-nav__button md-icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg> |
| </div> |
| <div class="md-footer-nav__title"> |
| <div class="md-ellipsis"> |
| <span class="md-footer-nav__direction"> |
| Previous |
| </span> |
| Installation Guide |
| </div> |
| </div> |
| </a> |
| |
| |
| <a href="../troubleshooting/" title="Troubleshooting" class="md-footer-nav__link md-footer-nav__link--next" rel="next"> |
| <div class="md-footer-nav__title"> |
| <div class="md-ellipsis"> |
| <span class="md-footer-nav__direction"> |
| Next |
| </span> |
| Troubleshooting |
| </div> |
| </div> |
| <div class="md-footer-nav__button md-icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11H4z"/></svg> |
| </div> |
| </a> |
| |
| </nav> |
| </div> |
| |
| <div class="md-footer-meta md-typeset"> |
| <div class="md-footer-meta__inner md-grid"> |
| <div class="md-footer-copyright"> |
| |
| Made with |
| <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener"> |
| Material for MkDocs |
| </a> |
| </div> |
| |
| </div> |
| </div> |
| </footer> |
| |
| </div> |
| |
| <script src="../../assets/javascripts/vendor.77e55a48.min.js"></script> |
| <script src="../../assets/javascripts/bundle.aa3f9871.min.js"></script><script id="__lang" type="application/json">{"clipboard.copy": "Copy to clipboard", "clipboard.copied": "Copied to clipboard", "search.config.lang": "en", "search.config.pipeline": "trimmer, stopWordFilter", "search.config.separator": "[\\s\\-]+", "search.result.placeholder": "Type to start searching", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.term.missing": "Missing"}</script> |
| |
| <script> |
| app = initialize({ |
| base: "../..", |
| features: [], |
| search: Object.assign({ |
| worker: "../../assets/javascripts/worker/search.4ac00218.min.js" |
| }, typeof search !== "undefined" && search) |
| }) |
| </script> |
| |
| |
| </body> |
| </html> |