TouchTesting

Differences between revisions 2 and 65 (spanning 63 versions)
Revision 2 as of 2013-09-16 12:25:58
Size: 2580
Editor: jibel
Comment:
Revision 65 as of 2015-01-22 17:18:23
Size: 4135
Editor: knome
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
<<Include(QATeam/Header)>>
<<BR>>
Line 3: Line 5:
/!\ '''W.I.P.''' /!\ = Testing Ubuntu Touch =
Welcome! This page contains the information you need to know to test ubuntu touch. Follow the steps outlined to keep your device updated and your testing relevant.
Line 5: Line 8:
= 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.
== Setup ==
You should subscribe to the phone mailing list, and keep in mind the following IRC channels for help.
Line 8: Line 11:
== Test coordination ==
 * '''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.
 * '''IRC''' - join the Ubuntu QA in `#ubuntu-quality` and and Ubuntu Touch `#ubuntu-touch` IRC channels on freenode.
 * '''Mailing Lists''' - The [[https://launchpad.net/~ubuntu-phone|ubuntu phone mailing list]] provides constant updates about what is happening on the phone images.
 * '''IRC''' - join the Ubuntu QA in `#ubuntu-quality` and and Ubuntu Touch `#ubuntu-touch` IRC channels on freenode if you need realtime help.

You also need to flash your phablet device with the latest proposed image.

=== Install the current development image ===
Flash your phone to the latest proposed image. If you have not yet bootstrapped or unlocked your phone's bootloader, [[http://developer.ubuntu.com/start/ubuntu-for-devices/installing-ubuntu-for-devices/|see the install page for more information]].

To test with the proposed image:
{{{
  $ ubuntu-device-flash --channel=devel-proposed
}}}
Line 13: Line 25:
This describes the daily process of testing. We will flash our devices, read what's changed, and look for bugs.
Line 14: Line 27:
TODO == Step 1: Update ==
You need a phone or tablet with the latest development proposed image. If needed, install the current development image now by flashing or using the OTA update feature.
Line 16: Line 30:
= Reporting a bug = === Perform a system update ===
Once you are running the ubuntu image you may perform a system update from the device itself. The images now prompt and even autoupdate if allowed. To manually update, select the 'system-settings' application, then click update. Once the download completes, press the install and restart button.
Line 18: Line 33:
== There is a crash file in /var/crash == [[attachment:update.gif|Visual Walkthrough of updating]]
Line 20: Line 35:
If the bug is a crash and there is a crash file in /var/crash, you can report it with apport. [[attachment:noupdate.png|Example of no updates found]]
Line 22: Line 37:
1. Connect to the device with adb == Step 2: Check to see what's changed ==
'''This step is optional.''' A list of changes between stable images can be [[http://people.canonical.com/~lzemczak/landing-team/|found here]]. The list contains the list of changing packages.
Line 24: Line 40:
{{{
  $ adb shell
}}}
Use these changes to help you understand what is new so you can check it for bugs.
Line 28: Line 42:
2. Check for any crash file in /var/crash == Step 3: 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.
Line 30: Line 45:
3. Report a bug with apport: * Use the device as you normally would as you go about daily activities.
Line 32: Line 47:
{{{
  $ apport-cli /var/crash/name_of_crash_file.crash
}}}
* Remember this is exploratory testing, so try and break things!
Line 36: Line 49:
4. Follow the instructions == Step 4: Report Bugs ==
Report any bugs you found while testing. See the [[QATeam/TouchTesting/BugReporting|Reporting a Bug page]] for details.
Line 38: Line 52:
5. To the question "What would you like to do? Your options are:", answer "S: Send report" == Step 5: Review Bugs ==
'''This step is optional.''' Review bugs found. If you did not find a new bug, seek to confirm existing bugs via triaging. You can also flag bugs as good candidates for tests to prevent future regressions.
Line 40: Line 55:
6. Wait for the upload to proceed === Confirm an existing bug ===
Not finding any bugs yourself? Look at [[QATeam/TouchTesting/BugReporting#Triaging|Triaging]] and confirm bugs others have found.
Line 42: Line 58:
7. Upon upload you'll be presented with a prompt like: === 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=touch-needs-autopilot| touch-needs-autopilot tag]]. Pick a testcase to [[https://wiki.ubuntu.com/Touch/CoreApps/Testing/ContributeAutopilotTestcase|automate using autopilot]] that tests the bug to ensure the same bug doesn't reappear. So we can track work happening on these bugs, follow this process while writing the test;
Line 44: Line 61:
{{{
*** To continue, you must visit the following URL:
 1. Remove the '''touch-needs-autopilot''' tag from the original bug
 1. Open a new bug against the same project, tagged with '''qa-touch-automated'''
 1. Assign yourself to the bug and update progress as usual. When you release the test, close the bug with fix released.
Line 47: Line 65:
  https://bugs.launchpad.net/ubuntu/+source/upstart-app-launch/+filebug/<UUID> = Tips and Tricks =
Line 49: Line 67:
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

What would you like to do? Your options are:
  S: Send report (4.3 KB)

https://bugs.launchpad.net/ubuntu/+source/maliit-framework/+filebug/<UUID>?
}}}

3. On your local machine, click on the link or copy/paste it into your browser.

= Test Activities =

Describe here any specific test activities.

= TODO =

* Add link to reference documentation (how to flash, specific testing like MIR, how to troubleshoot, ...)
Check out these [[QATeam/TouchTesting/Tips|handy tips]] to help you while testing.


Testing Ubuntu Touch

Welcome! This page contains the information you need to know to test ubuntu touch. Follow the steps outlined to keep your device updated and your testing relevant.

Setup

You should subscribe to the phone mailing list, and keep in mind the following IRC channels for help.

  • Mailing Lists - The ubuntu phone mailing list provides constant updates about what is happening on the phone images.

  • IRC - join the Ubuntu QA in #ubuntu-quality and and Ubuntu Touch #ubuntu-touch IRC channels on freenode if you need realtime help.

You also need to flash your phablet device with the latest proposed image.

Install the current development image

Flash your phone to the latest proposed image. If you have not yet bootstrapped or unlocked your phone's bootloader, see the install page for more information.

To test with the proposed image:

  $ ubuntu-device-flash  --channel=devel-proposed

Test process

This describes the daily process of testing. We will flash our devices, read what's changed, and look for bugs.

Step 1: Update

You need a phone or tablet with the latest development proposed image. If needed, install the current development image now by flashing or using the OTA update feature.

Perform a system update

Once you are running the ubuntu image you may perform a system update from the device itself. The images now prompt and even autoupdate if allowed. To manually update, select the 'system-settings' application, then click update. Once the download completes, press the install and restart button.

Visual Walkthrough of updating

Example of no updates found

Step 2: Check to see what's changed

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

Use these changes to help you understand what is new so you can check it for bugs.

Step 3: 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.

* Use the device as you normally would as you go about daily activities.

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

Step 4: Report Bugs

Report any bugs you found while testing. See the Reporting a Bug page for details.

Step 5: Review Bugs

This step is optional. Review bugs found. If you did not find a new bug, seek to confirm existing bugs via triaging. You can also flag bugs as good candidates for tests to prevent future regressions.

Confirm an existing bug

Not finding any bugs yourself? Look at Triaging and confirm bugs others have found.

Add a testcase for reported bugs

Once testing is completed, review the list of reported bugs with the touch-needs-autopilot tag. Pick a testcase to automate using autopilot that tests the bug to ensure the same bug doesn't reappear. So we can track work happening on these bugs, follow this process while writing the test;

  1. Remove the touch-needs-autopilot tag from the original bug

  2. Open a new bug against the same project, tagged with qa-touch-automated

  3. Assign yourself to the bug and update progress as usual. When you release the test, close the bug with fix released.

Tips and Tricks

Check out these handy tips to help you while testing.

QATeam/TouchTesting (last edited 2015-01-22 17:18:23 by knome)