From: Romain Forlot Date: Wed, 24 May 2017 13:13:56 +0000 (+0200) Subject: Update README doc X-Git-Tag: 3.99.2~83 X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=commitdiff_plain;h=672ae412fa42bb7671b69a0adacc3afc9a5ba931;p=apps%2Fapp-templates.git Update README doc Change-Id: I94da23c8d87dc11862d93b4c87a8291cad633fb3 Signed-off-by: Romain Forlot --- diff --git a/README.md b/README.md index 65bebca..d4dc1ef 100644 --- a/README.md +++ b/README.md @@ -20,21 +20,51 @@ Typical project architecture A typical project architecture would be : -* \/ -* \/ -* \/packaging -* \/packaging/wgt -* \/packaging/wgt/etc -* \/\/ - -| # | Parent | Description | Files | -| - | -------| ----------- | ----- | -| \ | - | Path to your project | Hold master CMakeLists.txt and general files of your projects. | +```tree + +│ +├── conf.d/ +│ ├── default/ +│ │ ├── cmake/ +│ │ │ ├── config.cmake.sample +│ │ │ ├── export.map +│ │ │ └── macros.cmake +│ │ ├── deb/ +│ │ │ └── config.deb.in +│ │ ├── rpm/ +│ │ │ └── config.spec.in +│ │ └── wgt/ +│ │ ├── config.xml.in +│ │ └── icon.png +│ ├── packaging/ +│ │ ├── config.xml +│ │ ├── config.spec +│ │ ├── icon.png +│ │ └── config.deb +│ ├── autobuild/ +│ │ ├── agl +│ │ │ └── autobuild.sh +│ │ ├── linux +│ │ │ └── autobuild.sh +│ │ └── windows +│ │ └── autobuild.bat +│ ├── README.md +│ └── config.cmake +├── +├── +├── +└── +``` + +| # | Parent | Description | +| - | -------| ----------- | +| \ | - | Path to your project. Hold master CMakeLists.txt and general files of your projects. | +| conf.d | \ | Git submodule to app-templates AGL repository which provides CMake helpers macros library, and build scripts. config.cmake is a copy of config.cmake.sample configured for the projects. | +| default | conf.d | Holds examples files and cmake macros used to build packages | +| packaging | conf.d | Contains output files used to build packages. | +| autobuild | conf.d | Scripts used to build packages the same way for differents platforms. | | \ | \ | External dependencies libraries. This isn't to be used to include header file but build and link statically specifics libraries. | Library sources files. Can be a decompressed library archive file or project fork. | -| \ | \ | A sub component between: tool, binding, html5, html5-hybrid type. | ----- | -| packaging | \ | Contains folder by package type (rpms, deb, wgt...) | Directory for each packaging type. | -| wgt | packaging | Files used to build project widget that can be installed on an AGL target. | config.xml.in, icon.png.in files. | -| etc | wgt | Configuration files for your project. This will be installed in the application root directory under etc/ folder once installed by Application Framework. | specific project configuration files | +| \ | \ | A target to build, typically library, executable, etc. | Usage ------ @@ -54,7 +84,7 @@ repository to make yours. Then when you are ready to build, using `AGLbuild` that will wrap CMake build command: ```bash -./AGLbuild package +./build.sh package ``` AGLbuild is not mandatory to build your project by will be used by `bitbake` @@ -172,4 +202,4 @@ build_widget() ### project_closing_message -Will display the closing message configured in `config.cmake` file. Put it at the end of your project CMake file. \ No newline at end of file +Will display the closing message configured in `config.cmake` file. Put it at the end of your project CMake file.