View source for Installing the SDK

[[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. This page describes how to install and configure the 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.

= Build or Download =
You can either build the SDK from sources or download a prebuilt version.  Using a prebuilt version is much faster and easier, and is recommended for developers who want to get started quickly.  

The prebuilt SDK is available [https://release.asteroidos.org/nightlies/sdk/oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh here].  If you wish to build it yourself, see [[Building the SDK]].

== Installing the SDK ==
If you downloaded a prebuilt SDK, run the downloaded script. If you built your own, the generated installation script should be in <code>tmp-glibc/deploy/sdk/</code> (relative to the <code>build</code> directory).  In either case, navigate to the directory which contains the <code>oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh</code> script and run it:

<pre>
oecore-x86_64-armv7vehf-neon-toolchain-nodistro.0.sh
</pre>

This script will install the cross-compiler and ARM libraries in <code>/usr/local/oecore-x86_64</code> by default, along with a script that needs to be sourced before every build. If you want to compile software for AsteroidOS on a watch, the command-line steps generally look like this:

<pre>
source /usr/local/oecore-x86_64/environment-setup-armv7vehf-neon-oe-linux-gnueabi
cmake -B build
cmake --build build
</pre>

See [[Creating an Asteroid app]] for next steps.