View source for SmartPhone Code Transition

<div style="float: right; margin: 0px 0px 10px 25px;">[[File:Fxossmall.png|link=]]</div>

=='''Project Description'''==

The purpose of this project is to reduce the maintenance cost of the Firefox OS for smartphone code and get it into a state where the volunteer contributor community can successfully take the lead and ownership for the future direction of the b2g for smartphone code.
Specific goals include:
* Modernize the B2G platform (replace legacy mozApps-only APIs with new web standards)
* Move towards an architecture closer to that of the Firefox browser (just chrome and web content)
* Transition smartphone modules to new owners and peers in the community

A team led by Gregor Wagner and Fabrice Desré conducted the analysis necessary to determine what changes should be made and the level of effort those changes would take to move us closer to being able to run on generic gecko to reduce the maintenance cost.  

If you are looking for information regarding Smart TV and Firefox OS 2.6 for TV, please visit
* https://wiki.mozilla.org/Firefox_OS/Smart_TV
* https://wiki.mozilla.org/TV_2.6

=== Requirements:===

=====Analysis=====
There were four areas analyzed for inclusion in the code transition plan (shown below with their owners):

*   Packaged apps (b2g features), perhaps the most important piece (Fabrice)
*   Process model - abandon ours and move to the one desktop has (Kan-Ru)
*   Removal of security model and wait for platform team to give us new security layer. (Paul)
*   Graphics/media (Kan-Ru)

=====Scope=====
It was decided that the focus of the transition would be on the first two of these areas.  In addition, an effort has begun to reduce code duplication by merging the 2 separate system apps.

===User Stories and Acceptance Criteria===
{| class="wikitable"
! style="text-align: center;" | Title
! style="text-align: center;" | BUG ID
! style="text-align: center;" | User story
! style="text-align: center;" | Acceptance Criteria
|-
| rowspan="1" | [META] Firefox OS Transition work
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252143 1252143] 
| META for the Firefox OS Transition work
| Bug dependencies: 1252193, 1252427, 1252570, 1252573, 1252773, 1252776, 1252778, 1252779, 1252789, 1253600, 1254281, 1254282, 1254283, 1254284, 1254285, 1254286, 1254287, 1254292, 
|-
| rowspan="1" | [Meta] Get core system apps working as chrome
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1261025 1261025] 
| META for getting core system apps working as chrome
| Bug dependencies: 
[https://bugzilla.mozilla.org/show_bug.cgi?id=1257935 1257935] keyboard
[https://bugzilla.mozilla.org/show_bug.cgi?id=1261027 1261027] systemapp
[https://bugzilla.mozilla.org/show_bug.cgi?id=1261028 1261028] homescreen
[https://bugzilla.mozilla.org/show_bug.cgi?id=1261029 1261029] search
[https://bugzilla.mozilla.org/show_bug.cgi?id=1261030 1261030] settings 
|-
| rowspan="1" |  [transition] Browser: Remove reference and logos relating to Firefox
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252193 1252193]
| 1. Remove all references to Firefox OS
2. Change browser icon to not be firefox logo 
| 1. All references to Firefox OS removed.
2. Browser icon no longer a firefox logo
|-
| rowspan="1" |  Bootstrap the transition
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252371 1252371]
| Created attachment 8725097 [details] [diff] [review]
new-apps.patch

I'm gonna land that on Pine, but here is the gecko patch for those that want to play with it.

You will also need to use my Pine gaia branch: https://github.com/fabricedesre/gaia/tree/pine

Steps:
- build your custom gecko and push it.
- push $gaia/httpd to /system/bin and start it with |httpd -h /system/b2g/apps|. This is simply a busybox server.
- stop b2g, and rm -r /data/b2g, /data/local/storage, /data/local/permissions.sqlite
- run $gaia/push_apps.sh

push_apps.sh is very slow, so once we have done it once, you can update a single app with $gaia/push_apps.sh system.gaiamobile.org
We should really push zips and unzip on device instead...
| Patched landed - Done
|-
| rowspan="1" |  Remove FTU app
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252427 1252427]
| Keeping the FTU app around and maintain it during the transition period isn't a high priority. We should move the code and tests to a separate repository so it doesn't get lost. We might want to leave the 'hooks' to create a custom FTU app in the system app but we won't maintain ours going forward. This also includes the tutorial parts.
My assumption is that users don't use any functionality since they can do everything in the settings app afterwards.

The work will be done on the transition branch.
Sam, can you help out here?
| Acceptance Criteria to be added
|-
| rowspan="1" |  Remove mozPay
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252570 1252570]
| The Marketplace is removing payments support [1], so we can get rid of all mozPay related code.

[1] https://wiki.mozilla.org/Marketplace#Upcoming_Changes_to_Marketplace
| Need to wait for TV 2.6 to branch before landing.
|-
| rowspan="1" |  Remove MobileID API 
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252573 1252573]
| This API was added mostly because of Firefox Hello requirements. Unfortunately, the Firefox Hello client for FxOS didn't last long and I don't think we have any other consumer for this API. So we can probably remove it safely.
| MobileID API removed
|-
| rowspan="1" |  Remove "improve Firefox OS" from settings
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252773 1252773]
| Remove "improve Firefox OS" from settings
| No reference to Firefox OS in settings
|-
| rowspan="1" |  Rename Firefox OS to B2G OS
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252776 1252776]
| Rename   - settings - device information - “about Firefox OS" - to About B2G OS - including all subtext.
| "about Firefox OS" renamed to "about B2G OS" in device information under settings
|-
| rowspan="1" |  Review all legal statements under settings
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252778 1252778]
| Review content under:
 a. settings - device info - your rights
 b. settings - device info - your privacy
 c. settings - device info - legal information
