Zephyr CMake package / find_package(Zephyr)

Rasmussen, Torsten

Hi All,


A new way of including boilerplate code has been introduced with this PR


This means a simple Zephyr application now looks as:

# Find Zephyr. This also loads Zephyr's build system.

cmake_minimum_required(VERSION 3.13.1)

find_package(Zephyr HINTS $ENV{ZEPHYR_BASE})



This means that developers no longer need to set ZEPHYR_BASE in their environment, but can let CMake find the Zephyr base using find_package().


For this to work, it is necessary to execute a new west command: `west zephyr-export`

This command only needs to be executed once, for example after a `west init`


All samples in Zephyr repository has been updated to use: find_package(Zephyr HINTS $ENV{ZEPHYR_BASE})


To all downstream user having own Zephyr-based applications, you may switch to the new find_package() method.


Note: this new feature is fully compatible with the old `include($ENV{ZEPHYR_BASE}/cmake/app/boilerplate.cmake)` design,

but if you keep using the old design, then it is still required to `source` or execute `zephyr-env.cmd`.


Using the new `find_package()` remove the need to `source`.


It is still possible to set the environment variable ZEPHYR_BASE, and doing so will overwrite the CMake package search functionality in Zephyr.


For more information on the new desgin, re-read the getting started guide (as the latest docs has not yet been build, this is a ):


(Still waiting for the docs to be rebuilt)



Best regards