Settings Service for Platform settings
This service supports the following methods, which are described in detail in the generated documentation:
Below are the tools and libraries (and their minimum versions) required to build this package:
- webosose/cmake-modules-webos 1.0.0 RC2
- cmake (version required by webosose/cmake-modules-webos)
- glib-2.0
- gthread-2.0
- libxml-2.0
- sqlite3
- webosose/cjson
- webosose/pbnjson
- webosose/luna-service2
- qt4 4.8.2
- liburiparser
Using the meta-webos layer for OpenEmbedded is the preferred method of building Open webOS components.
This allows your package to be installed into an Open webOS system, or as part of an Open webOS image.
Clone the repository at http://www.github.com/webosose/build-webos and follow the instructions in that README to build Open webOS.
To build or rebuild a single Open webOS component, if your build-webos directory is ~/webosose/build-webos, and you are wanting to rebuild the component called "luna-sysservice", do:
$ cd ~/webosose/build-webos
$ make cleanall-luna-sysservice luna-sysservice
The resulting IPK package will be in your BUILD-[target-machine] directory, under deploy/ipk/[architecture], such as this example:
~/webosose/build-webos/BUILD-qemux86/deploy/ipk/i586/luna-sysservice_2.0.0-1.00-r5_i586.ipk
You can transfer this to your existing image, and install it by logging into the Open webOS system, and using:
$ ipkg install /path/to/luna-sysservice_2.0.0-1.00-r5_i586.ipk
Or you can create a completely new Open webOS image with:
$ make webos-image
After successfully building the latest stable version, you may configure build-webos to build this component from your own local clone.
You can specify what directory to use as the local source inside the file "global-webos.conf" in your home directory, or within the file "webos-local.conf" within the build-webos directory, by adding the following:
S_pn-[component-name] = "/path/to/component/source"
such as in this example:
S_pn-luna-sysservice = "/home/user/webosose/luna-sysservice"
Then follow the instructions above to rebuild and install this package.
It is often desireable, for rapid iteration and testing purposes, to build a component for use within the Open webOS Desktop system.
Clone the repository at http://www.github.com/webosose/build-desktop and follow the instructions in the README file.
First, follow the directions to build the latest "stable" version.
To build your local clone of a component, such as luna-sysservice, instead of the "stable" version installed with the build-webos-desktop script:
- Open the build-webos-desktop.sh script with a text editor
- Locate the function build_component-name (i.e., build_luna-sysservice)
- Change the line "cd $BASE/luna-sysservice" to use the folder containing your clone, for example "cd ~/webosose/luna-sysservice"
- Close the text editor
- Remove the file
/luna-desktop-binaries/component-name/luna-desktop-build*.stamp (/luna-desktop-binaries/luna-sysservice/luna-desktop-build*.stamp) - Rebuild by running the build-webos-desktop.sh script again
Cautions:
- When you re-clone webosose/build-desktop, you'll have to overwrite your changes and reapply them
- Components often advance in parallel with each other, so be prepared to keep your cloned repositories updated
- Fetch and rebase frequently
This component of webOS can be built as a standalone piece that does not depend upon the rest of the system.
Once you have downloaded the source, execute the following to build it (after changing into the directory under which it was downloaded):
$ mkdir BUILD
$ cd BUILD
$ cmake ..
$ make
$ sudo make install
The directory under which the files are installed defaults to /usr/local/webos. You can install them elsewhere by supplying a value for WEBOS_INSTALL_ROOT when invoking cmake.
For example:
$ cmake -D WEBOS_INSTALL_ROOT:PATH=$HOME/projects/webosose ..
$ make
$ make install
will install the files in subdirectories of $HOME/projects/webosose.
Specifying WEBOS_INSTALL_ROOT also causes pkg-config to look in that tree first before searching the standard locations. You can specify additional directories to be searched prior to this one by setting the PKG_CONFIG_PATH environment variable.
To see all of the make targets that CMake has generated, issue:
$ make help
From the directory where you originally ran make install, enter:
$ [sudo] make uninstall
You will need to use sudo if you did not specify WEBOS_INSTALL_ROOT.
The tools required to generate the documentation are:
- doxygen 1.6.3
- graphviz 2.20.2
Copyright (c) 2012-2018 LG Electronics, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
SPDX-License-Identifier: Apache-2.0