Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 66dd75ac authored by Manoj Nair's avatar Manoj Nair
Browse files

Merge branch '1008-update-generate-log-guide-to-include-option-from-device' into 'master'

Resolve "Update generate log guide to include option from device"

Closes #1008

See merge request e/documentation/user!1164
parents 35d13663 c80921e0
Loading
Loading
Loading
Loading
+74 −28
Original line number Diff line number Diff line
@@ -13,42 +13,46 @@ To generate a logcat you would need to enable `adb` on your phone as well as you

1. On your phone

   - Enable developers options in settings (**Settings** > **About phone** > Tap **Build number** 7 times)
   - Enable Android debug (**Settings** > **System** > **Developer options** > **Android debugging**)
   - Enable `Developer options` in `Settings` (`Settings` > `About phone` > Tap `Build number` 7 times).
   - Enable Android debug (`Settings` > `System` > `Developer options` > `Android debugging`).

1. On your computer,
    - install `adb` on your PC
    - There could be issues here with the device driver or the OS type. You can find details on how to install `adb` [here](https://www.xda-developers.com/install-adb-windows-macos-linux/)
   - Install `adb` on your PC.
   - There could be issues here with the device driver or the OS type. You can find details on how to install `adb` [here](https://www.xda-developers.com/install-adb-windows-macos-linux/).

    - connect your device to your computer
    - Detect your device by typing the below command at the command prompt
   - Connect your device to your computer.
   - Detect your device by typing the below command at the command prompt:

      ```shell
      $ adb devices
      ```
     `$ adb devices`
    
      You would have to accept an authorization on your phone. A pop up like this will appear

      ![Allow_USB_Debugging](/images/Allow_USB_Debugging.png)
   -  You would have to accept an authorization on your phone. A pop up like this will appear.

    - Check the option ‘Always allow from this computer’ and click Ok
    - Check that your device is being detected by `adb`
     
<div class="text-center">
  <img src="/images/Allow_USB_Debugging.png" alt="">
</div>

   - Check the option `Always allow from this computer` and click `Ok`.
   - Check that your device is being detected by `adb`.
   - Once you accept the authorization shown above you will see the display on you screen like this.

        ![adb_Device_Detected](/images/adb_Device_Detected.png)
        
    - If you do not accept the message will say that the device is unauthorized
<div class="text-center">
  <img src="/images/adb_Device_Detected.png" alt="">
</div>

   - If you do not accept the message will say that the device is unauthorized.

## Generate the log
## Generate a bug report using adb

   - Try to reproduce the error. For e.g if Music app is crashing then run it again. The app you are   
      facing an issue with will crash.

- Now Run this command at the command prompt / console
   - Now Run this command at the command prompt / console:

     `$ adb logcat -d > logcat.txt`
  
    ```shell
    $ adb logcat -d > logcat.txt
    ```

   - This will create a file called logcat.txt in the current folder.

@@ -56,8 +60,50 @@ To generate a logcat you would need to enable `adb` on your phone as well as you

   - Once you have the logcat file please share it with the development team as an attachment to the Gitlab error .

Additionally, the radio buffer can be viewed or stored with logcat. If needed or requested, type the below command
   Additionally, the radio buffer can be viewed or stored with logcat. If needed or requested, type the below command:

    `adb logcat -db radio > radio.txt`

Next save it as `radio.txt` and share with the development team or on Gitlab
 No newline at end of file
  
  Next save it as `radio.txt` and share with the development team or on Gitlab.


## Capture a bug report from a device

- Pre requisites for sending this report from the device:
   - To be able to attach the bug report once it is created, there should be an email account configured on the phone.
   - Enable `Developer options` on the device. If `Developer options` has not been enabled on your device check [this guide](/pages/enable-usb-debugging). 

  
  
  -  In `Developer options`, tap `Bug report`.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_developeroptions_01.png" alt="">
</div>
  -  Select the type of bug report you want and tap `Report`. Two options will be displayed - `Interactive` and `Full Report`. Check with the developers what type of report they require.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_logtypes_02.png" alt="">
</div>
  
 -  After a moment you get a notification that the bug report is ready.

  -  Swipe down on the notifications to share the bug report you just created.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_notification_03.png" alt="">
</div>
    
 - You would see a warning regarding the information in your log. Check the logs for any personal information before sharing.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_notificationwarning_04.png" alt="">
</div>

- Once you have accepted the above warning you will be shown the option to share the information. Here we are assuming you will go ahead with the email option.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_sharescreen_05.png" alt="">
</div>

- The below screenshot is how the email will show up. Add the email ID of the person or Murena team you want to send the log to.
<div class="text-center">
  <img src="/images/support-topics/generatelog/generatelog_mail_06.png" alt="">
</div>
+41.1 KiB
Loading image diff...
+51.5 KiB
Loading image diff...
+40.7 KiB
Loading image diff...
+23.8 KiB
Loading image diff...
Loading