Pebble Foundation Classes (C++ for Pebble)

This Pebble Package gives you the ability to code Pebble watchapps using C++. It wraps the Pebble API in an low-overhead header-only object-oriented library.

Why would you do this?!?

"The reasonable man adapts himself to the world; the unreasonable one persists in trying to adapt the world to himself. Therefore, all progress depends on the unreasonable man." - George Bernard Shaw

I primarily work in high-level languages like C#, Java, Python, and C++, so organizing my Pebble watchapp code in C quickly became a challenge. As my projects grew, managing structs, callback contexts, and especially global variables became increasingly difficult.

In the fall of 2014, I started this project to bring C++ to Pebble development. It was full of false starts and tough problems, but I eventually solved the major hurdles and just needed to flesh out the library. However, when Pebble shut down, I set the project aside.

When the first Rebble Hackathon was announced, it felt like the perfect time to either finish what I started or at least release it to the world.

Features and Benefits

• PFC classes automatically manage the context pointer in Pebble OS callbacks.
• All PFC methods are inline with low-to-zero overhead.
• Ability to use STL classes like std::string, std::vector, and std::unique_ptr for more high-level development.
• Organize your Windows and Layers into their own classes.
• Use RAII to automatically free resources when they are no longer needed.
• Fully compatible with the Pebble C API -- you can call C functions with PFC class instances as parameters and use Pebble C types with C++ classes and methods.

Getting Started

To get started, please check out the following pages:

• Simple C++ Application Tutorial
• Using this SDK

They provide detailed information about configuring the project to build C++ files and how to structure your code.

Documentaton

View the complete documentation by clicking the link below:

• Pebble Foundation Classes Documentation

Example and Tutorial Programs

You can view and download various sample projects from the site below:

• Pebble Foundation Classes Example Projects GitHub

Getting Help

You can get help with this SDK using the Issues tab in this project or by using the Rebble Alliance Discord.

Also please check out the Known Issues page.

Contributing

This project is currently under an active development. Code quality and stability is the primary focus, so any bug fixing requests and/or fixing changes will appreciated. If you want to help this project:

• Any help in testing the SDK are very appreciated. You can leave information about found defects on the Issues tab;
• Anyone who would like to provide a fix for any found defect are welcome. Please, create pull requests for fixing changes;
• You are welcome to create pull requests for new features and new Pebble API wrappers;
• Additional Sample Applications that demonstrate features of the SDK are appreciated.

How to inform about found defects

• First of all, please check project Issues on GitHub and Known Issues in CHANGELOG. The issue you found might be already recorded.
• Check that the issue is reproducible and describe it.
• Ideally, create a small test program that exposes the problem.