Difference between revisions of "User:Elvispre"

From WebOS-Ports
Jump to navigation Jump to search
Line 1: Line 1:
== Development ==
See [[Getting Started With Development]].
== Overview ==
== Overview ==
'''What is WebOS Ports?'''
'''What is WebOS Ports?'''
Line 24: Line 27:
rwhitby August 2012:
rwhitby August 2012:
<blockquote>LunaCE (formerly UberLunah) is a collection of all the best LunaSysMgr improvements for the ''HP TouchPad'', rolled into a single installation package.</blockquote>
<blockquote>LunaCE (formerly UberLunah) is a collection of all the best LunaSysMgr improvements for the ''HP TouchPad'', rolled into a single installation package.</blockquote>
== Development ==
=== Help Develop LuneOS ===
==== Build and Install LuneOS ====
For an easy life, develop on Linux. Ubuntu 12.04 LTS 64-bit works well.
The [https://github.com/webos-ports/ source code] is on GitHub so you need a copy of [http://git-scm.com/ git] for a start.
Instructions for building (or just downloading) and installing an image can be reached by selecting a target device from the [[Devices]] page. Notice that there is a LuneOS VirtualBox [[Emulator]] which you can use instead of a target device.
==== Build System Overview ====
I assume that the build system is based on the [http://www.openwebosproject.org/docs/build_guide Open webOS one].
Set-up is automated
$ wget https://raw.github.com/webOS-ports/webos-ports-setup/testing/Makefile
$ make setup-webos-ports
(but do follow the proper instructions for your device).
The build itself is based on the [http://www.openembedded.org/wiki/Main_Page OpenEmbedded] (oe) build framework for embedded Linux and is driven by the [https://www.yoctoproject.org/tools-resources/projects/bitbake BitBake] (bb) build engine (rather than make).
You bitbake a [http://www.yoctoproject.org/docs/1.6/bitbake-user-manual/bitbake-user-manual.html#recipes "recipe"]. This is a simple text file of metadata with the extension .bb indicating how to fetch, build and install something. The system is very modular. One recipe depends on another and there are hundreds of recipes involved in our build.
The particularly interesting recipes for our purposes, such as <code>webos-ports-dev-package</code>, are in <code>webos-ports/meta-webos-ports/recipes-core/images</code>.
[[Repository_Layout|Repository Layout]] might make some sense to you now!
The [[Porting Guide]] sheds quite a lot of light on this too.
==== Develop! ====
So let's say you have built <code>webos-ports-dev-package</code>, installed it on a device and had a play around with it. How can you change it?
Start with a browse around the <code>meta-webos-ports</code> layer folder (on your build machine). Its <code>conf/layer.conf</code> is interesting. This is where we pick up Open webOS from LG and then customise it. The luneos "distro platform codename" gets set in the file <code>webos.inc</code> for example. <code>webos-repositories.inc</code> looks pretty interesting too.
You could change something in there and bitbake again to see what happens. (Will your change be incorporated or overwritten?)
If you are looking to improve the bundled apps (or add new ones), the recipes are in <code>recipes-webos/apps</code>. Make some sense of those and you will definitely be winning. Can you find the fetched source code? Do you understand why it is where it is?
''Is there a good (read, more convenient) environment to test apps without installing on a device?''
If you have made a worthwhile change, our [[Submitting_Contributions|Submitting Contributions]] instructions tell you how to get it pulled into the main line.
=== Help Develop the Core LuneOS Applications ===
=== Develop Applications to Run on LuneOS ===

Revision as of 08:58, 25 October 2014


See Getting Started With Development.


What is WebOS Ports?

WebOS Ports is an open source firmware distribution for smartphones and tablet computers based on the Open webOS mobile operating system.

Basically, it is the (Open) webOS "Community Edition" project. You will see some old references to WOCE for that reason.

Read about the supported devices here.

What is Open webOS?

When HP pulled the plug on what was left of Palm, it produced an open source version of the webOS that ran on the HP Touchpad. That is Open webOS. LG, who bought the Palm division off HP, sponsor it now.

We have some cool material on it here.

What is LuneOS?

LuneOS is the name of WebOS Ports' Open webOS. Lune refers to the user interface in legacy webOS, LunaSysMgr.

What is LunaCE?

Luna Community Edition. It is a Touchpad thing.

rwhitby August 2012:

LunaCE (formerly UberLunah) is a collection of all the best LunaSysMgr improvements for the HP TouchPad, rolled into a single installation package.