Skip to content

Commit

Permalink
Branch android install instructions based on OS version (#35)
Browse files Browse the repository at this point in the history
* Add support for hidenav element to hide nav buttons

* Branch Android install instructions by version

* Minor copy change
  • Loading branch information
Willow-Systems authored Jul 9, 2024
1 parent 67ffc0b commit 292a4b5
Show file tree
Hide file tree
Showing 3 changed files with 88 additions and 18 deletions.
65 changes: 65 additions & 0 deletions _topic/setup-android-14.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
layout: post
title: "Setup Rebble Web Services"
prompt: "I need help setting up Rebble Web Services"
date: 2024-07-08 07:14:42
author: "Will0"
hideFirstStepNumber: true
osSpecific: true
os: android
---

# Android 14 blocks Pebble installation

Android 14 introduced new restrictions around SDK target version for apps you can install. Because the Pebble app is no longer actively maintained, some phones will refuse to install it.

In this guide we'll use ADB to bypass this.

# Install ADB

If you don't already have it setup, install Android Debug Bridge using [the instructions linked here](https://www.xda-developers.com/install-adb-windows-macos-linux/)

# Download the the Pebble APK

On your PC, download the Pebble APK from the following link:

[APK Download](https://binaries.rebble.io/apks/pebble-4.4.3.apk)

Save the file to your PC.

# Connect ADB to your phone

Connect your phone to your computer with a cable, and ensure you have debugging enabled in developer settings:

![](/images/adb/debugging.jpg)

If you don't see the developer options menu in settings, [first follow these instructions](https://developer.android.com/studio/debug/dev-options), then enable debugging.

On your computer run `adb devices` in a terminal. If you see a prompt on your phone like the one below, accept it.

![](/images/adb/allow.jpg)

# Install the app

Now run `adb install --bypass-low-target-sdk-block pebble-4.4.3.apk` on your computer. This will install the Pebble app onto your phone.

![](/images/adb/terminal.png)

Make sure the Pebble APK is in the same folder you're running your terminal in.

The Pebble app is now installed on your phone!

# Grant restricted settings access

- 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)

# Setup the Pebble app

[Click here to continue](/setup-android/#6)

<hidenav />
35 changes: 18 additions & 17 deletions _topic/setup-android.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ osSpecific: true
os: android
---

# Android app removal
# Android app

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

Expand All @@ -17,10 +17,15 @@ If you do not have the Pebble app installed, don't worry, keep following the gui
If you already have the Pebble app installed but not set up, skip to [Step #4](https://help.rebble.io/setup-android/#4).


# Connect your Pebble to its charger
# Select your Android version

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.
The instructions are slightly different depending on the version of Android your phone is running.

To find your OS version, go to Settings -> About Phone -> Software and look for "Android Version"

If you are running Android 13 or earlier, press 'Next Step' below.

[If you are running Android 14 or newer, click here.](/setup-android-14)

# Download the Pebble APK

Expand All @@ -46,34 +51,30 @@ 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 Android 14+ you may be blocked from install the Pebble app due to it's age.**
# Grant access to restricted settings

In this case, you should use ADB to bypass this restriction. [Click here to view the guide on how to do this.](/apk-load-android/)
If you are on Android 8 or newer:

**On earlier versions of Android (7 or below), the permissions step will be slightly different**.
- 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

If you are running Android 7 or below:
If you are running Android 7 or earlier:

- 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**.
- 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 Expand Up @@ -174,6 +175,6 @@ If you want to use dictation, get weather pins in your Timeline, and have a fast

If you have any other questions, [contact us on Discord!](/discord)

## Welcome to *Rebbled* Pebble!
## Welcome to Rebble!

![noborder](/images/setup/13.png)
6 changes: 5 additions & 1 deletion res/js/helpPost.js
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,10 @@ function selectStep(stepID) {
$('#btn_prev').removeClass("hidden");
}

if (steps[currentStep].content[steps[currentStep].content.length-1].outerHTML.includes("<hidenav>")) {
$("#navButtons").addClass("hidden");
}

location.hash = '#' + stepID;

$('html,body').scrollTop(0);
Expand All @@ -151,4 +155,4 @@ if (findGetParameter("viewall") == "true") {
}

createQRCodes();
pageToStepByStep();
pageToStepByStep();

0 comments on commit 292a4b5

Please sign in to comment.