| Both sides previous revision Previous revision Next revision | Previous revision |
| docs:guide-developer:helloworld:chapter1 [2019/02/23 13:13] – [Preparing, configuring and building the necessary tools] blue | docs:guide-developer:helloworld:chapter1 [2024/04/06 02:36] (current) – updated reference to stable branch ingamedeo |
|---|
| ====== Preparing your OpenWrt build system for use ====== | ====== Preparing your OpenWrt build system for use ====== |
| |
| This is the first chapter in the "Hello, world!" for OpenWrt article series. Before starting this chapter, you should read through [[docs:guide-developer:build-system:install-buildsystem|Build system – Installation]], procure a suitable computing platform (virtualized or otherwise) of your choice, and clone the source code to a new directory. Instructions for performing these steps can be found on the Wiki page linked above. | This is the first chapter in the "Hello, world!" for OpenWrt article series. Before starting this chapter, you should read through [[docs:guide-developer:toolchain:install-buildsystem|Build system – Installation]], procure a suitable computing platform (virtualized or otherwise) of your choice, and clone the source code to a new directory. Instructions for performing these steps can be found on the Wiki page linked above. |
| |
| Although this guide will not provide detailed instructions for this approach, you can also use the [[docs:guide-developer:using_the_sdk|OpenWrt SDK]] for your target platform instead of cloning the source code and creating the build system from scratch. If you opt for this route, you can skip the source cloning steps listed in the "Build system - Installation" guide, and instead download & extract the SDK into a new folder on your otherwise-prepared development environment. | Although this guide will not provide detailed instructions for this approach, you can also use the [[docs:guide-developer:toolchain:using_the_sdk|OpenWrt SDK]] for your target platform instead of cloning the source code and creating the build system from scratch. If you opt for this route, you can skip the source cloning steps listed in the "Build system - Installation" guide, and instead download & extract the SDK into a new folder on your otherwise-prepared development environment. |
| |
| ===== Preparing, configuring and building the necessary tools ===== | ===== Preparing, configuring and building the necessary tools ===== |
| These steps are necessary only if you chose to clone the source code. If you chose to use the SDK, you can skip this section. | These steps are necessary only if you chose to clone the source code. If you chose to use the SDK, you can skip this section. |
| |
| We first select a stable source code revision (v17.01.2), and ensure our source code directory is clean. The author of this article chose to clone the source code into a folder called 'source' under the home directory of the build user, called 'buildbot'. | We first select a stable source code revision (v23.05.3), and ensure our source code directory is clean. The author of this article chose to clone the source code into a folder called 'source' under the home directory of the build user, called 'buildbot'. |
| |
| <WRAP center round tip 80%> | <WRAP center round tip 80%> |
| ''/home/buildbot/'' is a representative path, you might choose, for example, ''~/devel/'' | ''/home/buildbot/'' is a representative path, you might choose, for example, ''~/devel/'' |
| |
| It is also suggested to use the most-current "stable" git branch. In December, 2018, that is ''openwrt-18.06'' | It is also suggested to use the most-current "stable" git branch. In April, 2024, that is ''openwrt-23.05.3'' |
| </WRAP> | </WRAP> |
| |
| As of December, 2018, the OpenWrt git repository can be cloned using | As of April, 2024, the OpenWrt git repository can be cloned using |
| <code> | <code> |
| git clone https://git.openwrt.org/openwrt/openwrt.git source | git clone https://git.openwrt.org/openwrt/openwrt.git source |
| <code> | <code> |
| cd /home/buildbot/source | cd /home/buildbot/source |
| git checkout v17.01.2 | git checkout v23.05.3 |
| make distclean | make distclean |
| </code> | </code> |
| |
| It is recommended to update and install the packages at this stage to avoid future problems. You can do that using: | It is recommended that you update and install your 'feeds' packages to avoid future problems. You can do that using: |
| <code> | <code> |
| ./scripts/feeds update -a | ./scripts/feeds update -a |