diff options
| author | Daniel Micay <danielmicay@gmail.com> | 2021-01-03 22:03:08 -0500 |
|---|---|---|
| committer | Daniel Micay <danielmicay@gmail.com> | 2021-01-03 22:03:08 -0500 |
| commit | 7777f6604950bca924586519ea175550644ddaba (patch) | |
| tree | aee638e58100ef48655d16fbedb3848637c026c7 /static/install.html | |
| parent | 9a1b6e3fea4522792750a6ddab015bf58c6cb6bc (diff) | |
move obtaining fastboot out of prerequisites
Diffstat (limited to 'static/install.html')
| -rw-r--r-- | static/install.html | 138 |
1 files changed, 67 insertions, 71 deletions
diff --git a/static/install.html b/static/install.html index 358884fb..928bc3bb 100644 --- a/static/install.html +++ b/static/install.html @@ -57,19 +57,15 @@ <h2><a href="#table-of-contents">Table of contents</a></h2> <ul> + <li><a href="#prerequisites">Prerequisites</a></li> + <li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></li> <li> - <a href="#prerequisites">Prerequisites</a> + <a href="#obtaining-fastboot">Obtaining fastboot</a> <ul> - <li> - <a href="#obtaining-fastboot">Obtaining fastboot</a> - <ul> - <li><a href="#standalone-platform-tools">Standalone platform-tools</a></li> - <li><a href="#checking-fastboot-version">Checking fastboot version</a></li> - </ul> - </li> + <li><a href="#standalone-platform-tools">Standalone platform-tools</a></li> + <li><a href="#checking-fastboot-version">Checking fastboot version</a></li> </ul> </li> - <li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></li> <li><a href="#fastboot-as-non-root">Fastboot as non-root</a></li> <li><a href="#connecting-phone">Connecting the phone</a></li> <li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li> @@ -141,101 +137,101 @@ <p>These instructions use command-line tools. On Windows, use PowerShell rather than the legacy Command Prompt. Open up a single terminal and use it for the whole installation process.</p> + </section> + + <section id="enabling-oem-unlocking"> + <h2><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></h2> + + <p>OEM unlocking needs to be enabled from within the operating system.</p> + + <p>Enable the developer options menu by going to Settings ➔ About phone and + pressing on the build number menu entry until developer mode is enabled.</p> + + <p>Next, go to Settings ➔ System ➔ Advanced ➔ Developer options and toggle on the + 'Enable OEM unlocking' setting. This requires internet access on devices with Google + Play services as part of Factory Reset Protection (FRP) for anti-theft protection.</p> + </section> - <section id="obtaining-fastboot"> - <h3><a href="#obtaining-fastboot">Obtaining fastboot</a></h3> + <section id="obtaining-fastboot"> + <h2><a href="#obtaining-fastboot">Obtaining fastboot</a></h2> - <p>You need an updated copy of the <code>fastboot</code> tool and the - directory containing it needs to be included in the <code>PATH</code> - environment variable. You can run <code>fastboot --version</code> to determine - the current version. It must be at least <code>29.0.6</code>. You can use a - distribution package for this, but most of them mistakenly package development - snapshots of fastboot, clobber the standard version scheme for platform-tools - (adb, fastboot, etc.) with their own scheme and don't keep it up-to-date - despite that being crucial.</p> + <p>You need an updated copy of the <code>fastboot</code> tool and the + directory containing it needs to be included in the <code>PATH</code> + environment variable. You can run <code>fastboot --version</code> to determine + the current version. It must be at least <code>29.0.6</code>. You can use a + distribution package for this, but most of them mistakenly package development + snapshots of fastboot, clobber the standard version scheme for platform-tools + (adb, fastboot, etc.) with their own scheme and don't keep it up-to-date + despite that being crucial.</p> - <p>List of distribution packages:</p> + <p>List of distribution packages:</p> - <ul> - <li>Arch Linux: <code>android-tools</code> provides fastboot and other useful - tools not required for installation such as adb. Skip the section - below on using the standalone platform-tools releases.</li> - <li>Debian and Ubuntu: The adb and fastboot packages are currently both - broken and far too out-of-date to be any use, so avoid those. The - version check in the flashing script will prevent accidentally using - these.</li> - </ul> + <ul> + <li>Arch Linux: <code>android-tools</code> provides fastboot and other useful + tools not required for installation such as adb. Skip the section + below on using the standalone platform-tools releases.</li> + <li>Debian and Ubuntu: The adb and fastboot packages are currently both + broken and far too out-of-date to be any use, so avoid those. The + version check in the flashing script will prevent accidentally using + these.</li> + </ul> - <section id="standalone-platform-tools"> - <h4><a href="#standalone-platform-tools">Standalone platform-tools</a></h4> + <section id="standalone-platform-tools"> + <h3><a href="#standalone-platform-tools">Standalone platform-tools</a></h3> - <!-- https://developer.android.com/studio/releases/platform-tools --> + <!-- https://developer.android.com/studio/releases/platform-tools --> - <p>If your operating system doesn't include a usable version of fastboot, - you can use the official standalone releases of platform-tools. This is - our recommendation for most users. The flashing process won't work unless - you follow these instructions including setting up PATH.</p> + <p>If your operating system doesn't include a usable version of fastboot, + you can use the official standalone releases of platform-tools. This is + our recommendation for most users. The flashing process won't work unless + you follow these instructions including setting up PATH.</p> - <p>To download, verify and extract the standalone platform-tools on Linux:</p> + <p>To download, verify and extract the standalone platform-tools on Linux:</p> - <pre>curl -O https://dl.google.com/android/repository/platform-tools_r30.0.5-linux.zip + <pre>curl -O https://dl.google.com/android/repository/platform-tools_r30.0.5-linux.zip echo 'd6d72d006c03bd55d49b6cef9f00295db02f0a31da10e121427e1f4cb43e7cb9 platform-tools_r30.0.5-linux.zip' | sha256sum -c unzip platform-tools_r30.0.5-linux.zip</pre> - <p>To download, verify and extract the standalone platform-tools on macOS:</p> + <p>To download, verify and extract the standalone platform-tools on macOS:</p> - <pre>curl -O https://dl.google.com/android/repository/eabcd8b4b7ab518c6af9c941af8494072f17ec4b.platform-tools_r30.0.5-darwin.zip + <pre>curl -O https://dl.google.com/android/repository/eabcd8b4b7ab518c6af9c941af8494072f17ec4b.platform-tools_r30.0.5-darwin.zip echo 'SHA256 (eabcd8b4b7ab518c6af9c941af8494072f17ec4b.platform-tools_r30.0.5-darwin.zip) = e5780bad71a53cf9d693e1053a0748f49e4a67cc1f71d16a94ab4c943af3345f' | shasum -c tar xvf eabcd8b4b7ab518c6af9c941af8494072f17ec4b.platform-tools_r30.0.5-darwin.zip</pre> - <p>To download, verify and extract the standalone platform-tools on Windows:</p> + <p>To download, verify and extract the standalone platform-tools on Windows:</p> - <pre>curl.exe -O https://dl.google.com/android/repository/platform-tools_r30.0.5-windows.zip + <pre>curl.exe -O https://dl.google.com/android/repository/platform-tools_r30.0.5-windows.zip (Get-FileHash platform-tools_r30.0.5-windows.zip).hash -eq "549ba2bdc31f335eb8a504f005f77606a479cc216d6b64a3e8b64c780003661f" tar xvf platform-tools_r30.0.5-windows.zip</pre> - <p>Next, add the tools to your <code>PATH</code> in the current shell so they can be - used without referencing them by file path, enabling usage by the flashing script.</p> + <p>Next, add the tools to your <code>PATH</code> in the current shell so they can be + used without referencing them by file path, enabling usage by the flashing script.</p> - <p>On Linux and macOS:</p> + <p>On Linux and macOS:</p> - <pre>export PATH="$PWD/platform-tools:$PATH"</pre> + <pre>export PATH="$PWD/platform-tools:$PATH"</pre> - <p>On Windows:</p> + <p>On Windows:</p> - <pre>$env:Path = "$pwd\platform-tools;$env:Path"</pre> + <pre>$env:Path = "$pwd\platform-tools;$env:Path"</pre> - <p>This only changes <code>PATH</code> for the current shell and will need - to be done again if you open a new terminal.</p> - </section> + <p>This only changes <code>PATH</code> for the current shell and will need + to be done again if you open a new terminal.</p> + </section> - <section id="checking-fastboot-version"> - <h4><a href="#checking-fastboot-version">Checking fastboot version</a></h4> + <section id="checking-fastboot-version"> + <h3><a href="#checking-fastboot-version">Checking fastboot version</a></h3> - <p>Check the output of <code>fastboot --version</code> before continuing.</p> + <p>Check the output of <code>fastboot --version</code> before continuing.</p> - <p>Example of the output after following the instructions above for the - standalone platform-tools:</p> + <p>Example of the output after following the instructions above for the + standalone platform-tools:</p> - <pre>fastboot version 30.0.5-6877874 + <pre>fastboot version 30.0.5-6877874 Installed as /home/username/platform-tools/fastboot</pre> - </section> </section> </section> - <section id="enabling-oem-unlocking"> - <h2><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></h2> - - <p>OEM unlocking needs to be enabled from within the operating system.</p> - - <p>Enable the developer options menu by going to Settings ➔ About phone and - pressing on the build number menu entry until developer mode is enabled.</p> - - <p>Next, go to Settings ➔ System ➔ Advanced ➔ Developer options and toggle on the - 'Enable OEM unlocking' setting. This requires internet access on devices with Google - Play services as part of Factory Reset Protection (FRP) for anti-theft protection.</p> - </section> - <section id="fastboot-as-non-root"> <h2><a href="#fastboot-as-non-root">Fastboot as non-root</a></h2> |
