Marketplace/Reviewers/Apps/Guide/Setup: Difference between revisions

From MozillaWiki
< Marketplace‎ | Reviewers‎ | Apps‎ | Guide
Jump to navigation Jump to search
(Added dom.mozApps.signed_apps_installable_from to the instructions for Desktop)
Line 36: Line 36:


===Firefox 29 - 30===
===Firefox 29 - 30===
====Android and Desktop====
 
* Deprecated - its recommended to use Firefox 31 or higher instead (see below)
* Deprecated - its recommended to use Firefox 31 or higher instead (see below)If testing on these versions is necessary, an [https://addons.mozilla.org/en-US/android/addon/mkt-app-reviewer-certs/ add-on] can be installed to add reviewer certificates.
* If testing on these versions is necessary, an [https://addons.mozilla.org/en-US/android/addon/mkt-app-reviewer-certs/ add-on] can be installed to add reviewer certificates.


===Firefox 31+===
===Firefox 31+===
No add-on needed.  You just need to set the preference ''dom.mozApps.use_reviewer_certs'' to ''true''.
No add-on needed.  You just need to set the preference ''dom.mozApps.use_reviewer_certs'' to ''true''.  For Desktop, you also need to edit another pref to add the url for Marketplace-dev.
 
TODO: also include dom.mozApps.signed_apps_installable_from


====Android====
====Android====
Line 49: Line 46:


# Launch the browser.
# Launch the browser.
# In the URL field, type ''about:config'' and hit enter.
# In the URL field, type <code>about:config</code> and hit enter.
# Tap the big plus sign in the upper left corner to add a new preference.
# Tap the big plus sign in the upper left corner to add a new preference.
# In the Name field, type ''dom.mozApps.use_reviewer_certs''.  NOTE: this name is case sensitive, so make sure to type it exactly as shown.  The lower case ''dom'' is often (mis-)corrected to ''Dom.''
# In the Name field, type <code>dom.mozApps.use_reviewer_certs</code>.  NOTE: this name is case sensitive, so make sure to type it exactly as shown.  The lower case ''dom'' is often (mis-)corrected to ''Dom.''
# Tap the Toggle button to change the value shown under the name from ''false'' to ''true''.
# Tap the Toggle button to change the value shown under the name from ''false'' to ''true''.
# Tap ''Create'' and you're done!
# Tap ''Create'' and you're done!
====Desktop ====
====Desktop ====
# Launch the browser.
# Launch the browser.
# In the URL field, type ''about:config'' and hit enter.
# In the URL field, type <code>about:config</code> and hit enter.
# Right-click on one of the preferences in the list to add a new boolean preference - New|Boolean.
# Right-click on one of the preferences in the list to add a new boolean preference - New|Boolean.
# In the Name prompt, type ''dom.mozApps.use_reviewer_certs''.  NOTE: this name is case sensitive, so make sure to type it exactly as shown.
# In the Name prompt, type <code>dom.mozApps.use_reviewer_certs</code>.  NOTE: this name is case sensitive, so make sure to type it exactly as shown.
# For the next prompt chose ''true'' as the boolean value.
# For the next prompt chose ''true'' as the boolean value and click OK.
# Once you press Okay the preference is created and you're done!
# Search for <code>dom.mozApps.signed_apps_installable_from</code> and double click the line.
# Change the text to <code>https://marketplace.firefox.com,https://marketplace-dev.allizom.org</code>.  Make sure there's no space after the comma separating the two urls.
# Once you press OK the preference is updated and you're done!
<br style="clear:both;" />
<br style="clear:both;" />



Revision as of 02:46, 5 March 2015

These instructions are needed to setup the device/browser to install packaged apps from the reviewer pages. No extra setup is needed to install hosted apps.

FirefoxOS

Root access (pre FxOS2.1)

To install/setup reviewer certificate access in versions before FxOS2.1, the device needs to be rooted. In FxOS2.1 and above this is no long nessecary. Geeksphone and Alcatel One Touch devices are typically shipped rooted, operator provided devices are typically not. You can test this by typing 'adb root' after installing the ADB - see below - (if it says it can't be run in production builds then certificate installation isn't going to work). Rooting your device is outside of the scope of this page but you may be able to find instructions on the internet, and is obviously taken at your own risk, etc.

Installing ADB:

  1. install the full Android SDK and make sure $ADT/sdk/platform-tools is on your path
  2. or get ADB and Fastboot only. You will need to rename or create links so 'adb' resolves to the executable on your platform.

FxOS version: 1.1 - 1.4

You must root the phone and install ADB.

Installing reviewer certificates: Marketplace/Reviewers/Apps/Guide/Setup/Cert installation

FxOS version: 2.0

You must root the phone and install ADB.

You don't need to install certificates; the system preference dom.mozApps.use_reviewer_certs just needs to be set to true.

  1. connect the device with a USB cable and install any drivers needed.
  2. open a command/terminal window
  3. type "adb shell" to open a adb shell and then the following commands to set the preference:
    1. stop b2g
    2. cd /data/b2g/mozilla/*.default/
    3. echo 'user_pref("dom.mozApps.use_reviewer_certs", true);' >> prefs.js
    4. start b2g

FxOS 2.1+

You don't need to install any certificates, and the system preference to enable reviewer access is in the developer menu of the Gaia settings app.

Enabling the Marketplace Reviewer Certs

Firefox Desktop and Android

Firefox 29 - 30

  • Deprecated - its recommended to use Firefox 31 or higher instead (see below). If testing on these versions is necessary, an add-on can be installed to add reviewer certificates.

Firefox 31+

No add-on needed. You just need to set the preference dom.mozApps.use_reviewer_certs to true. For Desktop, you also need to edit another pref to add the url for Marketplace-dev.

Android

Reviewer cert pref.png

Follow these steps to enable the preference to use the built-in reviewer certificates on Android:

  1. Launch the browser.
  2. In the URL field, type about:config and hit enter.
  3. Tap the big plus sign in the upper left corner to add a new preference.
  4. In the Name field, type dom.mozApps.use_reviewer_certs. NOTE: this name is case sensitive, so make sure to type it exactly as shown. The lower case dom is often (mis-)corrected to Dom.
  5. Tap the Toggle button to change the value shown under the name from false to true.
  6. Tap Create and you're done!

Desktop

  1. Launch the browser.
  2. In the URL field, type about:config and hit enter.
  3. Right-click on one of the preferences in the list to add a new boolean preference - New|Boolean.
  4. In the Name prompt, type dom.mozApps.use_reviewer_certs. NOTE: this name is case sensitive, so make sure to type it exactly as shown.
  5. For the next prompt chose true as the boolean value and click OK.
  6. Search for dom.mozApps.signed_apps_installable_from and double click the line.
  7. Change the text to https://marketplace.firefox.com,https://marketplace-dev.allizom.org. Make sure there's no space after the comma separating the two urls.
  8. Once you press OK the preference is updated and you're done!


Other helpful tools