Compatibility/Tools: Difference between revisions

Compatibility/Tools (view source)

Revision as of 04:10, 10 January 2014

1,216 bytes added , 10 January 2014

→‎Things to think about when testing: Documenting UA override management script

Karlcow

Confirmed users

1,567

edits

@@ Line 96: / Line 96: @@
 == Things to think about when testing ==
-* '''Clearing cookies and storage information.''' Some Web sites, once it has been accessed the first time, will add a cookie for keeping your preferences. Some of these cookies might be for the type of site such as mobile or desktop. It is better to clear the cookies and storage information, if you need to test the site as a first user.
+=== Clearing cookies and storage information ===
-* '''Remove UA override already installed.''' Currently Firefox OS devices have a [[UA/override|UA override mechanism]]. It helps users to get a mobile version even if the site is not doing the identification properly. The unfortunate consequence is that it becomes harder for testing. So it is necessary to remove the UA override from the device.
-** On 1.0 and 1.1, Firefox OS has an in-device list that you can edit with [https://github.com/karlcow/webcompat/blob/master/moz/mozua.sh mozua.sh].
+Some Web sites, once it has been accessed the first time, will add a cookie for keeping your preferences. Some of these cookies might be for the type of site such as mobile or desktop. It is better to clear the cookies and storage information, if you need to test the site as a first user.
-** On 1.2, the list is dynamic and updated through a server side mechanism, you can deactivate the list entirely through preferences: set "general.useragent.updates.enabled" to false
+=== Firefox OS UA Override ===
+Currently Firefox OS devices have a [[UA/override|UA override mechanism]]. It helps users '''for certain sites''' to get a mobile version even if the site is not doing the identification properly. The unfortunate consequence is that it becomes harder for testing. So it is necessary to remove the UA override from the device.
+==== Firefox OS 1.0, 1.1: ====
+The list is harcoded on the device. It means the update for all users depend on carriers updating the system and sending the new list to the device. It is possible to remove or add manually each individual domain with a [https://github.com/karlcow/webcompat/blob/master/moz/mozua.sh bash script] controlling [https://developer.android.com/tools/help/adb.html adb].
+==== Firefox OS 1.2+ ====
+The list is managed server side on Mozilla servers. There is a preference to put on and off to complete disable or enable the UA override. We created a [https://github.com/karlcow/webcompat/blob/master/moz/mozua2.sh script] to manage this preference. It is using [https://developer.android.com/tools/help/adb.html adb] too. You can deactivate the list entirely through preferences: set "general.useragent.updates.enabled" to false
+==== Install UA overrride management script ====
+On Unix (or mac), create a bin/ directory in your $HOME directory. The sequence of commands you could do for this (Assuming you are using Firefox OS 1.2 and adb is installed)
+   cd
+   mkdir bin
+   cd bin
+   # download the script mozua2.sh in bin
+   curl -O https://raw2.github.com/karlcow/webcompat/master/moz/mozua2.sh
+   chmod 700 mozua2.sh
+Nous you are able to use the script.
+   # enable  UA override (default on the device)
+   mozua2.sh override on
+   # disable UA override
+   mozua2.sh override off
+Note. There are still features to implement on this script such as adding one specific domain and removing it locally.
 [[Category:Mobile]]
 [[Category:Web Compatibility]]