X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=d4dc1ef65626162d8b4ad2e0fbe31471cd5c19a0;hb=6e6bcddf3535ed9800e76db08d9351863e6042b2;hp=acf2a3ab7900cad2b8bd5654deda5d56f1db296c;hpb=b37eb994a577d3bd012567bae55f14e47e70e87b;p=staging%2Fxdg-launcher.git diff --git a/README.md b/README.md index acf2a3a..d4dc1ef 100644 --- a/README.md +++ b/README.md @@ -20,36 +20,77 @@ 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 ------ -Once installed, use them by customize depending on your project with file -`\/etc/config.cmake`. +Install the reference files to the root path of your project, then once +installed, customize your project with file `\/etc/config.cmake`. + +Typically, to copy files use a command like: + +```bash +cp -r reference/etc reference/packaging +cp reference/AGLbuild +``` Specify manually your targets, you should look at samples provided in this 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` +tool when building application from a Yocto workflow that use this entry point +to get its widget file. + Or with the classic way : ```bash @@ -117,7 +158,7 @@ PROJECT_TARGET_ADD(low-can-demo) This will make available the variable `${TARGET_NAME}` set with the specificied name. -### search_targets +### project_subdirs_add This macro will search in all subfolder any `CMakeLists.txt` file. If found then it will be added to your project. This could be use in an hybrid application by @@ -126,10 +167,10 @@ example where the binding lay in a sub directory. Usage : ```cmake -search_targets() +project_subdirs_add() ``` -### populate_widget +### project_targets_populate Macro use to populate widget tree. To make this works you have to specify some properties to your target : @@ -147,7 +188,7 @@ Usage : populate_widget() ``` -### build_widget +### project_package_build Use at project level, to gather all populated targets in the widget tree plus widget specifics files into a **WGT** archive. Generated under your `build` @@ -158,3 +199,7 @@ Usage : ```cmake 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.