imobiledevice-net is a library which allows you to interact with iOS devices on Windows, macOS and Linux using .NET languages (such as C# or Visual Basic). It is based on the libimobiledevice library.
imobiledevice-net is compatible with recent versions of .NET Framework and .NET Core.
You can install imobiledevice-net as a NuGet package
PM> Install-Package imobiledevice-net
We've done some work to make sure imobiledevice-net "just works":
ReadOnlyCollection<string>
object instead of IntPtr
objects when the native API returns an array of strings.IntPtr
objects. When you dispose of the safe handle (or you forget, and the framework does it for you), the safe memory is freed, too.iDevice
or Lockdown
. For each of these classes, we also expose an interface, allowing you to unit test your code.We use libclang
to parse the libimobiledevice C headers and generate the C# P/Invoke code.
See the API Documentation for more information on imobiledevice-net.
Before you use the library, you must call NativeLibraries.Load()
so that libimobiledevice
is loaded correctly:
NativeLibraries.Load();
The following snippit lists all devices which are currently connected to your PC:
ReadOnlyCollection<string> udids;
int count = 0;
var idevice = LibiMobileDevice.Instance.iDevice;
var lockdown = LibiMobileDevice.Instance.Lockdown;
var ret = idevice.idevice_get_device_list(out udids, ref count);
if (ret == iDeviceError.NoDevice)
{
// Not actually an error in our case
return;
}
ret.ThrowOnError();
// Get the device name
foreach (var udid in udids)
{
iDeviceHandle deviceHandle;
idevice.idevice_new(out deviceHandle, udid).ThrowOnError();
LockdownClientHandle lockdownHandle;
lockdown.lockdownd_client_new_with_handshake(deviceHandle, out lockdownHandle, "Quamotion").ThrowOnError();
string deviceName;
lockdown.lockdownd_get_device_name(lockdownHandle, out deviceName).ThrowOnError();
deviceHandle.Dispose();
lockdownHandle.Dispose();
}
We also provide binary distributions of libimobiledevice for Windows, macOS, and Ubuntu Linux.
For Windows and macOS, you can download a zip file with the libimobiledevice libraries and tools using the GitHub releases page.
For Ubuntu Linux, you can use our PPA (package archive) to install the latest libimobiledevice libraries and tools using apt-get
.
See the Quamotion PPA for more information.
The native binaries are all built from the various repositories (libplist, libusbmuxd, libimobiledevice, to name a few) in the libimobiledevice-win32 organization.
For macOS and Linux, you can use autotools to compile and install the native binaries from source. For Windows, you can use the Visual Studio solution and projects hosted in the libimobiledevice-vs repository.
This repository is maintained by Quamotion. Quamotion develops test software for iOS and Android applications, based on the WebDriver protocol.
Quamotion offers various technologies related to automating iOS devices using computers running Windows or Linux. This includes:
In certain cases, Quamotion also offers professional services - such as consulting, training and support - related to imobiledivice-net and libimobiledevice.
Contact us at info@quamotion.mobi for more information.