Skip to content

Commit

Permalink
Merge pull request #43 from fadelkon/patch-2
Browse files Browse the repository at this point in the history
Improve dependency requirements at README.md
  • Loading branch information
rchatterjee authored May 11, 2022
2 parents 38c55d5 + 5a76f84 commit 6c027e8
Showing 1 changed file with 39 additions and 28 deletions.
67 changes: 39 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,41 +30,52 @@ requirements.txt` in the base directory of this repository to get the required
Python modules.

### Operating system dependencies

#### Generic
* [adb](https://developer.android.com/studio/releases/platform-tools.html)
* expect
* libimobiledevice
* ideviceinstaller
* ifuse

#### macOS
On macOS you can quickly install project dependencies with Homebrew by running `brew bundle`.

- Install ADB for your operating system (via
https://developer.android.com/studio/releases/platform-tools.html). On
macOS, try `brew install --cask android-platform-tools`. On Debian-based
systems, try `sudo apt install adb`.
**Windows via WSL2 only:** Installing adb is not so straightforward in WSL2, and
You can also fulfill the requirements by doing:
```
brew install --cask android-platform-tools
```
```
brew install expect libimobiledevice ideviceinstaller
```
```
brew install autoconf
brew install automake
brew install libtool
brew install --cask macfuse
cd ifuse
./autogen.sh
make
sudo make install
```

#### Debian family

```
sudo apt install adb expect libimobiledevice-utils ideviceinstaller ifuse
```

#### Windows Subsystem Linux (v2)

For Debian or Debian-derivatives, please follow first the [steps for debian](#debian-family)

Installing **adb** is not so straightforward in WSL2, and
it won't work straightaway. You have to ensure having the *same* version of adb
*both* in WSL2 and in normal Windows (with `adb version`), then you will need to
start the adb process first in Windows, then in WSL2 (with for example `adb
devices`).

- Install `expect`. On macOS, run `brew install expect`. On Debian-based
systems, run `sudo apt install expect`.

- Install `libimobiledevice`. On macOS, run `brew install libimobiledevice`. On Debian-based
systems, run `sudo apt install libimobiledevice-utils`.

- Install `ideviceinstaller`. On macOS, run `brew install ideviceinstaller`.On Debian-based
systems, run `sudo apt install ideviceinstaller`.

- Install `ifuse` (via https://github.com/libimobiledevice/ifuse). On macOS, run:
`brew install autoconf`
`brew install automake`
`brew install libtool`
`brew install --cask macfuse`
`cd ifuse`
`./autogen.sh`
`make`
`sudo make install`
On Debian-based systems, run `sudo apt install ifuse`.


- **Linux/WSL2 only:** If you are running Linux or WSL2, install
[patchelf](https://nixos.org/patchelf.html) (on Debian-based systems, this
You also need to install [patchelf](https://nixos.org/patchelf.html) (on Debian-based systems, this
can be done like `sudo apt install patchelf`) and then run
`./scripts/patch_ios_dylibs.sh`. You may need to re-run this script if you are
collaborating and other ISDi users overwrite the iOS binaries with their own
Expand Down

0 comments on commit 6c027e8

Please sign in to comment.