diff options
author | Romain Forlot <romain.forlot@iot.bzh> | 2017-05-24 15:13:56 +0200 |
---|---|---|
committer | Romain Forlot <romain.forlot@iot.bzh> | 2018-10-15 18:22:20 +0200 |
commit | 5b13f986124d80491f0e3f50a8f85fcc7691ac36 (patch) | |
tree | 038f224888fb90ac533753a279cd505a72c6582b | |
parent | 287ebb919392ef18bf94a25d8972b9c64d36e3ea (diff) |
Update README doc
Change-Id: I94da23c8d87dc11862d93b4c87a8291cad633fb3
Signed-off-by: Romain Forlot <romain.forlot@iot.bzh>
-rw-r--r-- | README.md | 62 |
1 files changed, 46 insertions, 16 deletions
@@ -20,21 +20,51 @@ Typical project architecture A typical project architecture would be : -* \<root-path\>/ -* \<root-path\>/<libs> -* \<root-path\>/packaging -* \<root-path\>/packaging/wgt -* \<root-path\>/packaging/wgt/etc -* \<root-path\>/\<target\>/ - -| # | Parent | Description | Files | -| - | -------| ----------- | ----- | -| \<root-path\> | - | Path to your project | Hold master CMakeLists.txt and general files of your projects. | +```tree +<project-root-path> +│ +├── 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 +├── <libs> +├── <target> +├── <target> +└── <target> +``` + +| # | Parent | Description | +| - | -------| ----------- | +| \<root-path\> | - | Path to your project. Hold master CMakeLists.txt and general files of your projects. | +| conf.d | \<root-path\> | 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. | | \<libs\> | \<root-path\> | 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. | -| \<target\> | \<root-path\> | A sub component between: tool, binding, html5, html5-hybrid type. | ----- | -| packaging | \<root-path\> | 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 | +| \<target\> | \<root-path\> | 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. |