1. Getting started with Firefox OS and Open Web Apps

2. 14:30 Introduction
15:30 Get set up
15:45 Start first app
16:30 Break
16:45 Hacking
Agenda:

6. Using HTML5, CSS and
JavaScript together with a
number of APIs to build
apps and customize the UI.
Firefox OS

7. Foxconn

8. Open Web Apps

10. HTML5 + manifest file (JSON)

11. Steps to Take

12. Develop Web App using
HTML5, CSS, & Javascript1.
Create an app manifest file2.
Publish/install the app3.

14. 1.Develop Web App using
HTML5, CSS & JavaScript

15. Reuse any existing web site/app or develop from scratch
with open web standards.
Utilize HTML5 features such as localStorage, offline
manifest, IndexedDB and access Web APIs for more options.
Responsive web design for adapting to varying resolutions
and screen orientation.

16. 2.Create an app manifest file

17. Create a file with a .webapp extension

18. {
"version": "1",
"name": "Firefox OS Boilerplate App",
"launch_path": "/index.html",
"description": "Boilerplate Firefox OS app",
"icons": {
"16": "/images/logo16.png",
"32": "/images/logo32.png",
"48": "/images/logo48.png",
"64": "/images/logo64.png",
"128": "/images/logo128.png"
},
"developer": {
"name": "Robert Nyman",
"url": "http://robertnyman.com"
},
"installs_allowed_from": ["*"],
"default_locale": "en"
}

19. MANIFEST CHECKER
http://appmanifest.org/

20. Serve with Content-type/MIME type:
application/x-web-app-manifest+json

21. Apache - in mime.types:
application/x-web-app-manifest+json webapp
Apache - in .htaccess:
AddType application/x-web-app-manifest+json webapp
NGinx - in mime.types:
types {
text/html html htm shtml;
text/css css;
text/xml xml;
application/x-web-app-manifest+json webapp;
}

22. IIS:
In IIS Manager, right-click the local
computer, and click Properties.
Click the MIME Types button.
Click New.
In the Extension box, type the file name
extension.
In the MIME type box, type a description
that exactly matches the file type defined
on the computer.
Click OK.

23. curl -I http://mozillalabs.com/manifest.webapp

24. 3.Publish/install the app

25. Firefox Marketplace

26. https://marketplace.firefox.com/

27. https://marketplace.firefox.com/developers/

28. Installing/hosting the app

29. var request = navigator.mozApps.install(
"http://robnyman.github.com/Firefox-OS-Boilerplate-App/manifest.webapp",
{
user_id: "some_user"
}
);
request.onsuccess = function() {
// Success! Notification, launch page etc
}
request.onerror = function() {
// Failed. this.error.name has details
}

30. Build excellent interfaces!

31. Packaged & hosted apps

32. WebAPIs

34. Security Levels

35. Web Content
Regular web content
Installed Web App
A regular web app
Privileged Web App
More access, more responsibility
Certified Web App
Device-critical applications

36. https://wiki.mozilla.org/
WebAPI#Planned_for_initial_release_of_B2G_.28aka_Basecamp.29

37. "permissions": {
"contacts": {
"description": "Required for autocompletion in the share screen",
"access": "readcreate"
},
"alarms": {
"description": "Required to schedule notifications"
}
}

38. PERMISSIONS

39. Vibration API (W3C)
Screen Orientation
Geolocation API
Mouse Lock API (W3C)
Open WebApps
Network Information API (W3C)
Battery Status API (W3C)
Alarm API
Web Activities
Push Notifications API
WebFM API
WebPayment
IndexedDB (W3C)
Ambient light sensor
Proximity sensor
Notification
REGULAR APIS

40. BATTERY STATUS
API

