mirror of
https://github.com/ETLCPP/etl.git
synced 2026-06-26 20:38:45 +08:00
CMake install instructions (#527)
* add installation steps for CMake * cmake install steps * small tweaks Co-authored-by: Cleanroom Laptop L15 <meierj@irs.uni-stuttgart.de>
This commit is contained in:
parent
f9b9865956
commit
6780a56f52
60
README.md
60
README.md
@ -13,7 +13,7 @@ Embedded Template Library (ETL)
|
||||
[](https://ci.appveyor.com/project/jwellbelove/etl/branch/master)
|
||||
[](https://www.codacy.com/manual/jwellbelove/etl?utm_source=github.com&utm_medium=referral&utm_content=ETLCPP/etl&utm_campaign=Badge_Grade)
|
||||
|
||||
**Motivation**
|
||||
## Motivation
|
||||
|
||||
C++ is a great language to use for embedded applications and templates are a powerful aspect. The standard library can offer a great deal of well tested functionality, but there are some parts of the standard library that do not fit well with deterministic behaviour and limited resource requirements. These limitations usually preclude the use of dynamically allocated memory and containers with open ended sizes.
|
||||
|
||||
@ -21,7 +21,7 @@ What is needed is a template library where the user can declare the size, or max
|
||||
|
||||
This is what the ETL attempts to achieve.
|
||||
|
||||
**Summary**
|
||||
## Summary
|
||||
|
||||
The ETL is not designed to completely replace the STL, but complement it.
|
||||
Its design objective covers three areas.
|
||||
@ -35,7 +35,7 @@ It contains a set of containers, algorithms and utilities, some of which emulate
|
||||
There is no dynamic memory allocation. The library makes no use of the heap. All of the containers have a fixed capacity allowing all memory allocation to be determined at compile time.
|
||||
The library is intended for any compiler that supports C++ 03.
|
||||
|
||||
**Main features:**
|
||||
## Main features
|
||||
|
||||
- Cross platform. This library is not specific to any processor type.
|
||||
- No dynamic memory allocation
|
||||
@ -62,6 +62,58 @@ I am especially interested in people who are using Keil, IAR, Green Hills, TI Co
|
||||
|
||||
See (https://www.etlcpp.com) for up-to-date information.
|
||||
|
||||
**Arduino library:**
|
||||
## Installing this library
|
||||
|
||||
You can find the setup steps [here](https://www.etlcpp.com/setup.html).
|
||||
|
||||
### CMake
|
||||
|
||||
One way to use this library is to drop it somewhere in your project directory
|
||||
and then make the library available by using `add_subdirectory`
|
||||
|
||||
```cmake
|
||||
add_subdirectory(etl)
|
||||
add_executable(foo main.cpp)
|
||||
target_link_libraries(foo PRIVATE etl)
|
||||
```
|
||||
|
||||
If you want to install this library with CMake, you can perform the following steps
|
||||
|
||||
```sh
|
||||
git clone https://github.com/ETLCPP/etl.git
|
||||
git checkout <targetVersion>
|
||||
cmake -B build .
|
||||
sudo cmake --install build/
|
||||
```
|
||||
|
||||
After the library has been installed, you can use [find_package](https://cmake.org/cmake/help/latest/command/find_package.html) to use the library.
|
||||
Replace `<majorVersionRequirement>` with your desired major version:
|
||||
|
||||
```cmake
|
||||
find_package(etl <majorVersionRequirement>)
|
||||
add_executable(foo main.cpp)
|
||||
target_link_libraries(foo PRIVATE etl)
|
||||
```
|
||||
|
||||
|
||||
Alternatively you can use [FetchContent](https://cmake.org/cmake/help/latest/module/FetchContent.html), replacing `<targetVersion>` with the version to
|
||||
install based on a git tag:
|
||||
|
||||
```sh
|
||||
Include(FetchContent)
|
||||
|
||||
FetchContent_Declare(
|
||||
etl
|
||||
GIT_REPOSITORY https://github.com/ETLCPP/etl
|
||||
GIT_TAG <targetVersion>
|
||||
)
|
||||
|
||||
FetchContent_MakeAvailable(etl)
|
||||
|
||||
add_executable(foo main.cpp)
|
||||
target_link_libraries(foo PRIVATE etl)
|
||||
```
|
||||
|
||||
## Arduino library
|
||||
|
||||
The content of this repo is available as a library in the Arduino IDE (search for the "Embedded Template Library" in the IDE library manager). The Arduino library repository is available at ```https://github.com/ETLCPP/etl-arduino```, see there for more details.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user