Building the SDK - Revision history

Beroset: Edited to change old `tmp-glibc` to current `tmp` directory under `build`.

2025-10-10T00:31:06Z

Edited to change old `tmp-glibc` to current `tmp` directory under `build`.

← Older revision		Revision as of 00:31, 10 October 2025
Line 47:		Line 47:

	==Install the SDK==		==Install the SDK==
	Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp~~-glibc~~/deploy/sdk/oecore-meta-toolchain-qt5-x86_64-armv7vehf-neon-sturgeon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code> directory) -- or a <code>oecore-meta-toolchain-qt5-x86_64-core2-32-qemux86-toolchain-nodistro.0.sh</code> script if you are building the version of the SDK for the emulator. Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.		Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp/deploy/sdk/oecore-meta-toolchain-qt5-x86_64-armv7vehf-neon-sturgeon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code> directory) -- or a <code>oecore-meta-toolchain-qt5-x86_64-core2-32-qemux86-toolchain-nodistro.0.sh</code> script if you are building the version of the SDK for the emulator. Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.

	==Related pages==		==Related pages==

Beroset: /* Which SDK? */ update to scarthgap toolchain installer names

2024-08-21T22:44:36Z

Which SDK?: update to scarthgap toolchain installer names

← Older revision		Revision as of 22:44, 21 August 2024
Line 14:		Line 14:
	==== Which SDK? ====		==== Which SDK? ====
	One thing to note is that while this describes "the SDK", there are actually two versions -- the main one is used to develop software that runs on ARM-based watches running AsteroidOS. The other one is the SDK for developing applications that run on the emulator, which uses qemux86. See the [[Emulator]] page for details on the qemux86 version. This page describes only the main ARM-based SDK but building the emulator version is almost the same. The only difference is that instead of this:		One thing to note is that while this describes "the SDK", there are actually two versions -- the main one is used to develop software that runs on ARM-based watches running AsteroidOS. The other one is the SDK for developing applications that run on the emulator, which uses qemux86. See the [[Emulator]] page for details on the qemux86 version. This page describes only the main ARM-based SDK but building the emulator version is almost the same. The only difference is that instead of this:
	source ./prepare-build.sh ~~dory~~		source ./prepare-build.sh sturgeon
	bitbake meta-toolchain-qt5		bitbake meta-toolchain-qt5
	you would do this instead:		you would do this instead:
Line 47:		Line 47:

	==Install the SDK==		==Install the SDK==
	Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp-glibc/deploy/sdk/oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code> directory) -- or a <code>oecore-x86_64-core2-32-toolchain-nodistro.0.sh</code> script if you are building the version of the SDK for the emulator. Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.		Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp-glibc/deploy/sdk/oecore-meta-toolchain-qt5-x86_64-armv7vehf-neon-sturgeon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code> directory) -- or a <code>oecore-meta-toolchain-qt5-x86_64-core2-32-qemux86-toolchain-nodistro.0.sh</code> script if you are building the version of the SDK for the emulator. Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.

	==Related pages==		==Related pages==

Beroset: /* Summary */ fixed link for Building_the_SDK#With_or_without_software_containers?

2024-02-03T23:24:58Z

Summary: fixed link for Building_the_SDK#With_or_without_software_containers?