41. var battery = navigator.battery;
if (battery) {
var batteryLevel = Math.round(battery.level * 100) + "%",
charging = (battery.charging)? "" : "not ",
chargingTime = parseInt(battery.chargingTime / 60, 10),
dischargingTime = parseInt(battery.dischargingTime / 60, 10);
// Set events
battery.addEventListener("levelchange", setStatus, false);
battery.addEventListener("chargingchange", setStatus, false);
battery.addEventListener("chargingtimechange", setStatus, false);
battery.addEventListener("dischargingtimechange", setStatus, false);
}

42. NOTIFICATION

43. var notification = navigator.mozNotification;
notification.createNotification(
"See this",
"This is a notification",
iconURL
);

44. SCREEN
ORIENTATION API

45. // Portrait mode:
screen.mozLockOrientation("portrait");
/*
Possible values:
"landscape"
"portrait"
"landscape-primary"
"landscape-secondary"
"portrait-primary"
"portrait-secondary"
*/

46. VIBRATION API

47. // Vibrate for one second
navigator.vibrate(1000);
// Vibration pattern [vibrationTime, pause,…]
navigator.vibrate([200, 100, 200, 100]);
// Vibrate for 5 seconds
navigator.vibrate(5000);
// Turn off vibration
navigator.vibrate(0);

48. WEB PAYMENTS

49. var pay = navigator.mozPay(paymentToken);
pay.onsuccess = function (event) {
// Weee! Money!
};

51. mozmarket.receipts.Prompter({
storeURL: "https://marketplace.mozilla.org/app/myapp",
supportHTML: '<a href="mailto:me@example.com">email
me@example.com</a>',
verify: true
});

53. NETWORK
INFORMATION API

54. var connection = window.navigator.mozConnection,
online = connection.bandwidth > 0,
metered = connection.metered;

55. ALARM API

56. var alarmId1,
request = navigator.mozAlarms.add(
new Date("May 15, 2012 16:20:00"),
"honorTimezone",
{
mydata: "my event"
}
);
request.onsuccess = function (event) {
alarmId1 = event.target.result;
};
request.onerror = function (event) {
console.log(event.target.error.name);
};

57. var request = navigator.mozAlarms.getAll();
request.onsuccess = function (event) {
console.log(JSON.stringify(event.target.result));
};
request.onerror = function (event) {
console.log(event.target.error.name);
};

58. navigator.mozSetMessageHandler(
"alarm",
function (message) {
// Note: message has to be set in the manifest file
console.log("Alarm fired: " + JSON.stringify(message));
}
);

59. DEVICEPROXIMITY

60. window.addEventListener("deviceproximity", function (event) {
// Current device proximity, in centimeters
console.log(event.value);
// The maximum sensing distance the sensor is
// able to report, in centimeters
console.log(event.max);
// The minimum sensing distance the sensor is
// able to report, in centimeters
console.log(event.min);
});

61. AMBIENT LIGHT
EVENTS

62. window.addEventListener("devicelight", function (event) {
// The lux values for "dim" typically begin below 50,
// and the values for "bright" begin above 10000
console.log(event.value);
});

63. PAGE VISIBILITY

64. document.addEventListener("visibilitychange", function () {
if (document.hidden) {
console.log("App is hidden");
}
else {
console.log("App has focus");
}
});

65. Device Storage API
Browser API
TCP Socket API
Contacts API
systemXHR
PRIVILEGED APIS

66. DEVICE STORAGE
API

67. var deviceStorage = navigator.getDeviceStorage("videos");

68. var storage = navigator.getDeviceStorage("videos"),
cursor = storage.enumerate();
cursor.onerror = function() {
console.error("Error in DeviceStorage.enumerate()", cursor.error.name);
};
cursor.onsuccess = function() {
if (!cursor.result)
return;
var file = cursor.result;
// If this isn't a video, skip it
if (file.type.substring(0, 6) !== "video/") {
cursor.continue();
return;
}
// If it isn't playable, skip it
var testplayer = document.createElement("video");
if (!testplayer.canPlayType(file.type)) {
cursor.continue();
return;
}
};