For consistency with the new way of working.
| All legal statements reviewed and inconsistencies noted.
|-
| rowspan="1" |  Remove Firefox OS logos from startup sequence
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252779 1252779]
| Remove all logos from the device startup sequence that shows and refers to Firefox OS.
| No Firefox OS logos in the device startup sequence
|-
| rowspan="1" |  Remove current location for OTA lookup
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252789 1252789]
| Remove the current location pointer for OTS search but still leave the OTA option in the settings so future possible OTA hosting services can just put their URL in there for usage.
| Current location pointer for OTS search removed
|-
| rowspan="1" |  Integrate nginx
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1253600 1253600]
| Following bug 1252371 we are relying on an http daemon. Let's use one with a bit more features to allow future work (https, multiple domains)
| Acceptance criteria to be entered
|-
| rowspan="1" |  Build system changes for the transitioned Gaia
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254281 1254281]
| This is to prepare for a chrome:// served Gaia. Instead of packaging each app independently in an application.zip file, we will package them all together, and put the shared/ alongside the apps.
The directory tree will look like:

* |- shared
* |- system
* |- settings
* |- ...

Compared to today's builds, we have to:
* stop including shared/ in every app.
* still select images at the appropriate resolution.
* stop packaging apps individually.
* stop using the gaiamobile.org subdomain.
| Acceptance criteria to be entered
|-
| rowspan="1" |  Remove the dependency on apps status in the audiochannel code
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254282 1254282]
| It should be chrome only now. See http://mxr.mozilla.org/mozilla-central/source/dom/system/gonk/AudioChannelManager.cpp#157 for a starting point of things to fix.
| Acceptance criteria
|-
| rowspan="1" |  Remove the dependency on apps status in the NFC code
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254283 1254283]
| Keeping the permission is ok, but everything that is gated by AvailableIn=CertifiedApps needs to be chrome only instead.

http://mxr.mozilla.org/mozilla-central/source/dom/webidl/MozNFC.webidl#38
| Acceptance criteria
|-
| rowspan="1" |  Remove the dependency on apps status in the Bluetooth code
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254284 1254284]
| Keeping the permission is ok, but everything that is gated by AvailableIn=CertifiedApps needs to be chrome only instead.

http://mxr.mozilla.org/mozilla-central/source/dom/webidl/BluetoothAdapter.webidl#38
| Acceptance criteria
|-
| rowspan="1" |  Remove the dependency on apps status in the Downloads api code
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254285 1254285]
| Keeping the permission is ok, but everything that is gated by AvailableIn=CertifiedApps needs to be chrome only instead.

