Many Web sites serve Firefox for Android different content than that served to other mobile browsers. This content is may be:
- basic mobile site
- traditional desktop site
- WAP (Wireless Application Protocol) site designed for a feature phone
- touch optimized mobile site that is broken visibly or functionally
This different content is often the result of:
- Sniffing the target browser’s user agent to send differing content to Firefox for Android
In the first case, Firefox does not receive good, mobile content. In the second case, Firefox does not recognize the content that it is sent. We refer to these issues as Web compatibility issues as a site that exhibits these issues is not compatible with all browsers.
The mobile Web is like the sea - vast. Our goal, is to open up the mobile Web to all mobile browsers via promotion of standards and best practices.
We need your help to identify sites that do not work well in Firefox by reporting the specific issues that you find in your investigation.
Outlined below are steps that you can follow to identify and report site issues.
To start, let's set up your hardware and software for compatibility testing.
- An Android phone is a prerequisite for testing Firefox for Android. See our list of supported devices for Firefox for Android to ensure that your phone is supported.
- Install Firefox for Android from Google Play.
- Install the Phony Add-on for Firefox on Android. This add-on lets Firefox for Android pretend to be another browser by changing the identifying information (user-agent) that is sent with each HTTP request.
- Set up an account on bugzilla so that you can report issues.
- Install Firefox for Android for a different release channel: Beta, Aurora, and Nightly.
- You can try to reproduce and debug issues that you discover in Firefox Desktop. Install Firefox for Windows, Linux or Mac OS X and an add-on like Phony for the desktop. (See the arcticle Browser detection using the user agent for an in-depth explanation about browser user-agents.)
On to testing. The following steps walk you through the method that Mozilla QA uses for compatibility testing:
- Select a site to test.
- This may be a site that you have already visited and seen that something is off in your daily browser usage.
- Alternatively, you can select one of the top sites listed on the Are We Compatible Yet report. Sites that have not yet been investigated are shown in white.
- Open the site that you selected in Firefox for Android. Test the functionality of the site by exploring different areas of the site. For example, if the site displays articles, pictures, and videos, you should explore all three areas of the site. Click on links, use forms, create accounts, sign in, and question:
- Is the site a desktop site? If so, skip to #3 and #4 to determine if Safari on iPhone and the Android browser are served the same desktop content.
- Does the site have obvious layout problems? Are elements positioned on top of one another? Is there missing content? Do menus display correctly? Are header background colors correct? Are areas of the page shown correctly? Does the site simply look bad?
- Visit the same website using your device’s Android browser, using the same exploration methods in #2, and question:
- Is the site a desktop site? Does the content greatly differ than what you saw on Firefox for Android? If so, how is it different? Is it a mobile optimized site?
- Are there any similar layout issues as seen in Firefox for Android? If so, what problems do you see with Firefox for Android that you do not see in the Android browser?
- Make Firefox for Android appear to the site as though it is Safari on iPhone by clicking Menu->Phony and selecting iPhone. (You can try other browsers as well.) After selecting iPhone click Menu->Reload. Visit the same site again and continue with the same exploration methods in #2 and question:
- Is the site a desktop site? Does the content greatly differ than what you previously saw in Firefox for Android? If so, how is it different? Is it a mobile optimized site?
- Does the site have any layout problems? If so, what are those problems?
For any site that looks or functions differently in Firefox for Android, the Android browser, or Safari on iPhone you should report each issue in Bugzilla. To report an issue, file a bug in the Fennec Native Evangelism component and provide as much information about the issue as you can. Here are some pieces of information that are typically helpful to submit with your report:
- Summarize the issue that you have identified with the site. It is helpful to include the domain name, such as mozilla.org, in the summary.
Describe the issue as best as you can. Include details such as how the content differs between Firefox for Android, Android browser, and Safari on iPhone, the specific places (titles, article list, options menu) where the site does not look correct, and what parts of the site (articles are unreadable, videos don't play, can't click on links) that do not function as you expected that they would.
- It is also valuable to attach a screen capture that shows the problem in Firefox for Android. How to take a screenshot on Android differs based on your version of the operating system.
If you have any questions about compatibility testing or want to become involved in Mozilla’s mobile Web compatibility effort, please sign up for the firstname.lastname@example.org mailing list.