pebble/devsite/source/sdk/download.md
2025-02-24 18:58:29 -08:00

4.1 KiB

layout title permalink menu_section menu_subsection generate_toc scripts
sdk/markdown Pebble SDK Download /sdk/download/ sdk download true
sdk/index

Get the Latest Pebble Tool

The pebble tool allows you to quickly switch between different SDK versions. The instructions to obtain the tool vary depending on your platform. All specific instructions are shown on this page.

Mac OS X

The Pebble SDK can be installed automatically using Homebrew, or manually if preferred. If you already use at least version 4.0 of the pebble tool, you can install the latest SDK by running the following command:

$ pebble sdk install latest

With Homebrew

If you previously used Homebrew to install older Pebble SDKs, run:

$ brew update && brew upgrade pebble-sdk

If you've never used Homebrew to install the Pebble SDK, run:

$ brew update && brew install pebble/pebble-sdk/pebble-sdk

Without Homebrew

If you would prefer to not use Homebrew and would like to manually install the Pebble SDK:

  1. Download the [SDK package]({{ site.links.pebble_tool_root }}pebble-sdk-{{ site.data.sdk.pebble_tool.version }}-mac.tar.bz2).

  2. Follow the Mac manual installation instructions.

Linux

Linux users should install the SDK manually using the instructions below:

  1. Download the relevant package: [Linux (32-bit)]({{ site.links.pebble_tool_root }}pebble-sdk-{{ site.data.sdk.pebble_tool.version }}-linux32.tar.bz2) | [Linux (64-bit)]({{ site.links.pebble_tool_root }}pebble-sdk-{{ site.data.sdk.pebble_tool.version }}-linux64.tar.bz2).

  2. Install the SDK by following the manual installation instructions.

Windows

Installing the Pebble SDK on Windows is not officially supported at this time. However, you can choose from alternative strategies to develop watchfaces and watchapps on Windows, which are detailed below.

Use CloudPebble

CloudPebble is the official online development environment for writing Pebble apps. It allows you to create, edit, build and distribute applications in your web browser without installing anything on your computer.

Pebble strongly recommends CloudPebble for Windows users.

Use a Virtual Machine

You can also download and run the Pebble SDK in a virtual machine.

  1. Install a virtual machine manager such as VirtualBox (free) or VMWare Workstation.
  2. Install Ubuntu Linux in a virtual machine.
  3. Follow the standard Linux installation instructions.

Testing Beta SDKs

Beta SDKs are released in the run up to stable SDK releases, and give interested developers a chance to test out new features and APIs and provide feedback.

You can opt-in to the beta channel to receive beta SDKs. Once the beta period ends, you will be notified of the update to the final stable version.

{% markdown %} **IMPORTANT**

Apps built with a beta SDK must not be uploaded to the developer portal, as users not yet on the new firmware version will be unable to install them. {% endmarkdown %}

Once you have the latest pebble tool, you can easily access and try out new beta SDKs we release from time to time by switching to the 'beta' sdk channel:

$ pebble sdk set-channel beta

Install the latest beta SDK:

$ pebble sdk install latest