http://mxr.mozilla.org/mozilla-central/source/dom/webidl/Downloads.webidl#63
| Acceptance criteria
|-
| rowspan="1" |  Remove the dependency on apps status in the RequestSync api cod
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254286 1254286]
| Keeping the permission is ok, but everything that is gated by AvailableIn=CertifiedApps needs to be chrome only instead.

http://mxr.mozilla.org/mozilla-central/source/dom/webidl/RequestSyncManager.webidl#7
| Acceptance criteria
|-
| rowspan="1" |  Remove the dependency on apps status in the EngineeringMode api code
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254287 1254287]
| Keeping the permission is ok, but everything that is gated by AvailableIn=CertifiedApps needs to be chrome only instead.

http://mxr.mozilla.org/mozilla-central/source/dom/webidl/EngineeringMode.webidl#7
| Acceptance Criteria
|-
| rowspan="1" |  Remove all uses of APP_STATUS_CERTIFIED and APP_STATUS_PRIVILEGED
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1254292 1254292]
| On top of the webidl gated instances, there are direct use of these constants that we need to update:

APP_STATUS_CERTIFIED:
http://mxr.mozilla.org/mozilla-central/search?string=APP_STATUS_CERTIFIED&find=&findi=&filter=%5E%5B%5E%5C0%5D*%24&hitlimit=&tree=mozilla-central

APP_STATUS_PRIVILEGED:
http://mxr.mozilla.org/mozilla-central/search?string=APP_STATUS_PRIVILEGED&find=&findi=&filter=%5E%5B%5E%5C0%5D*%24&hitlimit=&tree=mozilla-central

We will fully remove dom/apps, dom/activities and dom/messages so there's no need to fix these.
| Acceptance Criteria
|-
| rowspan="1" |  Remove all uses of AppsService
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1255046 1255046]
| AppsService lives in dom/apps and is going to die. We have to kill its use.
https://dxr.mozilla.org/mozilla-central/search?q=nsIAppsService&redirect=false&case=true
| Acceptance Criteria
|-
| rowspan="1" |  Move gaia to chrome:// urls
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1256506 1256506]
| Created attachment 8730467 [details] [diff] [review]
chrome-gaia.patch

This patch goes with the gaia branch at https://github.com/fabricedesre/gaia/tree/gaia-chrome

You need to clean up /data/local and /data/b2g before running $gaia/push_apps.sh

*this is not working yet*, and I'd like to get a new pair of eyes on that. If we crash in web components code, this is likely bug 1253788.
|-
| rowspan="1" |  Get the Places database working without using DataStore
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1257824 1257824]
| As part of the B2G OS Transition Project we're removing the DataStore API. We'll need to get the Places database working without using that API.
| Places database works without using DataStore API
|-
| rowspan="1" |  [meta] b2g build issues
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1245091 1245091]
| Fix issues preventing builds
| Closing of all dependencies: 1254604 1257793 1258294 1258672 993311 1087161 1244149 1244478 1245016 1245033 1245052 1245057 1245093 1245100 1247570 1248581 1249244 1249245 1251541 1251717 1251948 1252426 1252436 1253217 1253571 1254471 1254515 1256638 1257127 1257335 1258034 1258200 1258638
|-
| rowspan="1" |  Testing / Build Related Tasks
| [https://bugzilla.mozilla.org/show_bug.cgi?id=1252482 1252482]
| Meta for tracking build and test related tasks for fxos sunset program
| Bug dependencies: 1252491, 1254501, 1254504, 1254506, 1252484, 1252486, 1252487, 1253002
|-
|}

=='''Program Status'''==
{| class="wikitable"
! style="text-align: center;" | Milestone
! style="text-align: center;" | Date
! style="text-align: center;" | Status
! style="text-align: center;" | Status Notes
|-
| Document requirements for build and test support for re-architecture effort.
| 3/11/16
! style="background:#00B2FF;" | Done
| Need to identify requirements now that the code transition plan has been finalized and approved. Work breakdown will help in identifying the requirements
|-
| Set up branch, build, and test environment.
| 3/18/16
! style="background:#00B2FF;" | Done
| It's now possible to build B2G with the pine branch of Gecko and kanikani branch of Gaia. 
|-
| Develop execution plan for the code transition
| 3/21/16
! style="background:#FF2800;" | Late
| Meta bug created for the entire project. Breakage is making it difficult to identify target dates for milestones.
|-
| Code Transition Milestones
| TBD
! style="background:#C1C6CA;" | Not Started
| Development milestones will be added as milestones once they're identified.
|}