← Older revision		Revision as of 23:24, 3 February 2024
Line 4:		Line 4:
	This page describes how to build the Software Development Kit (SDK) for AsteroidOS '''without''' using ''software containers''. If you want to build the SDK using containers, see [[Building the SDK in a container]] instead.		This page describes how to build the Software Development Kit (SDK) for AsteroidOS '''without''' using ''software containers''. If you want to build the SDK using containers, see [[Building the SDK in a container]] instead.

	If you're not sure which you want, skip to [[With or without software containers?]]		If you're not sure which you want, skip to [[Building_the_SDK#With_or_without_software_containers?\|With or without software containers?]]

	If you're not sure why you would want an SDK, continue reading.		If you're not sure why you would want an SDK, continue reading.

Beroset: /* Summary */ fixed typo

2023-11-16T19:42:19Z

Summary: fixed typo

← Older revision		Revision as of 19:42, 16 November 2023
Line 2:		Line 2:

	==Summary==		==Summary==
	This page describes how to build the Software Development Kit (SDK) for AsteroidOS '''without''' using ''software containers''. If you want to build the SDK ~~without~~ using containers, see [[Building the SDK in a container]] instead.		This page describes how to build the Software Development Kit (SDK) for AsteroidOS '''without''' using ''software containers''. If you want to build the SDK using containers, see [[Building the SDK in a container]] instead.

	If you're not sure which you want, skip to [[With or without software containers?]]		If you're not sure which you want, skip to [[With or without software containers?]]

Beroset: factored out the container version of building the SDK

2023-11-16T19:40:15Z

factored out the container version of building the SDK

@@ Line 1: / Line 1: @@
 [[Category:Developers]]
 The Software Development Kit (SDK) for AsteroidOS is a set of tools and libraries for developing software to run on AsteroidOS. Since AsteroidOS is a Linux distribution, you can use just about any programming language to develop software, but most of the core applications use a combination of C++ and Qt, with CMake to build. To get things running quickly, it's recommended to download and install the prebuilt version as described in [[Installing the SDK]]. This page describes how to build the SDK from source.  Be aware that this can take several hours, even on a fast computer.
@@ Line 21: / Line 31: @@
 == Building the Cross Compilation Toolchain ==
-If you’ve already got an OpenEmbedded build directory via the [[Building AsteroidOS]] page, cd to that directory. Else, create one with:
+If you’ve already got an OpenEmbedded build directory via the [[Building AsteroidOS]] page, <code>cd</code> to that directory. Else, create one with:
 <pre>
@@ Line 37: / Line 45: @@
 </pre>
 ==Install the SDK==
@@ Line 65: / Line 50: @@
 ==Related pages==
 [[installing the SDK]]

Beroset: /* Which SDK? */ clarify instructions for building the emulator version of the SDK

2023-11-16T19:14:05Z

Which SDK?: clarify instructions for building the emulator version of the SDK

← Older revision		Revision as of 19:14, 16 November 2023
Line 3:		Line 3:

	==== Which SDK? ====		==== Which SDK? ====
	One thing to note is that while this describes "the SDK", there are actually two versions -- the main one is used to develop software that runs on ARM-based watches running AsteroidOS. The other one is the SDK for developing applications that run on the emulator, which uses qemux86. See the [[Emulator]] page for details on the qemux86 version. This page describes only the main ARM-based SDK but building the emulator version is almost the same ~~-- the~~ difference is that instead of		One thing to note is that while this describes "the SDK", there are actually two versions -- the main one is used to develop software that runs on ARM-based watches running AsteroidOS. The other one is the SDK for developing applications that run on the emulator, which uses qemux86. See the [[Emulator]] page for details on the qemux86 version. This page describes only the main ARM-based SDK but building the emulator version is almost the same. The only difference is that instead of this:
	source ./prepare-build.sh dory		source ./prepare-build.sh dory
	bitbake meta-toolchain-qt5		bitbake meta-toolchain-qt5

Beroset: /* Install the SDK */ note the different name of the emulator SDK installer

2023-11-16T19:09:35Z

Install the SDK: note the different name of the emulator SDK installer

← Older revision		Revision as of 19:09, 16 November 2023
Line 62:		Line 62:

	==Install the SDK==		==Install the SDK==
	Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp-glibc/deploy/sdk/oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code>> directory). Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.		Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp-glibc/deploy/sdk/oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code> directory) -- or a <code>oecore-x86_64-core2-32-toolchain-nodistro.0.sh</code> script if you are building the version of the SDK for the emulator. Follow [[installing the SDK#Installing the SDK\|these steps]] to install the SDK.

	==Related pages==		==Related pages==

Beroset: clarify that there are two versions of the SDK

2023-11-16T19:04:49Z

clarify that there are two versions of the SDK

@@ Line 1: / Line 1: @@
 [[Category:Developers]]
-The Software Development Kit (SDK) for AsteroidOS is a set of tools and libraries for developing software to run on AsteroidOS. Since AsteroidOS is a Linux distribution, you can use just about any programming language to develop software, but most of the core applications use a combination of C++ and Qt, with CMake to build. To get things running quickly, it's recommended to download and install the prebuilt version as described in [[Installing the SDK]]. This page describes how to build the SDK from source.  Be aware that this can take several hours, even on a fast computer. There are two choices to build the SDK: build natively without software containers or build within a software container (such as docker or podman).
+The Software Development Kit (SDK) for AsteroidOS is a set of tools and libraries for developing software to run on AsteroidOS. Since AsteroidOS is a Linux distribution, you can use just about any programming language to develop software, but most of the core applications use a combination of C++ and Qt, with CMake to build. To get things running quickly, it's recommended to download and install the prebuilt version as described in [[Installing the SDK]]. This page describes how to build the SDK from source.  Be aware that this can take several hours, even on a fast computer.
 Building natively requires somewhat fewer resources (memory and disk space) than building with containers but requires software, such a compilers and other tools, to be installed on the host system.  Since these software packages are different for each Linux distribution, this method requires more knowledge and patience to install required software that might not already be installed on your host computer.

Beroset: prettify Related pages

2023-09-03T14:41:43Z

prettify Related pages

← Older revision		Revision as of 14:41, 3 September 2023
Line 52:		Line 52:

	==Related pages==		==Related pages==

	[[installing the SDK]]		[[installing the SDK]]

	[[Building AsteroidOS]]		[[Building AsteroidOS]]

	[[Creating an Asteroid app]]		[[Creating an Asteroid app]]

Beroset: part of refactoring developer instructions to make it easier to follow

2023-09-03T14:40:05Z

part of refactoring developer instructions to make it easier to follow

New page

[[Category:Developers]]
The Software Development Kit (SDK) for AsteroidOS is a set of tools and libraries for developing software to run on AsteroidOS. Since AsteroidOS is a Linux distribution, you can use just about any programming language to develop software, but most of the core applications use a combination of C++ and Qt, with CMake to build. To get things running quickly, it's recommended to download and install the prebuilt version as described in [[Installing the SDK]]. This page describes how to build the SDK from source. Be aware that this can take several hours, even on a fast computer. There are two choices to build the SDK: build natively without software containers or build within a software container (such as docker or podman).

Building natively requires somewhat fewer resources (memory and disk space) than building with containers but requires software, such a compilers and other tools, to be installed on the host system. Since these software packages are different for each Linux distribution, this method requires more knowledge and patience to install required software that might not already be installed on your host computer.

The alternative, building with software containers, is somewhat more simpler in that the required software is only installed within the container and not on your host computer, but it requires much more time to compile everything. Still, this may be preferable for people who wish to keep the build environment isolated from the host computer.

== Building the Cross Compilation Toolchain ==

If you’ve already got an OpenEmbedded build directory via the [[Building AsteroidOS]] page, cd to that directory. Else, create one with:

=== Build without containers ===

<pre>
git clone https://github.com/AsteroidOS/asteroid
cd asteroid/
</pre>

Then, build the cross compilation toolchain with:

<pre>
source ./prepare-build.sh dory
bitbake meta-toolchain-qt5
</pre>

=== Build with containers===

Assuming you already prepared a docker or podman build environment as described in [[Building AsteroidOS]], build the SDK like so:

<pre>
sudo docker rm -f asteroidos-toolchain
sudo docker run -it \
--name asteroidos-toolchain \
-v /etc/passwd:/etc/passwd:ro \
-u "$(id -u):$(id -g)" \
-v "$HOME/.gitconfig:/$HOME/.gitconfig:ro" \
-v "$(pwd):/asteroid" asteroidos-toolchain \
bash -c "source ./prepare-build.sh dory && bitbake meta-toolchain-qt5"
</pre>

or

<pre>
podman run --rm -it \
-v "$(pwd)":/asteroid:z \
--userns keep-id asteroidos-toolchain \
bash -c "source ./prepare-build.sh dory && bitbake meta-toolchain-qt5"
</pre>

==Install the SDK==
Whether you have built with or without containers, if the process was successful, you should have an SDK installation script <code>tmp-glibc/deploy/sdk/oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh</code> (relative to the <code>build</code>> directory). Follow [[installing the SDK#Installing the SDK|these steps]] to install the SDK.

==Related pages==
[[installing the SDK]]
[[Building AsteroidOS]]
[[Creating an Asteroid app]]