Feature/adb install helper

.gitignore

@@ -1 +1,2 @@
 _site/
+Gemfile.lock

Gemfile.lock

@@ -1,91 +1,172 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.4)
-      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)
+    activesupport (7.2.1.2)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    base64 (0.2.0)
+    bigdecimal (3.1.8)
     colorator (1.1.0)
-    concurrent-ruby (1.1.8)
-    em-websocket (0.5.2)
+    concurrent-ruby (1.3.4)
+    connection_pool (2.4.1)
+    drb (2.2.1)
+    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.17.0-aarch64-linux-gnu)
+    ffi (1.17.0-aarch64-linux-musl)
+    ffi (1.17.0-arm-linux-gnu)
+    ffi (1.17.0-arm-linux-musl)
+    ffi (1.17.0-arm64-darwin)
+    ffi (1.17.0-x86-linux-gnu)
+    ffi (1.17.0-x86-linux-musl)
+    ffi (1.17.0-x86_64-darwin)
+    ffi (1.17.0-x86_64-linux-gnu)
+    ffi (1.17.0-x86_64-linux-musl)
     forwardable-extended (2.6.0)
-    gemoji (3.0.1)
-    html-pipeline (2.14.0)
+    gemoji (4.1.0)
+    google-protobuf (4.28.3)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-aarch64-linux)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-arm64-darwin)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86-linux)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86_64-darwin)
+      bigdecimal
+      rake (>= 13)
+    google-protobuf (4.28.3-x86_64-linux)
+      bigdecimal
+      rake (>= 13)
+    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.6)
       concurrent-ruby (~> 1.0)
-    jekyll (4.1.1)
+    jekyll (4.3.4)
       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.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.6.1)
     mercenary (0.4.0)
-    minitest (5.14.3)
-    nokogiri (1.11.1-x86_64-linux)
+    minitest (5.25.1)
+    nokogiri (1.16.7-aarch64-linux)
+      racc (~> 1.4)
+    nokogiri (1.16.7-arm-linux)
+      racc (~> 1.4)
+    nokogiri (1.16.7-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.16.7-x86-linux)
+      racc (~> 1.4)
+    nokogiri (1.16.7-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.16.7-x86_64-linux)
       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)
-    rb-inotify (0.10.1)
+    public_suffix (6.0.1)
+    racc (1.8.1)
+    rake (13.2.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.2.4)
-    rouge (3.26.0)
+    rexml (3.3.9)
+    rouge (4.4.0)
     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.80.4-aarch64-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-aarch64-linux-musl)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-arm-linux-gnueabihf)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-arm-linux-musleabihf)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-arm64-darwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-x86-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-x86-linux-musl)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-x86_64-darwin)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-x86_64-linux-gnu)
+      google-protobuf (~> 4.28)
+    sass-embedded (1.80.4-x86_64-linux-musl)
+      google-protobuf (~> 4.28)
+    securerandom (0.3.1)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.6.0)
+    webrick (1.8.2)
 
 PLATFORMS
-  ruby
+  aarch64-linux
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux
+  arm-linux-gnu
+  arm-linux-gnueabihf
+  arm-linux-musl
+  arm-linux-musleabihf
+  arm64-darwin
+  x86-linux
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux
+  x86_64-linux-musl
 
 DEPENDENCIES
   jekyll-paginate
   jemoji
 
 BUNDLED WITH
-   2.1.2
+   2.5.22

_includes/android_installer.html

@@ -0,0 +1,47 @@
+<div class="timeline" id="android_installer" hidden>
+    <div class="line-container">
+        <div class="line"></div>
+    </div>
+    <div class="step active">
+        <div class="step-circle">1</div>
+        <div class="step-content">
+            <h2>Connect your phone</h2>
+            <ol>
+                <li>Connect your phone to your computer with a USB cable.</li>
+                <li>
+                    Enable USB debugging on your phone.
+                    <ul>
+                        <li>Go to Settings > About phone > Software information.</li>
+                        <li>Tap "Build number" seven times.</li>
+                        <li>Go back to the main settings screen and tap "Developer options".</li>
+                        <li>Enable "USB debugging".</li>
+                    </ul>
+                </li>
+                <li>Click the button below to connect your device. Follow prompts from your browser.</li>
+            </ol>
+            <button class="mt-5 highlight" id="connect">Connect <i class="fas fa-link"></i></button>
+        </div>
+    </div>
+    <div class="step upcoming">
+        <div class="step-circle">2</div>
+        <div class="step-content">
+            <h2>Begin Installation</h2>
+            <p>Once you click the button below, we'll start the installation process on your phone. <em>Do not
+                    disconnect your phone during this process. Keep your phone awake during the process.</em></p>
+            <p id="status_text"></p>
+            <button class="mt-5 previousstep highlight" id="install"> Install <i class="fas fa-download"></i></button>
+        </div>
+    </div>
+    <div class="step upcoming">
+        <div class="step-circle">3</div>
+        <div class="step-content">
+            <h2>All done!</h2>
+            <a href="/setup-android/#5">Continue with the Android setup guide.</a><br />
+            <img width="200" height="200" style="border:0;" src="{{ site.baseurl }}/images/setup/13.png">
+        </div>
+    </div>
+</div>
+<script src="{{ site.baseurl }}/res/js/adb.js"></script>
+<script src="{{ site.baseurl }}/res/js/androidInstaller.js"></script>
+
+

_topic/apk-load-android.md

@@ -15,6 +15,10 @@ You may see an error upon trying to install the apk which says "App can't be ins
 
 In this guide we'll use ADB to bypass this.
 
+# Try the install helper
+
+If you have a computer running Google Chrome, you can use our [install helper](/android-installer) to install the Pebble app on your phone. If that doesn't work, continue with the manual instructions.
+
 # 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/)

_topic/setup-android-14.md

@@ -15,6 +15,10 @@ Android 14 introduced new restrictions around SDK target version for apps you ca
 
 In this guide we'll use ADB to bypass this.
 
+# Try the install helper
+
+If you have a computer running Google Chrome, you can use our [install helper](/android-installer) to install the Pebble app on your phone. If that doesn't work, continue with the manual instructions.
+
 # 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/)

android-installer/index.md

@@ -0,0 +1,24 @@
+---
+layout: viewall
+title: "Android Install Helper"
+prompt: "Install the Pebble app on your Android 14+ device"
+keywords: "android 14 not compatible apk install sideload"
+date:   2024-10-24 17:01:19
+author: "blockarchitech"
+hideFirstStepNumber: true
+osSpecific: true
+os: android
+---
+
+# Android Install Helper
+
+This tool will guide you through the process of installing the Pebble app on your Android 14+ device.
+
+<nodesktop>
+  <alert>
+    <strong>Important:</strong> This guide is not compatible with your device. Please use a computer running Google Chrome to install the Pebble app, or use the <a href="/apk-load-android">manual installation guide</a>.
+  </alert>
+</nodesktop>
+<notmobile>
+  {% include android_installer.html %}
+</notmobile>