69. CONTACTS API

70. var contact = new mozContact();
contact.init({name: "Tom"});
var request = navigator.mozContacts.save(contact);
request.onsuccess = function() {
console.log("Success");
};
request.onerror = function() {
console.log("Error")
};

71. WebTelephony
WebSMS
Idle API
Settings API
Power Management API
Mobile Connection API
WiFi Information API
WebBluetooth
Permissions API
Network Stats API
Camera API
Time/Clock API
Attention screen
Voicemail
CERTIFIED APIS

72. WEBTELEPHONY

73. // Telephony object
var tel = navigator.mozTelephony;
// Check if the phone is muted (read/write property)
console.log(tel.muted);
// Check if the speaker is enabled (read/write property)
console.log(tel.speakerEnabled);

74. // Place a call
var cal = tel.dial(“123456789”);

75. // Receiving a call
tel.onincoming = function (event) {
var incomingCall = event.call;
// Get the number of the incoming call
console.log(incomingCall.number);
// Answer the call
incomingCall.answer();
};
// Disconnect a call
call.hangUp();
// Iterating over calls, and taking action depending on their
changed status
tel.oncallschanged = function (event) {
tel.calls.forEach(function (call) {
// Log the state of each call
console.log(call.state);
});
};

76. WEBSMS

77. // SMS object
var sms = navigator.mozSMS;
// Send a message
sms.send("123456789", "Hello world!");

78. // Recieve a message
sms.onreceived = function (event) {
// Read message
console.log(event.message);
};

79. WEB ACTIVITIES

80. Interacting with the camera

82. var activity = new MozActivity({
name: "view",
data: {
type: "image/png",
url: ...
}
});
activity.onsuccess = function () {
console.log("Showing the image!");
};
activity.onerror = function () {
console.log("Can't view the image!");
};

83. {
"activities": {
"share": {
"filters": {
"type": ["image/png", "image/gif"]
}
"href": "sharing.html",
"disposition": "window"
}
}
}

84. var register = navigator.mozRegisterActivityHandler({
name: "view",
disposition: "inline",
filters: {
type: "image/png"
}
});
register.onerror = function () {
console.log("Failed to register activity");
}

85. navigator.mozSetMessageHandler("activity", function (a) {
var img = getImageObject();
img.src = a.source.url;
// Call a.postResult() or a.postError() if
// the activity should return a value
});

87. Future APIs

89. Resource lock API
UDP Datagram Socket API
Peer to Peer API
WebNFC
WebUSB
HTTP-cache API
Calendar API
Spellcheck API
LogAPI
Keyboard/IME API
WebRTC
FileHandle API
Sync API

90. Web Apps from Mozilla

92. Dialer
Contacts
Settings
SMS
Web browser
Gallery
Video Player
Music Player
E-mail (POP, IMAP)
Calendar
Alarm Clock
Camera
Notes
First Run Experience
Notifications
Home Screen
Mozilla Marketplace
System Updater
Localization Support

94. Web Components & Mozilla Brick

95. http://mozilla.github.io/brick/

96. <x-flipbox>
<div>I'm the front face.</div>
<div>And I'm the back face.</div>
</x-flipbox>

97. // assume that toggleButton and flipBox are already
// defined as their respective DOM elements
toggleButton.addEventListener("click", function(){
flipBox.toggle();
});

98. appbar
calendar
datepicker
deck
flipbox
iconbutton
layout
slidebox
slider
tabbar
toggle
togglegroup
tooltip

99. Get started

100. https://addons.mozilla.org/firefox/addon/firefox-os-
simulator/

101. FIREFOX OS
BOILERPLATE APP
https://github.com/robnyman/Firefox-OS-Boilerplate-App

102. Trying things out

104. Robert Nyman
robertnyman.com
robert@mozilla.com
Mozilla
@robertnyman