external_zblue

History

Benjamin Cabé e31083fbb4 samples: application_development: use zephyr:code-sample directive Describe the samples using code-sample directive in preparation for upcoming changes to the Zephyr documentation that will be leveraging the provided description and metadata. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>		2026-04-20 17:38:53 +08:00
..
mylib	…
src	samples, tests, boards: Switch main return type from void to int	2026-04-20 16:20:05 +08:00
CMakeLists.txt	samples: external_lib: Include `--target` in exported build flags	2026-04-20 17:32:49 +08:00
README.rst	samples: application_development: use zephyr:code-sample directive	2026-04-20 17:38:53 +08:00
prj.conf	…
sample.yaml	samples: Switch integration_platforms from native_posix to native_sim	2026-04-20 16:50:00 +08:00

README.rst

.. zephyr:code-sample:: external_library
   :name: External Library

   Include an external static library into the Zephyr build system.

Overview
********

A simple example that demonstrates how to include an external static library
into the Zephyr build system.
The demonstrates both how to build the external library using a different build
system and how to include the built static library.

Windows Note
************

To use this sample on a Windows host operating system, GNU Make needs to be in
your path. This can be setup using chocolatey or by manually installing it.

Chocolatey Method
=================

Install make using the following command:

.. code-block:: bash

   choco install make

Once installed, build the application as normal.

Manual Install Method
=====================

The pre-built make application can be downloaded from
https://gnuwin32.sourceforge.net/packages/make.htm by either getting both the
``Binaries`` and ``Dependencies`` and extracting them to the same folder, or
getting the ``Complete package`` setup. Once installed and in the path, build
the application as normal.