2021-03-09

使用libimobiledevice + ifuse提取iOS沙盒文件

简介

libimobiledevice：一个开源包，可以让Linux支持连接iPhone/iPod Touch等iOS设备。

Git仓库:https://github.com/libimobiledevice/libimobiledevice.git

ifuse: 也是一个开源包，可以用来访问iDevice的工具

Git仓库:https://github.com/libimobiledevice/ifuse.git

我们可以利用libimobiledevice与ifuse进行shell封装，辅助实现自动化的测试过程。

这里我们用来提取iOS设备上APP沙盒中的日志文件

快速直接安装libmobiledevice的方法

MacOS上安装libimobiledevice

brew update

brew install libimobiledevice

#libimobiledevice中并不包含ipa的安装命令，所以还需要安装

brew install ideviceinstaller

Ubuntu下安装libimobiledevice

sudo add-apt-repository ppa:pmcenery/ppa

sudo apt-get update

apt-getinstall libimobiledevice-utils

sudo apt-getinstall ideviceinstaller

常用功能

1. 获取设备已安装app的bundleID

ideviceinstaller -l

演示:

Jackeys-MacBook-Pro:/ jackey$ ideviceinstaller -l

Total: 13 apps

com.zhouxi.xiaoailiteios - 小米同学20com.apple.test.WebDriverAgentRunner-Runner - WebDriverAgentRunner-Runner1com.apple.store.Jolly - Apple Store5.0.0.0302com.apple.clips - 可立拍4141.1.91com.apple.mobilegarageband - 库乐队4878.17com.apple.Keynote - Keynote 讲演5625com.apple.Numbers - Numbers 表格5625com.apple.Pages - Pages 文稿5625com.apple.iMovie - iMovie3709.9.72com.apple.itunesu - iTunes U2360com.sogou.sogouinput - 搜狗输入法148198com.tencent.xin - 微信6.7.4.44com.ss.iphone.ugc.AwemeInhouse - 抖音短视频内测43006Jackeys-MacBook-Pro:/ jackey$

2. 安装ipa包，卸载应用

//命令安装一个ipa文件到手机上，如果是企业签名的，非越狱机器也可以直接安装了。ideviceinstaller -i xxx.ipa//命令卸载应用，需要知道此应用的bundleIDideviceinstaller -U [bundleID]

卸载演示:

Jackeys-MacBook-Pro:/ jackey$ ideviceinstaller -U com.zhouxi.xiaoailiteios

Uninstalling 'com.zhouxi.xiaoailiteios'- RemovingApplication (50%)

- GeneratingApplicationMap (90%)

- Complete

Jackeys-MacBook-Pro:/ jackey$

安装演示：

Jackeys-MacBook-Pro:Code jackey$ ideviceinstaller -i QQ音乐\8.9.7.ipa

Copying 'QQ音乐 8.9.7.ipa' to device... DONE.

Installing 'com.tencent.QQMusic'- CreatingStagingDirectory (5%)

- ExtractingPackage (15%)

- InspectingPackage (20%)

- TakingInstallLock (20%)

- PreflightingApplication (30%)

- VerifyingApplication (40%)

- CreatingContainer (50%)

- InstallingApplication (60%)

- PostflightingApplication (70%)

- SandboxingApplication (80%)

- GeneratingApplicationMap (90%)

- Complete

Jackeys-MacBook-Pro:Code jackey$

这里补充一个: ipa我们可以通过itunes来进行下载， 下载完后可以在iTunnes偏好设置中看到存放目录

如果连接了多部手机需要分别安装时，请使用UDID指定：ideviceinstaller -u udid -i *.ipa

3. 查看系统日志

idevicesyslog

4. 查看当前已连接的设备的UUID

idevice_id --list

5. 截图

idevicescreenshot

6. 查看设备信息

ideviceinfo

7. 获取设备时间

idevicedate

8. 设置代理

iproxy

　usage: iproxy LOCAL_TCP_PORT DEVICE_TCP_PORT [UDID]

9. 获取设备名称

idevicename

10. 查看和操作设备的描述文件

ideviceprovision list

11. 挂载DeveloperDiskImage，用于调试(这个在我的机器上面不能用， 应该是缺少什么东西了)

ideviceimagemounter

12. 调试程序

idevicedebug

如果在运行上面指令出现以下错误:

"Could not connect to lockdownd. Exiting."

使用以下方式重新安装

brew uninstall ideviceinstaller

brew uninstall libimobiledevice

