Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added app sideload instructions for Android 14+ #29

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 46 additions & 46 deletions Gemfile.lock
Original file line number Diff line number Diff line change
@@ -1,91 +1,91 @@
GEM
remote: https://rubygems.org/
specs:
activesupport (6.0.3.4)
activesupport (7.0.8)
concurrent-ruby (~> 1.0, >= 1.0.2)
i18n (>= 0.7, < 2)
minitest (~> 5.1)
tzinfo (~> 1.1)
zeitwerk (~> 2.2, >= 2.2.2)
addressable (2.7.0)
public_suffix (>= 2.0.2, < 5.0)
i18n (>= 1.6, < 2)
minitest (>= 5.1)
tzinfo (~> 2.0)
addressable (2.8.5)
public_suffix (>= 2.0.2, < 6.0)
colorator (1.1.0)
concurrent-ruby (1.1.8)
em-websocket (0.5.2)
concurrent-ruby (1.2.2)
em-websocket (0.5.3)
eventmachine (>= 0.12.9)
http_parser.rb (~> 0.6.0)
http_parser.rb (~> 0)
eventmachine (1.2.7)
ffi (1.14.2)
ffi (1.16.3)
forwardable-extended (2.6.0)
gemoji (3.0.1)
html-pipeline (2.14.0)
gemoji (4.1.0)
google-protobuf (3.24.4-arm64-darwin)
html-pipeline (2.14.3)
activesupport (>= 2)
nokogiri (>= 1.4)
http_parser.rb (0.6.0)
i18n (1.8.7)
http_parser.rb (0.8.0)
i18n (1.14.1)
concurrent-ruby (~> 1.0)
jekyll (4.1.1)
jekyll (4.3.2)
addressable (~> 2.4)
colorator (~> 1.0)
em-websocket (~> 0.5)
i18n (~> 1.0)
jekyll-sass-converter (~> 2.0)
jekyll-sass-converter (>= 2.0, < 4.0)
jekyll-watch (~> 2.0)
kramdown (~> 2.1)
kramdown (~> 2.3, >= 2.3.1)
kramdown-parser-gfm (~> 1.0)
liquid (~> 4.0)
mercenary (~> 0.4.0)
mercenary (>= 0.3.6, < 0.5)
pathutil (~> 0.9)
rouge (~> 3.0)
rouge (>= 3.0, < 5.0)
safe_yaml (~> 1.0)
terminal-table (~> 1.8)
terminal-table (>= 1.8, < 4.0)
webrick (~> 1.7)
jekyll-paginate (1.1.0)
jekyll-sass-converter (2.1.0)
sassc (> 2.0.1, < 3.0)
jekyll-sass-converter (3.0.0)
sass-embedded (~> 1.54)
jekyll-watch (2.2.1)
listen (~> 3.0)
jemoji (0.12.0)
gemoji (~> 3.0)
jemoji (0.13.0)
gemoji (>= 3, < 5)
html-pipeline (~> 2.2)
jekyll (>= 3.0, < 5.0)
kramdown (2.3.0)
kramdown (2.4.0)
rexml
kramdown-parser-gfm (1.1.0)
kramdown (~> 2.0)
liquid (4.0.3)
listen (3.4.1)
liquid (4.0.4)
listen (3.8.0)
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
mercenary (0.4.0)
minitest (5.14.3)
nokogiri (1.11.1-x86_64-linux)
minitest (5.20.0)
nokogiri (1.15.4-arm64-darwin)
racc (~> 1.4)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
public_suffix (4.0.6)
racc (1.5.2)
rb-fsevent (0.10.4)
public_suffix (5.0.3)
racc (1.7.1)
rb-fsevent (0.11.2)
rb-inotify (0.10.1)
ffi (~> 1.0)
rexml (3.2.4)
rouge (3.26.0)
rexml (3.2.6)
rouge (4.1.3)
safe_yaml (1.0.5)
sassc (2.3.0)
ffi (~> 1.9)
terminal-table (1.8.0)
unicode-display_width (~> 1.1, >= 1.1.1)
thread_safe (0.3.6)
tzinfo (1.2.9)
thread_safe (~> 0.1)
unicode-display_width (1.7.0)
zeitwerk (2.4.2)
sass-embedded (1.63.6-arm64-darwin)
google-protobuf (~> 3.23)
terminal-table (3.0.2)
unicode-display_width (>= 1.1.1, < 3)
tzinfo (2.0.6)
concurrent-ruby (~> 1.0)
unicode-display_width (2.5.0)
webrick (1.8.1)

PLATFORMS
ruby
arm64-darwin-23

DEPENDENCIES
jekyll-paginate
jemoji

BUNDLED WITH
2.1.2
2.2.33
56 changes: 3 additions & 53 deletions _topic/setup-android.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
layout: post
title: "Setup Rebble Web Services"
prompt: "I need help setting up Rebble Web Services"
date: 2021-02-01 07:14:42
author: "Will0, lolrepeatlol"
date: 2023-10-02 07:14:42
author: "Will0, lolrepeatlol, bmacphail"
osSpecific: true
os: android
---
Expand All @@ -12,64 +12,14 @@ os: android

