#title Reporting Bugs - HowTo #language en <> <> = 如何报告Bug = ||<>|| Ubuntu使用Launchpad来追踪Bug和它们的修复情况。这个页面会手把手地教你如何提交优质和详细的报告。 == 使用Kubuntu? == 如果你在用Kubuntu,请查看[[https://wiki.kubuntu.org/Kubuntu/Bugs/Reporting|这个页面]]的Kubuntu版本。 == 1. 创建一个Launchpad帐户 == 如果还没有Launchpad帐户 - 你需要访问[[https://help.launchpad.net/YourAccount/NewAccount|创建一个Launchpad账户]]。这会允许你提交新的bug和评论已有的。 == 2. 确定是否真的是Bug == 如果你要: * '''请求新的软件:''' you should follow the guidelines at https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages * '''请求技术支持:''' there are a multitude of ways you can get help using Ubuntu, such as the [[https://answers.launchpad.net/ubuntu|Launchpad answer tracker]], the [[http://askubuntu.com/|Ask Ubuntu]] site, the [[http://www.ubuntuforums.org/|Ubuntu forums]], the [[irc://irc.freenode.net/#ubuntu|#ubuntu]] channel on the [[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]] server, and the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-users|ubuntu-users]] mailing list. * '''讨论特性和现有的策略:''' this belongs to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list. * '''提出特性和想法:''' you should submit your idea to [[http://brainstorm.ubuntu.com/|Ubuntu Brainstorm]] or to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list. * '''提交不是Ubuntu软件包的程序的Bug:''' You should file a bug in that program's bug tracking interface. Instructions are generally available on the program's web site. /!\ If you want to file a translation or misspelling bug, follow the instructions [[#translation|here]]. 那么请'''不要'''提交Bug == 3. 确保Bug没有人报过 == 当提交bug时,请确保它还没有被报告过,通过搜索[[https://launchpad.net/distros/ubuntu/+bugs|已有的bug]]和你的Ubuntu版本的发行注记: * [[http://www.ubuntu.com/getubuntu/releasenotes/804|Ubuntu 8.04 LTS (Hardy Heron)]] * [[http://www.ubuntu.com/getubuntu/releasenotes/1004|Ubuntu 10.04 LTS (Lucid Lynx)]] * [[http://www.ubuntu.com/getubuntu/releasenotes/1010|Ubuntu 10.10 (Maverick Meerkat)]] * [[http://www.ubuntu.com/getubuntu/releasenotes/1104|Ubuntu 11.04 (Natty Narwhal)]] * [[http://www.ubuntu.com/getubuntu/releasenotes/1110|Ubuntu 11.10 (Oneiric Ocelot)]] * [[http://www.ubuntu.com/getubuntu/releasenotes/1204|Ubuntu 12.04 LTS (Precise Pangolin)]] 如果你想为已被报告的Bug提供更多的信息,请直接在该Bug的报告页添加,请不要另开一个新的Bug报告。 /!\ '''对于声音、X驱动和内核bug''': 请开一个'''新'''bug,而不要评论一个相似的bug:很有可能你的硬件和已有bug的硬件不尽相同,而这个bug可能不会被处理。 [[#Top|返回顶部]] == 4. 为Bug收集信息 == The method of reporting bugs in Ubuntu is by using the tool "ubuntu-bug", otherwise known as '''Apport'''. When reporting a bug, you must tell Apport which program or [[https://help.ubuntu.com/community/InstallingSoftware#What%20is%20a%20package?|package]] is at fault. === 从特定的软件包收集信息 === ||{{attachment:ubuntu-bug2.png|Filing a bug with the "Run Application" window}}|| Press Alt+F2 to open the "Run Application" window, pictured above. Type `ubuntu-bug `''``'' and click ''Run''. If you're not sure which package has the problem, refer to the instructions for [[https://wiki.ubuntu.com/Bugs/FindRightPackage|finding the right package]]. === 从一个当前运行的程序收集信息 === To file a bug against a program that is currently running, go to '''System > Administration > System Monitor''', and find the ID of the process. ||{{attachment:system-monitor-id.png | System Monitor Processes tab }}|| Then type "ubuntu-bug " followed by the process ID into the "Run Application" window. ||{{attachment:ubuntu-bug-pid.png | Filing a bug with the "Run Application" window and a process ID}}|| === 提交一个一般的不针对特定软件包的Bug === If you're not sure which package is affected by the bug, type `ubuntu-bug` in the "Run Application" window and click ''Run''. This will guide you through a series of questions to gather more information about the bug. [[#Top|返回顶部]] == 5. 完成Bug报告的提交过程 == After running one of the above commands, Apport (the Ubuntu bug reporter) will gather information about the bug. ||{{attachment:apport-1.png | Apport collecting information about the bug}}|| A window will then pop up, asking you if you want to report the bug. Click "Send Report" if you wish to proceed, or click "Content of the report" if you want to review the information Apport collected. ||{{attachment:send-problem-question.png | Apport asking you to send the report}}|| Apport will then upload the problem information to Launchpad, and a new browser window will then open to inform you that the bug report is being processed. ||{{attachment:information-upload.png | Apport uploading the problem information}}|| ||{{attachment:process-data2.png | Launchpad processing the bug report data}}|| After the bug report data has been processed, a new page will open that will ask you for the bug report's title. When you're done, click "Next". ||{{attachment:bug-title2.png | Launchpad asking for a bug title}}|| A search will then occur based on the title you gave to the bug report, and will show potentially similar ones. If one of these seems to be the exact bug you're reporting, click its title, then "Yes, this is the bug I'm trying to report". If not, click "No, I need to report a new bug". ||{{attachment:bug-search.png | Launchpad search results about the bug title}}|| Launchpad will then ask you for further information. It's important that you specify three things: 1. What you expected to happen 1. What actually happened 1. If possible, a minimal series of steps necessary to make it happen, where step 1 is "start the program" Fill in the description field with as much information as you can, including the release of Ubuntu you are using and steps for someone else to recreate the bug. It is better to have too much information in the description than not enough. ||{{attachment:more-informations2.png | Launchpad asking for further information}}|| At then bottom of the page, there is some extra options you can use to make your bug report more complete: * '''This bug is a security vulnerability:''' Please check this '''''only''''' if your bug report describes a behaviour that could be exploited to crack your system. (TODO: better wording?) * '''Tags:''' You can add here [[http://wiki.ubuntu.com/Bugs/Tags|tags]] that pertain to your bug report. The predefined values are fine most of the time. * '''Include an attachment:''' Using this option, you can add supporting attachments to explain or help others reproduce the bug. This might include a screenshot, a video capture of the problem or a sample document that triggers the fault. Additional attachments, if necessary, can be added after the bug is reported via '''Add a comment/attachment''' at the bottom of the page. ||{{attachment:extra-options2.png | Launchpad presenting extra options}}|| When you're done, click "Submit bug report". = 打印问题 = For information about printing problems and debugging them, please see [[https://wiki.ubuntu.com/DebuggingPrintingProblems|the printing debugging page]] = 贴士与技巧 = == 在离线时提交Bug == In the event that you have an issue with your Internet connection or want to file a bug for another system you can still do this using apport. First, gather the information about the target system in a file: * For a bug report about a system crash:<
>`apport-cli -p` ''``'' `--save bug.crash` * For a bug report about any other issue:<
>`apport-cli -f -p` ''``'' `--save bug.apport` You will need to answer a few questions, which will vary depending on which package the bug report is about. Relevant system information, including the package name, is then saved on the target system, in the current directory. The extension indicates if it is a crash report or another kind of report. If you decide to rename the report file, please keep the `.apport` or `.crash` extension. After copying it to a different system you can file that report using the following command:<
>`ubuntu-bug -c` ''``'' If this is to be added to an existing bug report, also use the -u option:<
>`ubuntu-bug -c` ''``'' `-u` ''``'' You will need to answer a few questions, and a web browser will be launched to complete the bug report. == 在Launchpad.net提交Bug == If for some reason you cannot file a bug using the ''Apport'' tool you can file one via [[https://bugs.launchpad.net/ubuntu/+filebug/?no-redirect | Launchpad's own bug report form]]. When doing so it is best if you have determined which package it should be filed against. Read '[[http://wiki.ubuntu.com/Bugs/FindRightPackage|finding the right package]]' for guidance or use [[ http://launchpad.net/ubuntu/ | Launchpad's package search feature ]]. We don't recommend this method for most bug reports because they will likely be missing crucial information, use ubuntu-bug if you can! To file a bug against a specific package you can also use a URL like the following: `http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect` where PACKAGENAME is the name of the source package about which you want to file the bug report. In the event that you want to request a piece of software be packaged for Ubuntu please follow the instructions in the [[ https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages#Requesting%20a%20new%20package%20for%20Ubuntu | wiki ]]. == 使用受影响应用程序的帮助菜单(只限开发版本) == If you want to report a bug on an application that is ''running and responding'', use the application's help menu: '''Help -> Report a problem'''. {{attachment:report-a-problem.png}} This method is preferable to filing a bug at the Launchpad website - it automatically attaches relevant information, which helps analyze the problem. If an application crashes, and you're using a version of Ubuntu which is actively under development, [[https://wiki.ubuntu.com/Apport|Apport]] will start automatically, raising an appropriate bug report for you to complete in Launchpad. This provides developers with rich debugging information that will make it easier to fix the problem. ||{{attachment:apport-1.png}}|| == 为一个现存Launchpad的Bug增加Apport调试信息 == If you have already reported a bug directly via Launchpad, but want to add additional debugging information via ''Apport'' to the bug report, you can do this by running the command `apport-collect bug_number` via "Run Application" or terminal window. <> == 提交一个翻译Bug == 如果你正在经历以下问题中的一个: * Wrong translations or spelling mistakes for languages other than English in applications * Errors in spellcheckers or language support * A string from an application not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] * An application from the Ubuntu main repository not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] * A translation made in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] and not updated in the Ubuntu language packs * A duplicate translation template (the same application can be translated in two different places) in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] * A template/translation no longer used in Ubuntu and that should be disabled from [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] In case of doubt, you can always [[http://wiki.ubuntu.com/Translations/Contact|contact the Translations team]]. 你应该提交一个翻译bug。 All translation issues should be filed against the [[https://bugs.launchpad.net/ubuntu-translations | Ubuntu Translations project]]. From there the bugs will be triaged and assigned to the right person and package. [[#Top|返回顶部]] = 寻求建议 = 对提交Bug报告的过程仍然有疑问?你可以在[[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]]服务器的[[irc://irc.freenode.net/#ubuntu-bugs|#ubuntu-bugs]]频道或者 [[https://lists.ubuntu.com/mailman/listinfo/Ubuntu-bugsquad|bugsquad 邮件列表]]寻求其他人的帮助。 [[#Top|返回顶部]] = 其他语言 = * [[ReportingBugs|English]] * [[ReportingBugs_es|Español]] * [[http://www.ubuntu.ro/documentatie/comunitate/RaportareErori|română]] * [[ReportingBugs_ru|Русский]] * [[https://help.ubuntu.com/community/ReportingBugs_de|Deutsch]] [[#Top|返回顶部]] = 参见 = * [[http://youtu.be/18nsScrDIa0|A screencast on using these tools]] 作者:Jono Bacon * [[http://www.chiark.greenend.org.uk/~sgtatham/bugs-cn.html|如何有效地报告 Bug]] 作者:Simon Tatham 翻译:Dasn * [[Ubuntu:DebuggingProcedures|Debugging Procedures]]