ezboot 1.0.22

Source

The source is available at https://github.com/kumar303/ezboot/

Marionette

For this script to work you must flash your device with a B2G build that has Marionette enabled. The flash command will do that for you. Read this if you want to build various flavors of B2G with Marionette support yourself.

First Timers

You’ll try anything at least once, right? The very first time you run ezboot flash you probably need to enable Remote Debugging first by digging into Settings > Device Information > More Information > Developer. Otherwise, adb won’t be able to connect. This only applies if you had flashed with a B2G build that did not have Marionette enabled. If you’ve never installed B2G at all then you need to enable debugger connections on Android.

Config file

You can set defaults for all argument values by creating an ezboot.ini file in the working directory. Make a section for each sub command with long argument names as keys. For example:

[setup]
wifi_ssid = mywifi
wifi_key = WPA-PSK
wifi_pass = my secure password with spaces
apps = https://marketplace-dev.allizom.org/manifest.webapp
       https://marketplace.allizom.org/manifest.webapp

[flash]
flash_user = ...
flash_pass = ...

flash

This downloads a build and flashes it to your device. Here is a full reference:

ezboot flash --help

You will have to specify which device you want to flash since every device has a separate build that must be used to flash it. You can do that like so:

ezboot flash --flash_device unagi

or, if you have the URL of your build, then do it like so:

ezboot flash --flash_url http://pvtbuilds.mozilla.org/...

You can also set these in your ezboot.ini config file:

[flash]
flash_device = unagi/inari

or

[flash] flash_url = http://pvtbuilds.mozilla.org/…

Note, that if you set both flash_url and flash_device, the value provided for flash_url will override the default URL for the device value you have provided. Please refer to the full reference.

Rest of the defaults will probably work for you. If you don’t want to be prompted for your username/password each time, you can save them in an ezboot.ini config file:

[flash]
flash_user = the_user
flash_pass = secret$password

Captain Obvious says don’t commit your password to a public repo.

setup

This sets up your flashed device for usage. Here is the full reference:

ezboot setup --help

It can do the following:

• configure WiFi

• pre-install some apps

• put custom prefs on the device

The --apps argument takes multiple values. In a config file, add them one per line in an ezboot.ini config file like this:

[setup]
apps = https://marketplace-dev.allizom.org/manifest.webapp
       https://marketplace.allizom.org/manifest.webapp
wifi_ssid = ...
wifi_key = WPA-PSK
wifi_pass = ...

By convention, if you put a custom prefs file in ./ezboot/custom-prefs.js where dot is the working directory then it will be pushed to /data/local/user.js on the device. Any existing custom prefs are not preserved.

dl

This downloads a build and saves the Zip file to a custom directory. The build will not be flashed to a device and any subsequent reflash command will not attempt to use it. This is just a convenient way to grab a build without logging in; the same user/pass options from flash apply here.

Here is a full reference:

ezboot dl --help

You can set a custom location with ezboot dl --location=.... By default it will save builds to ~/Downloads.

http

This restarts your phone with HTTP logging temporarily enabled. Here is the full reference:

ezboot http --help

This runs B2G on the device until you interrupt it (^C). After you’re finished the console will tell you where to find a log of all HTTP requests/responses. When you view the file it might warn you that it has binary content but that’s typically just at the beginning of the file. Keep paging.

login

Make sure a Persona screen is open on the device then type ezboot login. Here is a reference:

ezboot login --help

This lets you type the username / password to a new Persona account from your nice desktop keyboard instead of the device keypad. In a real world situation this wouldn’t be as annoying since Persona remembers who you are but for development you’ll be typing new accounts all the time for testing.

kill

This kills all running apps which may be useful when you need to reload styles, js or other assets.

ezboot kill --help

The recss command might be faster.

recss

This reloads all stylesheets on the current frame. More info:

ezboot recss --help