Document how to make a webapps package for phone and desktop

[Pat McGowan]

Document how to create a webapp for both phone and desktop
Show a simple example

Document the unity-webapps-runner command
Why does desktop webapp use unity-webapps-runner rather than webapp-container?

Document the webapp-container command with more detail than the help
Descibe url patterns and how to use them
Recommended options - store-session cookies, enable-back-forward

Dcoument the Desktop file settings: [webapp].desktop and differences for phone and desktop

Phone only Click setup
Document the Apparmor profile: [webappp].json
Cross reference manifest file parameters: manifest.json

[Pat McGowan (pat-mcgowan)]

Seems there is already this page:
http://developer.ubuntu.com/publish/webapp/packaging-web-apps/

but it contains some errors
1) the recommended framework is not yet supported, would need -dev1 today
2) must include the webview policy group
3) should also include context-exchange, along with audio and video for uploading

[Pat McGowan (pat-mcgowan)]

Note we still need desktop specific instructions

[Kyle Nitzsche (knitzsche)]

I think the "web" section (for webapps) of the dev portal needs a freshen-up content wise. For example the landing page does not really say what a webapp is in a straightforward way [1] , its only has API framework docs for 13.10 [2] and etc.

[1] https://bugs.launchpad.net/ubuntudeveloperportal/+bug/1313769
[2] https://bugs.launchpad.net/ubuntudeveloperportal/+bug/1313764

[David Barth (dbarth)]

We met with Kyle and Alex to review the whole section and plan updates to address those points.

In a nutshell, we will have

Landing page with the main mentions:
- webapp is an external website in an app shell
- difference with html5 apps
- packaging requirements
- shell integration
- differences between mobile and desktop webapps
- integration with Online Accounts (coming soon)

Tutorial section
- walk-through the various configuration files (enhanced version of the current packaging guide)

API section
- will tag the 13.10 doc as Desktop only

Cookbook
- will rename current recipes as "desktop only"
- will add technical refs for the following technical points:
  - url patterns
  - troubleshooting a webapp?
  - online accounts integration --accountProvider launch arg (not landed yet)
  - optional / additional policy groups
  - Set user agent string
  - chrome options (no chrome, back/forward, url bar)
  - store-session-cookies

[David Barth (dbarth)]

In the meantime I updated the packaging page with the correct framework & extra policy_groups.

Still keeping this bug open until the rest of the above changes are online.

[Nicholas Skaggs (nskaggs)]

Kyle, can you update what was completed and what remains on this? As it stands this bug is very hard to close, and might be more useful closed, with the remaining issues split up as separate bugs.

[Daniel Holbach (dholbach)]

What is still missing?

[David Callé (davidc3)]

The previous web api has been moved to unity.ubuntu.com with the other Unity7 specific components.