brew install --HEAD libimobiledevice

brew link --overwrite libimobiledevice

brew install --HEADideviceinstaller

brew link

--overwrite ideviceinstaller

重新安装过程中如果出现以下错误:

A recent change to libimobiledevice bumped the constraint on libusbmuxd to >= version1.1.0. The current usbmuxd homebrew packageisversion1.0.10.

As a result, homebrew --HEAD installs of libimobiledevice no longer build without a --HEAD install of usbmuxd.

使用以下指令升级usbmuxd：

brew update

brew uninstall --ignore-dependencies usbmuxd

brew install --HEAD usbmuxd

brew link --overwrite usbmuxd

升级后接着安装libimobiledevice

挂载文件系统工具：ifuse

安装方式:

brew cask install osxfuse

brew install ifuse

或者通过官网安装 osxfuse

https://osxfuse.github.io

然后使用上面指令安装ifuse

1. 安装好后使用ifuse -h会打印详细使用说明

Usage: ifuse MOUNTPOINT [OPTIONS]

Mount directories of an iOS device locally using fuse.

  -o opt,[opt...]    mount options

  -u, --udid UDID    mount specific device by its40-digit device UDID

  -h, --help        print usage information

  -V, --version        print version

  -d, --debug        enable libimobiledevice communication debugging

  --documents APPID    mount'Documents' folder of app identified by APPID

  --container APPID    mount sandbox root of an app identified by APPID

  --root        mount root file system (jailbroken device required)

Example:

  $ ifuse /media/iPhone --root

  This mounts the root filesystem of the first attached device on

  thiscomputerinthe directory /media/iPhone.

Jackeys-MacBook-Pro:Code jackey$

2. 挂在媒体文件目录:

//注意，此处的挂载点必须要真实存在，需要预先创建好目录，否则挂载失败ifuse [挂载点]

演示: 

1sudo mkdir /myapp

Jackeys-MacBook-Pro:/ jackey$ sudo ifuse myapp/Password:

Jackeys-MacBook-Pro:/ jackey$

卸载挂载点

fusermount -u [挂载点]

这个指令在我的电脑上不行， 我改用的sudo umount /myapp

3. 挂载某个应用的documents目录

ifuse --documents [要挂载的应用的bundleID] [挂载点]//注意，iOS 8.3之后要求应用的UIFileSharingEnabled权限要开启，否则可能没有权限访问，会有如下的错误提示ERROR: InstallationLookupFailed

The App 'com.wsgh.test'iseither not present on the device, or the'UIFileSharingEnabled'keyisnotsetinits Info.plist. Starting with iOS8.3thiskeyismandatory to allow access to an app's Documents folder.

演示:

Jackeys-MacBook-Pro:/ jackey$ sudo ifuse --documents com.zhouxi.xiaoailiteios /myapp

Password:

ERROR: InstallationLookupFailed

Jackeys-MacBook-Pro:/ jackey$

报这个错是因为我们app没有开启文件共享，需要在app的info.plist添加一下字段

我们再试试

Jackeys-MacBook-Pro:/ jackey$ sudo ifuse --documents com.zhouxi.xiaoailiteios /myapp

Password:

mount_osxfuse: mount point /myappisitself on a OSXFUSE volume

这里报错的原因是我们不能把文件挂在到根目录, 我们先删除之前的挂载

重新挂在到Document目录下我们自己的文件夹中

ifuse --documents com.zhouxi.xiaoailiteios /Users/jackey/Documents/Xiaomi/myapp

OK, 这次没有出错， 打开Finder进入所在目录发现myapp文件夹没有了， 但增加了一个OSXFUSE Volume的目录

打开里面就是我们的Documents目录

使用umount可卸载

umount /Users/jackey/Documents/Xiaomi/myapp

4. 挂在某应用的整个沙盒目录

ifuse --container [要挂载的应用的bundleID] [挂载点]

演示:

ifuse --container com.zhouxi.xiaoailiteios /Users/jackey/Documents/Xiaomi/myapp/xiaoailite

打开finder可以看到整个沙盒目录都挂在上来了

如果需要自动提取沙盒日志，这里我们可以写脚本使用挂在的目录去获取里面的内容

Jackeys-MacBook-Pro:xiaoailite jackey$ pwd/Users/jackey/Documents/Xiaomi/myapp/xiaoailite

Jackeys-MacBook-Pro:xiaoailite jackey$ ls

Documents    Library        SystemData    tmp

Jackeys-MacBook-Pro:xiaoailite jackey$