TouchTesting

Differences between revisions 1 and 14 (spanning 13 versions)
Revision 1 as of 2013-09-16 12:24:41
Size: 2578
Editor: jibel
Comment:
Revision 14 as of 2013-09-17 16:32:41
Size: 6575
Editor: adsl-98-70-43-80
Comment:
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
 * '''Mailing List''' - The quality mailing list [https://lists.ubuntu.com/mailman/listinfo/ubuntu-quality|ubuntu-quality@lists.ubuntu.com] is used to coordinate testing activities with all participants.  * '''Mailing List''' - The quality mailing list [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-quality|ubuntu-quality@lists.ubuntu.com]] is used to coordinate testing activities with all participants.
Line 13: Line 13:
This describes the daily process of testing. We will flash our devices, look for bugs, then look to write autopilot tests for any fixed bugs to prevent that bug from re-occurring.
Line 14: Line 15:
TODO == Daily Image Testing ==
=== Install the current stable image ===
Flash your phone to the latest stable image (note: we want the "current" image of touch_ro). If you have not yet bootstrapped or unlocked your phone's bootloader, [[https://wiki.ubuntu.com/Touch/Install|see the install page for more information]].
{{{
  $ phablet-flash ubuntu-system
}}}

==== Perform a system update ====
Alternatively, once you are running the ubuntu image you may perform a system update from the device itself. To do this, select 'system-settings' application, then click update. Press the download button, and once the download is completed, the install button.

=== Check to see what's changed ===
A list of changes between stable images can be [[http://people.canonical.com/~ogra/touch-image-stats/current/|found here]]. The list contains the list of changing packages.

 * Changes in current: http://people.canonical.com/~j-lallement/touch/changes/current/

 * Changes in pending: http://people.canonical.com/~j-lallement/touch/changes/

Use these changes to drive exploratory testing below.

=== Test ===
* Run through the list of new features and changed areas of the phone, paying specific attention to spot regressions and verify the features are working.

* Perform smoke testing on a specific packageset of the phone.

* File bugs against any issues encountered

* Remember this is exploratory testing, so try and break things!

=== Report Bugs ===
See the [[https://wiki.ubuntu.com/QATeam/TouchTesting#Reporting_a_bug|Reporting a Bug section below]] for details.

=== Add a testcase for reported bugs ===
Once testing is completed, review the list of reported bugs with the [[https://bugs.launchpad.net/bugs/+bugs?field.tag=needs-autopilot-test| needs-autopilot-test tag]]. [[https://wiki.ubuntu.com/Touch/CoreApps/Testing/ContributeAutopilotTestcase|Automate a testcase using autopilot]] that fixes the bug to ensure the same bug doesn't reappear.
Line 17: Line 50:
All bugs filed should use the touch-swat tag. Omer has made available a tool to help with the process of filing a bug report.
Line 18: Line 52:
== There is a crash file in /var/crash == == What package should I file against? ==
File against the ubuntu source package for the failed component. [[https://wiki.ubuntu.com/QATeam/TouchTesting/BugFiling|See this page]] for a full broken out list of components.

== List of Reported Bugs ==
[[https://bugs.launchpad.net/bugs/+bugs?field.tag=touch-swat|All touch-swat bug reports]]

== Filing the Bug ==

=== Using Omer's tool ===
''' This is the recommended way to file bugs '''

Omer has created a tool to allow you to report a bug from your desktop, provided the phone is connected via usb cable. [[http://paste.ubuntu.com/6098563/plain/|Download and save this file]]. To run, pass the package name as the only argument. The tool will connect and grab logs from your device, and open a new bug in your desktop browser to file the bug.

=== There is a crash file in /var/crash ===
Line 61: Line 108:
== There is no crash file == === There is no crash file ===
Line 73: Line 120:
}}}
Line 74: Line 122:
3. Wait until data collection is done.

4. At the question:

{{{
Line 76: Line 129:
  V: View report
[...]
Line 80: Line 134:
3. On your local machine, click on the link or copy/paste it into your browser. Press 'S' or 'K' if you want to copy the report to another machine (for example if networking is not enabled on the device).
Line 82: Line 136:
= Test Activities = 3. If you're reporting from the device, on your local machine, click on the link or copy/paste it into your browser.
Line 84: Line 138:
Describe here any specific test activities.
= Tips and Tricks =

Here are some helpful hints that will come in handy while testing; feel free to add more!

 * Switch from RO to RW (to install additional packages for example):
    * Remount RW
{{{
    $ adb shell
    $ mount /dev/loop0 / -o remount,rw
}}}
    * or touch writable_image
{{{
    $ adb shell touch /userdata/.writable_image
    $ adb reboot
}}}

 * Take a screenshot (helpful for bug reporting)
{{{
   $ adb shell /system/bin/screencap /data/screenshot.png
   $ adb pull /data/screenshot.png ~/screenshot.png
}}}

 * Find out what build you are running
{{{
   $ adb shell cat /etc/media-info
}}}
Line 89: Line 169:

* Add list of who's testing which feature sets / areas

Warning /!\ W.I.P. Warning /!\

Touch Test SWAT

Welcome to the testing page of the Touch Testing SWAT. These pages provide up to date information of current testing activities for Touch until the release of Saucy, check back frequently.

Test coordination

  • Mailing List - The quality mailing list ubuntu-quality@lists.ubuntu.com is used to coordinate testing activities with all participants.

  • IRC - join the Ubuntu QA in #ubuntu-quality and and Ubuntu Touch #ubuntu-touch IRC channels on freenode.

Test process

This describes the daily process of testing. We will flash our devices, look for bugs, then look to write autopilot tests for any fixed bugs to prevent that bug from re-occurring.

Daily Image Testing

Install the current stable image

Flash your phone to the latest stable image (note: we want the "current" image of touch_ro). If you have not yet bootstrapped or unlocked your phone's bootloader, see the install page for more information.

  $ phablet-flash ubuntu-system

Perform a system update

Alternatively, once you are running the ubuntu image you may perform a system update from the device itself. To do this, select 'system-settings' application, then click update. Press the download button, and once the download is completed, the install button.

Check to see what's changed

A list of changes between stable images can be found here. The list contains the list of changing packages.

Use these changes to drive exploratory testing below.

Test

* Run through the list of new features and changed areas of the phone, paying specific attention to spot regressions and verify the features are working.

* Perform smoke testing on a specific packageset of the phone.

* File bugs against any issues encountered

* Remember this is exploratory testing, so try and break things!

Report Bugs

See the Reporting a Bug section below for details.

Add a testcase for reported bugs

Once testing is completed, review the list of reported bugs with the needs-autopilot-test tag. Automate a testcase using autopilot that fixes the bug to ensure the same bug doesn't reappear.

Reporting a bug

All bugs filed should use the touch-swat tag. Omer has made available a tool to help with the process of filing a bug report.

What package should I file against?

File against the ubuntu source package for the failed component. See this page for a full broken out list of components.

List of Reported Bugs

All touch-swat bug reports

Filing the Bug

Using Omer's tool

This is the recommended way to file bugs

Omer has created a tool to allow you to report a bug from your desktop, provided the phone is connected via usb cable. Download and save this file. To run, pass the package name as the only argument. The tool will connect and grab logs from your device, and open a new bug in your desktop browser to file the bug.

There is a crash file in /var/crash

If the bug is a crash and there is a crash file in /var/crash, you can report it with apport.

1. Connect to the device with adb

  $ adb shell

2. Check for any crash file in /var/crash

3. Report a bug with apport:

  $ apport-cli /var/crash/name_of_crash_file.crash

4. Follow the instructions

5. To the question "What would you like to do? Your options are:", answer "S: Send report"

6. Wait for the upload to proceed

7. Upon upload you'll be presented with a prompt like:

*** To continue, you must visit the following URL:

  https://bugs.launchpad.net/ubuntu/+source/upstart-app-launch/+filebug/<UUID>

You can launch a browser now, or copy this URL into a browser on another computer.


Choices:
  1: Launch a browser now
  C: Cancel

8. Copy the URL to a browser running on your desktop/laptop, it is more convenient than running a browser on the phone to report bug and proceed with the bug reporting process in launchpad

9. Then follow the usual tagging plan and triaging process

There is no crash file

1. Connect to the device with adb

  $ adb shell

2. Find the right package (TODO: Document difference between preinstalled dpkg based packages and click package)

  $ ubuntu-bug maliit-framework

3. Wait until data collection is done.

4. At the question:

What would you like to do? Your options are:
  S: Send report (4.3 KB)
  V: View report
[...]
https://bugs.launchpad.net/ubuntu/+source/maliit-framework/+filebug/<UUID>?

Press 'S' or 'K' if you want to copy the report to another machine (for example if networking is not enabled on the device).

3. If you're reporting from the device, on your local machine, click on the link or copy/paste it into your browser.

Tips and Tricks

Here are some helpful hints that will come in handy while testing; feel free to add more!

  • Switch from RO to RW (to install additional packages for example):
    • Remount RW

    $ adb shell
    $ mount /dev/loop0 / -o remount,rw
  • or touch writable_image

    $ adb shell touch /userdata/.writable_image
    $ adb reboot
  • Take a screenshot (helpful for bug reporting)

   $ adb shell /system/bin/screencap /data/screenshot.png
   $ adb pull /data/screenshot.png ~/screenshot.png
  • Find out what build you are running

   $ adb shell cat /etc/media-info

TODO

* Add link to reference documentation (how to flash, specific testing like MIR, how to troubleshoot, ...)

* Add list of who's testing which feature sets / areas

QATeam/TouchTesting (last edited 2015-01-22 17:18:23 by xdsl-83-150-81-40)