mozilla / kitchensink-app

INACTIVE - http://mzl.la/ghe-archive - The Kitchen sink Application will be a tool to test the functionality of the APIs across platforms as well as showcase the usage of the APIs. Tracking bug: https://bugzilla.mozilla.org/show_bug.cgi?id=830876

KitchenSink App

The Kitchen sink Application will be a tool to test the functionality of the APIs across platforms as well as showcase the usage of the APIs.

Tracking bug: https://bugzilla.mozilla.org/show_bug.cgi?id=830876

FxOS Installation

Easily install packaged and hosted apps using the Firefox OS remote debugging protocols.

How it works

1. Makefile: (Packaged app only) Package all files from folder into application.zip
2. Makefile: Move important files to phone via adb
3. Makefile: Forward remote debugging port (6000) from device to computer (via adb)
4. Makefile: Run install.js via xpcshell
5. install.js: Remotely install app from folder using the Webapp Actor.

Dependencies

Extract the following packages ~/bin.

If you choose a different path, change the variables in Makefile):

XPCSHELL = ~/bin/xulrunner-sdk/bin/xpcshell
ADB = ~/bin/android-sdk/platform-tools/adb

XULRunner (XPCShell)

http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/18.0.2/runtimes/

Android SDK (ADB)

http://developer.android.com/sdk/index.html#download

Device Setup

Enable Remote Debugging in Settings > Device Information > Developer.

Usage

Packaged

See folder my-package. Your app should at least have an index.html and a manifest.webapp with the correct launch_path. App type can be either web or privileged.

Install packaged app from folder ``

make FOLDER=my-package packaged install

Hosted

See my-hosted folder. Your folder only needs to contain manifest.webapp and a metadata.json. In most cases you only need to adapt origin in metadata.json and launch_path in the manifest.

Install hosted app from folder my-hosted:

make FOLDER=my-hosted hosted install

kitchensink-app's Issues

CODE_OF_CONDUCT.md file missing

As of January 1 2019, Mozilla requires that all GitHub projects include this CODE_OF_CONDUCT.md file in the project root. The file has two parts:

1. Required Text - All text under the headings Community Participation Guidelines and How to Report, are required, and should not be altered.
2. Optional Text - The Project Specific Etiquette heading provides a space to speak more specifically about ways people can work effectively and inclusively together. Some examples of those can be found on the Firefox Debugger project, and Common Voice. (The optional part is commented out in the raw template file, and will not be visible until you modify and uncomment that part.)

If you have any questions about this file, or Code of Conduct policies and procedures, please reach out to [email protected].

(Message COC001)

Wiki changes

FYI: The following changes were made to this repository's wiki:

• defacing spam has been removed

• the wiki has been disabled, as it was not used

These were made as the result of a recent automated defacement of publically writeable wikis.