path: root/README

tizen-application-manager, how to port into agl-demom-platform for Automotive Grade Linux
==========================================================================
Release note 
 Application Manager is responsible for 
	* install/uninstall application
	* launch/suspend application
	* lifecycle management(event)
	* save application data
	* provide application information

 tizen-application-manager provides the following common APIs to developers
	* manage the application
		- to launch/stop application
		- to manage application information of database
		* It doesn't provide efl event

ToDo
------------------
* First setting(vconf etc.) for launching application from systemd
* Change global user name to aglglobaluser
* Documentation
* Separate the dependencies of capi-*
* Disable events of efl dependencies from app-core
* Dynamicaly enable to install the application
* Make events of appcore enabled independent of efl
* Make events of appcore from unspecified runtime engine

　　　
Layer Dependencies
------------------

URI: git://git.yoctoproject.org/poky
> branch:   jethro,
> revision: 118380bc5d01e52b5edc574abb4176f6e70a54a6

URI: git://git.openembedded.org/meta-openembedded
> layer:    meta-oe, meta-multimedia, meta-efl, meta-networking, meta-python
> branch:   jethro-next or jethro or master
> revision: 8ab04afbffb4bc5184cfe0655049de6f44269990

URI: https://github.com/meta-qt5/meta-qt5.git
> branch:   master or jethro 
> revision: ea37a0bc987aa9484937ad68f762b4657c198617

URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl
> layer:    meta-agl, meta-ivi-common
> branch:   master
> revision: baa986abe444dbbfd59b63f6111a058b80891474
> (or later)

URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-agl-demo
> branch:   master 
> revision: 9a319937529cca7e263e987b85cb9d6fca0b468c
> (or later)

URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas
> layer:    meta-rcar-gen2
> branch:   agl-1.0-bsp-1.8.0
> revision: 82611ccadef36ab0b8a6fd6fb1cf055e115f1ef5
> (or later)


## The Renesas R-Car Gen2 (Porter) board depends in addition on: ##

URI: https://gerrit.automotivelinux.org/gerrit/AGL/meta-renesas
> branch:   agl-1.0-bsp-1.8.0
> revision: bf30de66badcac7ef82d3758aa44c116ee791a28
> (or later)

URI: https://gerrit.automotivelinux.org/gerrit/staging/tizen-application-manager
> branch:   master
> revision: 
> (or later)

Supported Machine
-----------------

* Renesas R-Car Gen2 (R-Car M2) - machine: porter

Supported Target of bitbake
------------------------
* `agl-demo-platform-plus-application-manager` The image into which add tizen-application-manager

Downloading the Source
--------------------

You can use repo tool to get all layers which are needed to build AGL Distribution.

1. Installing Repo. Make sure you have a bin/ in your $HOME and it's included in your $PATH.
        $ mkdir ~/bin
        $ export PATH=~/bin:$PATH

   Download the repo tool.
        $ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
        $ chmod a+x ~/bin/repo

2. Preparing download. Create an empty directory to hold all recipes and build environment. You can make it as any name you like.
        $ mkdir WORKING-DIRECTORY
        $ cd WORKING-DIRECTORY

3. Getting all layers.
        $ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
        $ repo sync

4. Getting modified tizen-application-manager
	$ git clone https://gerrit.automotivelinux.org/gerrit/staging/tizen-application-manager


Build a R-Car M2 (porter) image
-------------------------------

please refer to README in meta-agl-demo or meta-agl


Build image
-------------------------------

You can build an image for porter using the following steps:

1. change recipes and security_flags.inc
 1.1 remove or move freetype bbappend file 
	$ rm -rf ${METADIR}/meta-agl/meta-ivi-common/recipes-test/freetype

  You can select the following process to setup.
  1.b is better to avoid mistakes.
 
  1.a Add the following setting into security_flags.inc
	+SECURITY_CFLAGS_pn-efl = "${SECURITY_NO_PIE_CFLAGS}" 
	+SECURITY_CFLAGS_pn-poppler = "${SECURITY_NO_PIE_CFLAGS}"

  1.b Copy security_flags.inc
	$ cd ${METADIR}/tizen-application-manager/
	$ cp(mv) security_flags.inc ${METADIR}/poky/meta/conf/distro/include
  

2. Run the following command:
	$ cd ${METADIR}
	$ source meta-agl/scripts/aglsetup.sh -m porter -b build-porter agl-demo

3. Modify conf/bblayers

 3.1 Remove the meta-agl-bsp line
	remove ${METADIR}/meta-agl/meta-agl/meta-agl-bsp \

 3.2 Add following environment variables in conf/bblayers.conf

	BBLAYERS =+ " \
	   ${METADIR}/tizen-application-manager/meta-application-manager \
	"

4. Modify conf/local.conf

 4.1 Add the following environment variable in conf/bblayers.conf
	BBMASK += "|meta-ivi-common/recipes-test/freetype/freetype_%.bbappend"

5. bitbake the image
	$ bitbake agl-demo-platform-plus-application-manager


Deploying to SD card
-------------------------------
The process to refer to README in meta-agl-demo.
Please change file name to agl-demo-platform-plus-application-manager from agl-demo-platform.
  
  -> --file=agl-demo-platform-plus-application-manager-porter.tar.bz2

How to use application manager
-------------------------------
The following process is how to launch sample application trying whether sample package 
can be searched from database.


1. start up porter board and open the weston-terminal

2. setting	
	# vconftool set -t string db/menu_widget/language "en-us"
	# loginctl enable-linger tizenglobalapp
	# useradd tizenglobalapp
		if required to define password, please set the password you like.

3. launch sample application from user
	# login tizenglobalapp
	$ launch_app org.tizen.amhelloworld
		launch sample appli will fail.
	$ pkg_createdb_user
	$ pkg_initdb_user
	$ launch_app org.tizen.amhelloworld
		successfull to launch

4. How to start native application
	$ pkgcmd -l // to list all applications available.
	$ app_launcher -s <pkgid>

   For more information, please access the following URL
	https://wiki.tizen.org/wiki/IVI/Tizen-IVI_3.0