'''Status Key'''
{| class="wikitable"
! style="text-align: center;" | Color
! style="text-align: center;" | Status
! style="text-align: center;" | Key
|-
! style="background:#00EC00;" | 
| On Target
| The project or deliverable is expected to meet its due date.
|-
! style="background:#FFFF00;" |  
| Challenged
| The project or deliverable is facing an issue that might cause it to miss its due date, but a “get well” plan has been developed to get it back on track.
|-
! style="background:#FF2800;" | 
| At Risk or Late
| The project or deliverable is blocked or facing an issue that might cause it to miss its due date, and there’s no “get well” plan to get it back on track, or it is already late. 
|-
! style="background:#00B2FF;" | 
| Done
| The project or deliverable has been completed.
|-
! style="background:#C1C6CA;" | 
| On Hold or Not Started
| The project or deliverable has either not been started or has been placed on hold.
|}

----

=='''Program Timeline'''==
This timeline is simply a placeholder. Timeline to be inserted once milestones and schedule are known.

[[File:Release Timeline.png]]


=='''Program Stakeholders'''==

{| class="wikitable"
! style="text-align: center;" | Role
! style="text-align: center;" | Name
! style="text-align: center;" | IRC
|-
| Sponsor
| Faramarz Rashed
| faramarz
|-
| EPM
| Julie McCracken
| Julie
|-
| EM
| Gregor Wagner
| gwagner
|-
| PM
| Wilfred Mathanaraj
| wilfred
|-
| TL
| Fabrice Desré
| fabrice
|-
| QA
| Al Tsai
| atsai
|}

*EPM = Engineering Program Manager
*EM = Engineering Manager
*PM = Product Manager 
*TL = Tech Lead
*QA = Quality Assurance

----

== ==

=='''Archived Completed Deliverables'''==
{| class="wikitable"
! style="text-align: center;" | Milestone
! style="text-align: center;" | Date
! style="text-align: center;" | Status
! style="text-align: center;" | Status Notes
|-
| Gather feedback on the plan after discussion at 2/9 Engineering Program Review.
| 2/12/16
! style="background:#00B2FF;" | Done
| 2/9 review was well attended and lots of feedback was shared in the Transition of Firefox OS Code Base Proposed Plan.  2-3 additional reviews were held via videoconf.  Participation was good.
|-
| Identify engineers to work on the code transition plan
| 2/12/16
! style="background:#00B2FF;" | Done
| Identified engineers' names have been inserted into the plan. We've documented which components of the plan they'll each work on and for how long.
|-
| Hold a final review of the proposed plan with the engineering team
|2/12/16
! style="background:#00B2FF;" | Done
| Final reviews held via email.
|-
| Present plan at weekly Engineering Program Review
| 2/16/16
! style="background:#00B2FF;" | Done
| Wasn't ready by the 2/16 review but plan was submitted to Faramarz 2/19 via email.
|-
| Present plan at All Hands
| 2/25/16
! style="background:#00B2FF;" | Done
|
|-
| Public wiki created
| 3/4/16
! style="background:#00B2FF;" | Done
| Public wiki (this one) has been created.  Need to break down code transition work so that all milestones for eng. work can be posted, along with a schedule.  Those tasks remain.
|-
| Identify who will set up branch, build, and test environment.
| 3/11/16
! style="background:#00B2FF;" | Done
| Team identified and has begun the work.
|-
|}
----

==Reference Links==
[[Smartphone_Transition|Smartphone Transition Wiki]]

[[B2G/Community_Ownership_Transition|B2G/Community Ownership Transition Wiki]]

==Firefox OS 2.6 for TV==

If you are looking for information regarding Smart TV and Firefox OS 2.6 for TV, please visit
* https://wiki.mozilla.org/Firefox_OS/Smart_TV 
* https://wiki.mozilla.org/TV_2.6