Marketplace/Reviewers/Apps/Guide/Setup/Cert installation

From MozillaWiki
< Marketplace‎ | Reviewers‎ | Apps‎ | Guide‎ | Setup
Revision as of 02:44, 1 April 2016 by Ddurst (talk | contribs) (added banner)
Jump to navigation Jump to search
Stop (medium size).png
The Marketplace has been placed into maintenance mode. It is no longer under active development. You can read complete details here.

This page is only necessary for FirefoxOS pre 2.0. See Setup for alternative instructions.

The scripts are available in the Marketplace Certs repository. There is a detailed readme available though in short the procedure for installing reviewer certs is below:

Prerequisite: Install the Android SDK Tools/ADB

Install the Android SDK Tools/ADB if you haven't done that already.

Quick Procedure

This simplified procedure will enable you to install apps from the reviewer pages on the following instances of Marketplace:

Download the zip containing the patched certificates and extract the contents.

  • Windows:
    1. Install git or cygwin
    2. Open a terminal of the environment you just installed, change to the extracted directory and type
    3. ./setupcerts-fxos.sh
  • Linux Mac:
    1. Open a terminal window, change to the extracted directory and type
    2. chmod u+x setupcerts-fxos.sh ; ./setupcerts-fxos.sh

Manual Procedure

1. Prerequisites
  1. Install NSS Tools
    • Debian/Ubuntu: sudo apt-get install libnss3-tools
    • Fedora: su -c "yum install nss-tools"
    • openSUSE: sudo zypper install mozilla-nss-tools
    • Mac OS (via Homebrew): brew install nss
    • Windows: Setting up a general Windows build environment is a non-trivial process that requires a lot of effort. For installing the NSS Tools, see the docs on MDN.
2. Download the certificates

Download a snapshot of the Marketplace certs repository and extract it or clone the repository with this command: git clone git://github.com/mozilla/marketplace-certs.git

3. Find your device name

In a terminal window and with your phone's screen turned on and unlocked, type in adb devices and note the device name in the result. You need to use this in steps 4 and 5.

4. Build the certificate database

Open a terminal window and navigate to the marketplace-certs folder created in step 2 and enter the following commands:

rm -Rf certdb.tmp
./new_certdb.sh certdb.tmp
./add_or_replace_root_cert.sh certdb.tmp root-ca-reviewers-marketplace
./add_or_replace_root_cert.sh certdb.tmp marketplace-dev-public-root
./add_or_replace_root_cert.sh certdb.tmp marketplace-dev-reviewers-root
./add_or_replace_root_cert.sh certdb.tmp marketplace-stage-public-root
./add_or_replace_root_cert.sh certdb.tmp marketplace-paymentsalt-public-root

For this next command, replace full_unagi with the name you got from adb in step 3. So for example, for a Keon device you would change full_unagi to full_keon.

./change_trusted_servers.sh full_unagi "https://marketplace-dev.allizom.org,https://marketplace.allizom.org,https://payments-alt.allizom.org,https://marketplace.firefox.com"
5. Install the certificates and reboot

Send the new certificate database you created to the device and reboot it:

./push_certdb.sh full_unagi certdb.tmp
adb reboot

Remember to replace full_unagi with the name you got from adb in step 3.

You should now be able to install packaged apps from both the production, development, stage and payments-alt instances of Marketplace.