The Pebble app was removed from the Google Play Store due to SMS issues ([Read about it here.](/android-app-unavailable))

If you do not have the Pebble app installed, don't worry, keep following the guide!

If you already have the Pebble app installed but not set up, skip to [Step #4](https://help.rebble.io/setup-android/#4).
If you do not have the Pebble app installed, check out [the guide for installing it](/sideload-android-app).


# Connect your Pebble to its charger

Connect your Pebble to a plugged-in USB charging cable. You really wouldn't want it to lose power in the middle of a firmware update! Once the watch is powered on, press the left button to dismiss the charging screen.


# Download the Pebble APK

On your Android device, download the Pebble APK from the following link:

[APK Download](https://rebble.io/apk)

<notmobile>
or via this QR code:

<qr url="https://rebble.io/apk" />
</notmobile>


# Install the APK

Once you've downloaded the .apk file, open it on your phone by selecting it, then selecting **Install**:

![](/images/setup/3.png)


You might be prompted with the following screen:

![](/images/setup/1.png)


If so, click through to Settings and select "Allow from this source" to enable installation of apps from unknown sources for your preferred file manager.

![](/images/setup/2.png)


This will allow the official Pebble app to be sideloaded. You can revert this setting when the Pebble app is installed if you'd like!

**On earlier versions of Android (7 or below), the permissions step will be slightly different**.

If you are running Android 7 or below:

- Once you've downloaded the .apk file, open Settings.
- Tap "Lock screen and Security," or "Security."
- Tap "Allow installation from unknown sources," "Unknown sources," or a similar option. Then, read the prompt and tap **OK**.
- Go back to the downloaded Pebble APK file in your file manager, and proceed with the installation.

If you are running Android 13:
- Go to Settings > Apps > Pebble
- Tap the top left button (should be three dots)
- Tap on "Restricted Settings" (or something similar)
- Allow the Pebble app to have all permissions

For more information, please check [this Google Help page](https://support.google.com/android/answer/12623953#allowrestrictedsettings)
# Open the Pebble app

You will be greeted by the Pebble Account page. Simply tap 'SKIP LOGIN' twice to continue.
Expand Down
80 changes: 80 additions & 0 deletions _topic/sideload-android-app.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
layout: post
title: "Sideloading the Pebble app on Android"
prompt: "How to install / sideload the Pebble Android app"
keywords: "android 14 apk"
date: 2023-10-04 00:00:00
author: "bmacphail, Will0"
hideFirstStepNumber: true
osSpecific: false
---

# The Pebble app is no longer available in the Google Play store.

You can install it manually using the steps in this guide.

The steps vary by the version of Android your device is running.

If you're not sure which version of Android you have, follow these steps to find out:

1. Open your phone's settings app.
2. Press the search button.
3. Type "Android version" and press the item that comes up.
4. You should be brought to a page where you can see your Android version number.

**If your phone is running Android 13 or below, follow the steps outlined in the section immediately following this one. If your phone is running Android 14 or above, [skip to the section after that](https://help.rebble.io/sideload-android-app/#3).**

# Sideload the Pebble app on Android 13 or below

On your Android device, download the Pebble APK from the following link:

[APK Download](https://rebble.io/apk)

<notmobile>
or via this QR code:

<qr url="https://rebble.io/apk" />
</notmobile>

Once you've downloaded the .apk file, open it on your phone by selecting it, then selecting **Install**:

![](/images/setup/3.png)


You might be prompted with the following screen:

![](/images/setup/1.png)


If so, click through to Settings and select "Allow from this source" to enable installation of apps from unknown sources for your preferred file manager.

![](/images/setup/2.png)

Press the back button if necessary, and tap install.

After following these steps, [go back to the setup guide to activate Rebble Web Services in your Pebble app](/setup-android).

# Sideload the Pebble app on Android 14 or above

> You'll need a computer running [Google Chrome](https://www.google.com/intl/en_ca/chrome/), [Microsoft Edge](https://www.microsoft.com/en-us/edge), or [Opera](https://www.opera.com/), and a USB cable to connect your phone to your computer with.

On your phone, turn on USB debugging:

1. Open the Settings app.
2. Search for "Build number". Tap the first result.
3. In the menu that opens, tap the "Build number" item 7 times. You will get a notification that developer mode has been enabled.
4. Go back to the main Settings menu, and search for "USB debugging". Tap the first result.
5. In the menu that opens, toggle USB debugging on.

Now connect your phone to your computer via your USB cable, and do the following on your computer.

1. [Download the Pebble app APK file to your computer.](https://rebble.io/apk)
2. Go to [Tango ADB](https://tango-adb.github.io/old-demo/) in your browser.
3. Click the blue "⊕ Add" button, and select your phone from the menu that pops up.
4. Click the "Connect" button. Accept the prompt on your phone.
5. Click the "Install APK" menu option, ensure that the "--bypass-low-target-sdk-block (Android 14)" toggle is checked, and click "Browse APK".
6. Find the Pebble app APK that you downloaded in step 1 on your computer.
7. You should receive a message that the install was successful.
8. After about 15 seconds, the app should appear on your phone.

After following these steps, [go back to the setup guide to activate Rebble Web Services in your Pebble app](/setup-android).