Import the pebble dev site into devsite/

This commit is contained in:
Katharine Berry 2025-02-17 17:02:33 -08:00
parent 3b92768480
commit 527858cf4c
1359 changed files with 265431 additions and 0 deletions

View file

@ -0,0 +1,18 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
permalink: /sdk/changelogs/
---
<meta http-equiv="refresh" content="0; url={{ site.url }}{{ site.baseurl }}/sdk/changelogs/{{ site.data.sdk.c.version }}/">

View file

@ -0,0 +1,139 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: sdk/markdown
title: Pebble SDK Download
permalink: /sdk/download/
menu_section: sdk
menu_subsection: download
generate_toc: true
scripts:
- 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:
```bash
$ pebble sdk install latest
```
### With Homebrew
If you previously used Homebrew to install older Pebble SDKs, run:
```bash
$ brew update && brew upgrade pebble-sdk
```
If you've never used Homebrew to install the Pebble SDK, run:
```bash
$ 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](/sdk/install/mac/).
## 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](/sdk/install/linux/).
## 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]({{site.links.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]({{site.links.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](http://www.virtualbox.org) (free) or
[VMWare Workstation](http://www.vmware.com/products/workstation/).
2. Install [Ubuntu Linux](http://www.ubuntu.com/) in a virtual machine.
3. Follow the standard [Linux installation instructions](/sdk/install/linux/).
## 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.
<div class="alert alert--fg-white alert--bg-dark-red">
{% 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 %}
</div>
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:
```bash
$ pebble sdk set-channel beta
```
Install the latest beta SDK:
```bash
$ pebble sdk install latest
```

View file

@ -0,0 +1,103 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: default
title: SDK
scripts:
- sdk/index
menu_section: sdk
---
<div class="row no-gutter full-height--m full-height--l">
<div class="col-m-7 full-height">
<div class="bigbox bigbox--lightblue bigbox--half">
<div class="row full-height">
<div class="col-s-4 col-l-5 full-height">
<div class="vcenter--wrapper">
<div class="vcenter">
<img src="{{ site.asset_path }}/images/sdk/cloud.svg" style="width: 50%;">
<h3>CloudPebble</h3>
</div>
</div>
</div>
<div class="col-s-8 col-l-7 full-height">
<div class="vcenter--wrapper">
<div class="vcenter">
<p>CloudPebble is our online IDE that lets you develop Pebble apps without any downloads, setup or installation.</p>
<p>You can access your projects from anywhere, and it keeps your code synced with GitHub automatically.</p>
<a href="{{ site.links.cloudpebble }}" target="_blank" class="btn btn--fg-lightblue btn--bg-white">Launch CloudPebble</a>
</div>
</div>
</div>
</div>
</div>
<div class="bigbox bigbox--lightgray bigbox--half bigbox--has-banner">
<div class="row full-height">
<div class="col-s-4 col-l-5 full-height">
<div class="vcenter--wrapper">
<div class="vcenter">
<img src="{{ site.asset_path }}/images/sdk/sdk-box.svg" style="width: 40%;">
<h3>Pebble SDK</h3>
<p>
Current SDK Version: {{ site.data.sdk.c.version }}<br>
Current Tool Version: {{ site.data.sdk.pebble_tool.version }}
</p>
<p><a href="/sdk/changelogs/{{ site.data.sdk.c.version }}/">Release Notes</a></p>
</div>
</div>
</div>
<div class="col-s-8 col-l-7 full-height">
<div class="vcenter--wrapper">
<div class="vcenter">
<p class="instructions-windows" style="display: none">Installing the Pebble SDK directly on Windows is not supported at this time. We recommend you use CloudPebble or run a Linux virtual machine.</p>
<p class="instructions-linux" style="display: none">
Download the SDK using one of the options below, then follow the installation instructions.
</p>
<div class="instructions-mac" style="display: none">
<h4>Install with <a href="http://brew.sh" target="_blank">Homebrew</a></h4>
{% include sdk/homebrew.html %}
<p style="font-size: 1.1em; text-transform: uppercase; color: #aaa; text-align: center; margin: 1.5em 0 0;">Having Problems?</p>
<p style="margin: 0; font-size: 1.0em;"><a href="/sdk/install/mac/">Manual Install</a></p>
</div>
<div class="instructions-linux instructions-windows instructions-other" style="display: none">
<p><a href="/sdk/install/" class="js-sdk-link">SDK Installation Instructions</a></p>
<a href="/sdk/download/" class="btn btn--fg-white btn--bg-lightblue">Download the SDK</a>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="col-m-5 full-height">
<div class="bigbox bigbox--gray bigbox--half">
<div class="vcenter--wrapper">
<div class="vcenter">
<h3>Mobile App SDKs</h3>
<p>If you're looking to write an iOS or Android app that works with Pebble, you should check out our native PebbleKit libraries, both of which are available on GitHub.</p>
<p>
<a href="{{ site.links.pebblekit_android }}" target="_blank" class="btn btn--fg-lightblue btn--bg-white">Android</a>
<a href="{{ site.links.pebblekit_ios }}" target="_blank" class="btn btn--fg-blue btn--bg-white">iOS</a>
</p>
<p>
PebbleKit Android Version: {{ site.data.sdk.pebblekit-android.version }}<br>
PebbleKit iOS Version: {{ site.data.sdk.pebblekit-ios.version }}
</p>
</div>
</div>
</div>
<div class="bigbox bigbox--gray bigbox--half" style="min-height: 200px; background-image: url('{{ site.asset_path }}/images/sdk/pebblekit.svg'); background-repeat: no-repeat; background-position: center bottom; background-size: auto 90%">
</div>
</div>
</div>

View file

@ -0,0 +1,51 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: sdk/markdown
menu_subsection: install
title: Installing the Pebble SDK
---
## Develop Online
You can use [CloudPebble]({{ site.links.cloudpebble }}) to build, compile
and test Pebble apps entirely in the cloud without any installation needed.
## Install Through Homebrew
We recommend Mac OS X users [install the SDK using Homebrew](/sdk/download).
## Manual Installation
Once you have [downloaded the Pebble SDK](/sdk/download/), you will need to
follow the instructions for your platform.
## [Mac OS X](/sdk/install/mac/) | [Linux](/sdk/install/linux/) | [Windows](/sdk/install/windows/)
### Problems Installing?
If you need help installing the SDK, feel free to post your comments in the
[SDK Installation Help forum][sdk-install-help]. Please make sure you
provide as many details as you can about the issues
you may have encountered.
**Tip:** Copying and pasting commands from your Terminal output will help a great deal.
### What's Next?
Once you have installed the Pebble SDK, you should check out our
[Tutorials](/tutorials/) section to learn the basics of Pebble development.
[sdk-install-help]: https://forums.getpebble.com/categories/sdk-install/

View file

@ -0,0 +1,54 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: sdk/markdown
title: Installing the Pebble SDK on Linux
description: Detailed installation instructions for the Pebble SDK on Linux.
menu_subsection: install
menu_platform: linux
generate_toc: true
permalink: /sdk/install/linux/
---
> **Important**: The Pebble SDK is officially supported on
> Ubuntu GNU/Linux 12.04 LTS, Ubuntu 13.04, Ubuntu 13.10 and Ubuntu 14.04 LTS.
>
> The SDK should also work on other distributions with minor adjustments.
>
> **Python version**: the Pebble SDK requires Python 2.7. At this time, the
> Pebble SDK is not compatible with Python 3. However, some newer
> distributions come with both Python 2.7 and Python 3 installed, which can
> cause problems. You can use </br>`python --version` to determine which is being
> used. This means you may need to run `pip2` instead of `pip` when prompted to
> do so below.
## Download and install the Pebble SDK
{% include sdk/steps_install_sdk.md mac=false %}
{% include sdk/steps_python.md mac=false %}
## Install Pebble emulator dependencies
The Pebble emulator requires some libraries that you may not have installed on
your system.
```bash
sudo apt-get install libsdl1.2debian libfdt1 libpixman-1-0
```
{% include sdk/steps_getting_started.md %}
{% include sdk/steps_help.md %}

View file

@ -0,0 +1,79 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: sdk/markdown
title: Installing the Pebble SDK on Mac OS X
description: Detailed installation instructions for the Pebble SDK on Mac OS X.
menu_subsection: install
menu_platform: mac
generate_toc: true
permalink: /sdk/install/mac/
---
These are the manual installation instructions for installing the Pebble SDK
from a download bundle. We recommend you
[install the SDK using Homebrew](/sdk/download) instead, if possible.
### Compatibility
> **Python version**: the Pebble SDK requires Python 2.7. At this time, the
> Pebble SDK is not compatible with Python 3. However, some newer
> distributions come with both Python 2.7 and Python 3 installed, which can
> cause problems. You can use </br>`python --version` to determine which is being
> used. This means you may need to run `pip2` instead of `pip` when prompted to
> do so below.
### Download and install the Pebble SDK
1. Install the [Xcode Command Line Tools][xcode-command-line-tools] from
Apple if you do not have them already.
{% include sdk/steps_install_sdk.md mac=true %}
{% include sdk/steps_python.md mac=true %}
### Pebble SDK, fonts and freetype
To manipulate and generate fonts, the Pebble SDK requires the freetype library.
If you intend to use custom fonts in your apps, please use
[homebrew][homebrew-install] to install the freetype library.
```bash
brew install freetype
```
### Install Pebble emulator dependencies
The Pebble emulator requires some libraries that you may not have installed on
your system.
The easiest way to install these dependencies is to use [homebrew][homebrew-install].
```bash
brew update
brew install boost-python
brew install glib
brew install pixman
```
> If you have installed Python using Homebrew, you **must** install boost-python
> from source. You can do that with `brew install boost-python --build-from-source` .
{% include sdk/steps_getting_started.md %}
{% include sdk/steps_help.md %}
[xcode-command-line-tools]: https://developer.apple.com/downloads/
[homebrew-install]: http://brew.sh/

View file

@ -0,0 +1,60 @@
---
# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
layout: sdk/markdown
title: Installing the Pebble SDK on Windows
description: Detailed installation instructions for the Pebble SDK on Windows.
menu_subsection: install
menu_platform: windows
generate_toc: true
permalink: /sdk/install/windows/
---
Installing the Pebble SDK on Windows is not officially supported at this time.
However, you can choose from several alternative strategies to develop
watchfaces and watchapps on Windows.
## Use CloudPebble
[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][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](http://www.virtualbox.org) (free) or
[VMWare Workstation](http://www.vmware.com/products/workstation/).
2. Install [Ubuntu Linux](http://www.ubuntu.com/) in a virtual machine.
3. Follow the standard [Linux installation instructions](/sdk/install/linux/).
## Need installation help?
If you need help installing the SDK, feel free to post in the
[SDK Installation Help forum][sdk-install-help].
Please make sure you provide as many details as you can about the issue you have
encountered (copy/pasting your terminal output will help a lot).
[cloudpebble]: {{ site.links.cloudpebble }}
[sdk-install-help]: https://forums.getpebble.com/categories/sdk-install/