Difference between revisions of "Android Report bugs"

From VideoLAN Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
[[File:VLC Android Crash.png|thumb|right|VLC for Android has crashed]]
 
[[File:VLC Android Crash.png|thumb|right|VLC for Android has crashed]]
 +
 +
{{howto|report Android bugs}}
 +
 +
=What you have to do=
 +
 +
If you want to help us to solve an issue you experiment on VLC for Android, we need to know few things :
 +
* your exact device name
 +
* your Android version number
 +
* your VLC version number
 +
* a log file (see below)
 +
* tell us if your issue happened only on one media (video or music) or all of them
 +
* join a sample, a screenchot, etc...
 +
 +
When you have this informations, send us an email at [mailto:videolan.mobile@gmail.com videolan.mobile@gmail.com]
 +
 +
Moreover if you are competent, feel free to create a report on the [https://trac.videolan.org/vlc/ VLC bug tracker]
 +
 +
===---Work in progress beyond this line---===
  
 
=How to find the stack-trace if VLC for Android crashes=
 
=How to find the stack-trace if VLC for Android crashes=
Line 28: Line 46:
 
# Once you are done playing the file, go back to the "debug logs" screen. You can find the log in this screen. To retrieve it, copy it to the Android clipboard and paste it on any [http://pastebin.com/ pastebin] site or however you wish.
 
# Once you are done playing the file, go back to the "debug logs" screen. You can find the log in this screen. To retrieve it, copy it to the Android clipboard and paste it on any [http://pastebin.com/ pastebin] site or however you wish.
 
# Press "Stop logging" to end the debugging session and return to normal usage.
 
# Press "Stop logging" to end the debugging session and return to normal usage.
{{Anchoring space}}
+
 
 
[[Category:Android]]
 
[[Category:Android]]

Revision as of 13:55, 3 September 2013

VLC for Android has crashed


This page describes how to report Android bugs. Other "how to" pages

What you have to do

If you want to help us to solve an issue you experiment on VLC for Android, we need to know few things :

  • your exact device name
  • your Android version number
  • your VLC version number
  • a log file (see below)
  • tell us if your issue happened only on one media (video or music) or all of them
  • join a sample, a screenchot, etc...

When you have this informations, send us an email at videolan.mobile@gmail.com

Moreover if you are competent, feel free to create a report on the VLC bug tracker

---Work in progress beyond this line---

How to find the stack-trace if VLC for Android crashes

Normally, when VLC for Android crashes it will leave behind a vlc_logcat_<date and some numbers>.log file in your SD card's root. You can then retrieve this to your computer using the file transfer mechanism offered by your phone (e.g. Mass storage, etc). Then, pastebin the contents of the vlc_logcat_<...>.log file.

You can use OI File Manager (open source file browser) to view and manipulate the file (e.g. move it to a folder where it's uploadable to PC).

If you do not find any log in the form of "vlc_logcat_<...>.log", please scroll down to "logcat log" below.

VLC Android Logcat File.png

Logcat log

However, in some cases (such as on certain Huawei phones who use a non-standard implementation of Logcat) you will need access to a computer and enable adb debugging. To do this, first ADB debugging must be enabled - Settings→Developer options→USB debugging, or on older phones, Settings→Applications→Development→USB debugging. In both cases, ensure that the option is checked.

An easier approach might be to install Terminal (a.k.a. Term.apk) If you haven't already. Open Terminal and clear the logcat buffer with logcat -c. Then, re-open VLC and try to make it crash. Once it crashes, then re-open Terminal and type in letter-for-letter, case sensitive: cd /sdcard && logcat -d > log.txt into the terminal, and hit Enter. Pull the file "log.txt" under the SD card to your PC and pastebin.

The normal developers' approach is to install the Android SDK and run adb logcat -d > log.txt, then pastebin the log.txt.

Native crashes (advanced stuff)

Sometimes, you might asked by one of the developers for a backtrace, or native trace. If so, then please see AndroidCompile#Native debugging.

Debug / messages log

  1. Ensure VLC is completely closed by force-stopping it in Android settings.
  2. Start VLC.
  3. Go to preferences → Advanced debugging (at the very bottom) → "Debug logs", and tap "Start logging".
  4. Play the media file in question.
  5. Once you are done playing the file, go back to the "debug logs" screen. You can find the log in this screen. To retrieve it, copy it to the Android clipboard and paste it on any pastebin site or however you wish.
  6. Press "Stop logging" to end the debugging session and return to normal usage.