This is a library of utilities for dealing programmatically with iOS applications,
used namely for tools like Hyperloop
and Titanium SDK.
ioslib supports Xcode 6 and newer.
Installation
From NPM:
npm install ioslib
Examples
Detect all the connected iOS devices:
var ioslib = require('ioslib');ioslib.device.detect(function (err, devices) { if (err) { console.error(err); } else { console.log(devices); }});
Install an application on device
var deviceUDID = null; // string or null to pick first deviceioslib.device.install(deviceUDID, '/path/to/name.app', 'com.company.appname') .on('installed', function () { console.log('App successfully installed on device'); }) .on('appStarted', function () { console.log('App has started'); }) .on('log', function (msg) { console.log('[LOG] ' + msg); }) .on('appQuit',
Launch the iOS Simulator
ioslib.simulator.launch(null, function (err, simHandle) { console.log('Simulator launched'); ioslib.simulator.stop(simHandle, function () { console.log('Simulator stopped'); });});
Launch, install, and run an application on simulator
var simUDID = null; // string or null to pick a simulatorioslib.simulator.launch(simUDID, { appPath: '/path/to/name.app' }) .on('launched', function (msg) { console.log('Simulator has launched'); }) .on('appStarted', function (msg) { console.log('App has started'); }) .on('log', function (msg) { console.log('[LOG] ' + msg); }) .on('error',
Force stop an application running on simulator
ioslib.simulator.launch(simUDID, { appPath: '/path/to/name.app' }) .on('launched', function (simHandle) { console.log('Simulator launched'); ioslib.simulator.stop(simHandle).on('stopped', function () { console.log('Simulator stopped'); }); });
Find a valid device/cert/provisioning profile combination
ioslib.findValidDeviceCertProfileCombos({ appId: 'com.company.appname'}, function (err, results) { if (err) { console.error(err); } else { console.log(results); }});
Interested in contributing? There are several ways you can help contribute to this project.
New Features, Improvements, Bug Fixes, & Documentation
Source code contributions are always welcome! Before we can accept your pull request, you must sign a Contributor License Agreement (CLA). Please visit https://tidev.io/contribute for more information.
Donations
Please consider supporting this project by making a charitable donation. The money you donate goes to compensate the skilled engineeers and maintainers that keep this project going.
Code of Conduct
TiDev wants to provide a safe and welcoming community for everyone to participate. Please see our Code of Conduct that applies to all contributors.
Security
If you find a security related issue, please send an email to security@tidev.io instead of publicly creating a ticket.
Stay Connected
For the latest information, please find us on Twitter: Titanium SDK and TiDev.
Titanium is a registered trademark of TiDev Inc. All Titanium trademark and patent rights were transferred and assigned to TiDev Inc. on 4/7/2022. Please see the LEGAL information about using our trademarks, privacy policy, terms of usage and other legal information at https://tidev.io/legal.