Software Development Kit for portable applications.
Provides APIs for...
- Low-level 2D rendering
- Simple GUIs
- Audio processing and synthesis
- MIDI
- Console applications
- Command line processing
- A light-weight curses API
- Some static data structures suitable for an embedded or limited memory enviornment
The intended deployment of the PDK is as a submodule inside other projects.
Create a new git project directory and add the PDK as a git submodule.
mkdir MyProject
cd MyProject
git init .
git submodule add https://github.com/SloeComputers/PDK.git
cd PDK
make template
The project template installer should run..
Project dir [/Users/fred/MyProjects] : <project root directory>
Copyright owner [John D. Haughton] : <copyright owner>
Copyright year [2017] : <copyright year>
User name [SloeComputers] : <GitHub user id>
Application [MyProject] : <name of application>
Version [0.0.0] : <initial version>
Description [Example application] : <application purpose>
Binary [foo] : <filename of application binary>
Install 'CMakeLists.txt' to '<project root directory>'
Install 'LICENSE' to '<project root directory>'
Install 'Makefile' to '<project root directory>'
Install '<filename of application binary>.cpp' to '<project root directory>/Source'
Install 'CMakeLists.txt' to '<project root directory>/Source'
Install 'README.md' to '<project root directory>'
Install '.gitignore' to '<project root directory>'
Install '_config.yml' to '<project root directory>'
Install '.clang-format' to '<project root directory>'
Install 'build_on_push.yml' to '<project root dir>/.github/workflows'
Add the newly instantiated project as an initial git patch then build.
cd ..
git add .
git commit -m Initial
make
Run the example application just built. (Try with -v and -h too)
build/native/Source/myproject
Hello, world!
The following small projects are using the PDK...
One of the primary target platforms.
Depend on SDL2, so a development install of SDL2 is required.
Typically the following packages will be required...
sudo apt-get install cmake
sudo apt-get install libsdl2-dev
One of the primary target platforms.
Depend on SDL2, so a development install of SDL2 is required.
Typically the following packages will be required...
brew update
brew install cmake
brew install sdl2
NOTE: The current version of SDL2 (2.0.8) does not work properly on macOS 10.14 Mojave. The following patch seems to resolve the issue.
Although this is also a Linux build, it does not depend on SDL2.
Requires gcc/g++ built for arm-linux-gnueabihf targets that supports C++11 and a set of headers and static runtime libraries that are compatible with the Linux kernel v2.6.26 installed on the Kindle3.
The original ARMv6 Raspberry Pi running a Debian based Linux has been found to be suitable platform to build for Kindle3. But this is far easier if an old version of Rasbian (Wheezy) is used to ensure that libc is compatible with the old kernel on the Kindle.
Other packages required...
sudo apt-get install cmake
sudo apt-get install g++-4.7
Uses the SDL2 library supplied with Emscripten.
Requires access to a source installation of SDL2 which is built into a linSDL2.a as part of the application build process.
Build of an actual app has not been achieved yet, and may not be easily achievable without an Xcode project file.
Requires an NDK installation. Currently builds as a console only app as an integration with an Android build of SDL2 has not been achieved yet.
The source is C++ but has the following non-typical for modern C++ features ...
- Memory is mostly statically or stack allocated in preference to new/delete
- Very limited STL usage
- Use of C style stdio API
- In some places have re-invented the wheel avoiding functionality that is in standard libraries
- Refer to STYLE.md and the repository
.clang-formatfor specific naming and formatting preferences.