Project

General

Profile

ToolsInstallation » History » Version 18

Jorge Gomez, 12/16/2020 11:28 AM

1 5 Paul Kocialkowski
h1. Tools installation
2 1 Paul Kocialkowski
3
This page explains how to install the various tools used with Replicant. It is assumed that you are running a GNU/Linux operating system.
4
5 15 Denis 'GNUtoo' Carikli
Note: you may need to run the tools as root if your current user doesn't have USB access privileges.
6 1 Paul Kocialkowski
7 15 Denis 'GNUtoo' Carikli
h2. From distributions
8 1 Paul Kocialkowski
9 16 Denis 'GNUtoo' Carikli
Many distributions already have packages for the most common tools. 
10
11
Using the tools from your distribution have many advantages:
12
* It's often easier to install
13
* They are often more up to date and more tested than the ones shipped by Replicant
14 1 Paul Kocialkowski
15 15 Denis 'GNUtoo' Carikli
h3. Parabola
16 1 Paul Kocialkowski
17
<pre>
18 15 Denis 'GNUtoo' Carikli
sudo pacman -S android-tools android-udev heimdall
19 1 Paul Kocialkowski
</pre>
20
21 17 Denis 'GNUtoo' Carikli
h3. Debian and Ubuntu
22 1 Paul Kocialkowski
23
<pre>
24 15 Denis 'GNUtoo' Carikli
sudo apt-get install android-tools-adb android-tools-fastboot heimdall-flash
25 11 Wolfgang Wiedmeyer
</pre>
26 2 Paul Kocialkowski
27 18 Jorge Gomez
h3. Guix
28
29
<pre>
30
guix install adb heimdall fastboot mkbootimg
31
</pre>
32
33 15 Denis 'GNUtoo' Carikli
h2. Installing it from Replicant
34 13 Denis 'GNUtoo' Carikli
35 15 Denis 'GNUtoo' Carikli
Some of the tools are also built with the Replicant releases. 
36 8 Denis 'GNUtoo' Carikli
37 15 Denis 'GNUtoo' Carikli
1. Download the @adb@, @fastboot@, @heimdall@, @mkbootimg@ and @unpackbootimg@ tools, with their corresponding @.asc@ signatures files from [[ReplicantImages]] for the latest image.
38 13 Denis 'GNUtoo' Carikli
2. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] of the latest version to your GPG keyring
39 15 Denis 'GNUtoo' Carikli
3. Check the signature of the each tools:
40 12 Wolfgang Wiedmeyer
<pre>
41 15 Denis 'GNUtoo' Carikli
gpg --armor --verify path/to/adb.asc path/to/adb
42 11 Wolfgang Wiedmeyer
gpg --armor --verify path/to/fastboot.asc path/to/fastboot
43
gpg --armor --verify path/to/heimdall.asc path/to/heimdall
44 15 Denis 'GNUtoo' Carikli
gpg --armor --verify path/to/mkbootimg.asc path/to/mkbootimg
45
gpg --armor --verify path/to/unpackbootimg.asc path/to/unpackbootimg
46 11 Wolfgang Wiedmeyer
</pre>
47
4. Make sure the check succeeds, *do not run the binary if it doesn't*!
48
49 15 Denis 'GNUtoo' Carikli
As the tools are built as a 32 bit binary, you will need to install compatibility libraries for 32 bits executables if your computer is running on a 64 bit architecture.
50
5. Make sure tools can be executed:
51 11 Wolfgang Wiedmeyer
<pre>
52 15 Denis 'GNUtoo' Carikli
chmod a+x adb
53
chmod a+x fastboot
54 11 Wolfgang Wiedmeyer
chmod a+x heimdall
55 15 Denis 'GNUtoo' Carikli
chmod a+x mkbootimg
56
chmod a+x unpackbootimg
57 11 Wolfgang Wiedmeyer
</pre>
58
59 15 Denis 'GNUtoo' Carikli
6. You can now use the tools. As they weren't installed in the system path, you need to go in the directory they were downloaded in and add a './' in front of the commands.
60
For instance if you want to obtain a list of commands accepted by adb you can use the following command:
61 11 Wolfgang Wiedmeyer
<pre>
62 15 Denis 'GNUtoo' Carikli
./adb --help
63 1 Paul Kocialkowski
</pre>