Home

Awesome

Haskell binding to Apple's SpriteKit framework

Open source under BSD3 license. Contributions under the same license are most welcome.

To build this project, you need a recent version of Xcode and GHC 8.0.2. If you don't want to build it yourself, a pre-compiled version comes with Haskell for Mac, which also provides the best Haskell SpriteKit development experience.

This code has currently only been tested on macOS. The main obstacle to using it on iOS is lack of support for Template Haskell (and hence, language-c-inline) by GHC for iOS, but What is New in Cross Compiling Haskell might help.

The talk Haskell SpriteKit — A Purely Functional API for a Stateful Animation System & Physics Engine discusses the architecture of Haskell SpriteKit — see also the accompanying paper Haskell SpriteKit — Transforming an Imperative Object-oriented API into a Purely Functional One.

An example game: Shades

Shades Loop

Have a look at a clone of the mobile games Shades as a simple example to get you started:

https://github.com/gckeller/shades

This implementation of Shades is explained in detail in the paper Haskell SpriteKit — Transforming an Imperative Object-oriented API into a Purely Functional One, which provides an overview of the design and internals of Haskell SpiteKit.

Another example game: Lazy Lambda

Lazy Lambda Loop

As a second example of a simple game in Haskell SpriteKit, have a look at Lazy Lambda, a Flappy Bird clone:

https://github.com/mchakravarty/lazy-lambda

For an explanation of the main concepts of the Haskell SpriteKit binding including live coding of Lazy Lambda, watch the talk Playing with Graphics and Animations in Haskell (includes video and slides).

Building with a stock GHC distribution

Unfortunately, a quick and easy cabal or stack-based build is not possible. In addition to Haskell, this project includes Objective-C and Swift code, and neither cabal nor stack can handle this properly.

The build requirements are as follows:

Open the project in Xcode and build or archive. In either case, the build procedure will install a fair few packages from Hackage into your user package database (see the .cabal file in the spritekit directory for details), including a spritekit package. Moreover, Xcode will produce a HaskellSpriteKit.framework. The documentation is only built in Release mode.

To use, HaskellSpriteKit.framework in an app, you need to do the following:

The build system assumes that everything is going to be linked dynamically.

An example

If you like to see concrete example code of how to build a standalone Mac app embedding a Haskell SpriteKit scene, check out the ShadesApp folder of Shades. Follow the instructions above for building the Haskell SpriteKit framework with a stock GHC (requires GHC 8.02) and then, the instructions at Shades for how to compile the Swift wrapper and generate an app bundle containing everything.

NB: The basic set up is similar to Haskell for Mac, and hence, suitable for distribution through the Mac App Store.

Feature set

For details of the supported API, see the current Haddock documentation (currently version 0.9.0.0).

Supported features

The Haskell binding supports the following SpriteKit node types:

Moreover, almost all SpriteKit animation actions (SKAction) are supported as well as textures and graphics paths (to define polygons and Bézier curves). All the basic features of the physics engine are supported, such as gravity, collisions, contact handlers, various material properties, as well as volume-based and edged-based physics bodies.

Unsupported features

Most of the missing features can be supported quite easily by simply following the same approach as used in the existing code. (Just open an issue if you are looking for something specific. Or, if you can, implement it and open a pull request.)

Moreover, this project needs a proper suite of unit tests.