Testing the preview flow on iOS
Launching an experiment to Preview the stage server
The first step to testing the preview flow is to launch an experiment to preview on the stage nimbus server (we should not using the production server for testing). Go to the stage experimenter and create your experiment there.
Pointing a local iOS build to the stage server
Since we will be using the stage server, we want Firefox to look for experiments there. For iOS, you can do that on a local build, which you can get running by following the instructions on the
Once you have a local build using xcode, you should replace
https://firefox.settings.services.allizom.org/v1/. You can set that on
info.plist, which lies in the
Client directory once you have the project setup.
NIMBUS_URL will have an initial value of
$(NIMBUS_URL), replace that with the setting server's url.
Accessing the secret menu
At this point, you can run your local build of Firefox iOS, once it's run:
Access the settings menu and click 5 times on the
Firefox Daylight 0.0.1under the about section:
Scroll all the way to the bottom and click the
Editon the top right.
Use Preview Collection (requires restart)option.
Resetand restart the app.
Repeat the steps 1-2, and you should now see the experiment you launched to preview!
You can also check out this visual documentation for a clear demonstration of how to switch to the preview collection.
- What kind of experiment should I create?
If you would like your test to be more in-depth, we recommend you create an iOS experiment that can be directly tested on the UI. For example, you can create an
onboarding-default-browser experiment by setting the feature config to
onboarding-default-browser and setting the appropriate values, check out this experiment on experimenter for a complete example
- I don't see my experiments on Firefox!
It takes a little time, but if you still can't see the experiments, try restarting the app and double check that you launched your experiment to preview and set the
Firefox iOS and didn't miss any configuration on experimenter. If you keep facing trouble reach out to use on #ask-experimenter on slack!