Commit 931f08ce authored by Leena Miettinen's avatar Leena Miettinen
Browse files

Doc: connecting iOS devices

Describe Qt Creator support for developing for iOS.

Change-Id: I5d993e343f4f00a09b4c29de6402a338a8011af4
Reviewed-by: default avatarFawzi Mohamed <>
Reviewed-by: default avatarGeir Vattekar <>
parent 68609ca8
** Copyright (c) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact:
** This file is part of Qt Creator
** GNU Free Documentation License
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
\contentspage index.html
\previouspage creator-developing-generic-linux.html
\page creator-developing-ios.html
\nextpage creator-developing-maemo.html
\title Connecting iOS Devices
You can connect iOS devices to a Mac computer with a USB cable to
build and run applications on them from \QC.
To be able to use \QC on Mac OS X, you must install Xcode, and therefore,
you already have the tool chain for building applications for iOS. \QC
automatically detects the tool chain and creates the necessary
\l{glossary-buildandrun-kit}{kits} for building and running applications on
configured iOS devices.
You only need Qt libraries that are built for iOS. You can install them as
part of Qt 5.2, or later.
\section1 Creating Device Connections
When you connect an iOS device to a Mac computer with USB, \QC
automatically detects the device if you have configured it by using Xcode.
To view information about the connected device, select \gui Preferences >
\gui Devices.
\image qtcreator-ios-device-configurations.png "Devices dialog"
If the current device state is \gui Connected, (the traffic light icon is
orange), you need to configure the device using Xcode.
The connections between \QC and an iOS device are protected by using an
iOS Developer Program certificate that you receive from Apple for a charge
when you
{enroll in the iOS Developer Program}. The certificate is copied to the
device when you configure the device.
\section1 Testing on iOS Simulator
If you do not have an iOS device or you do not want to create an account,
you can test applications on
{iOS Simulator}, which is installed as part of Xcode. Each Xcode version
simulates a predefined set of hardware devices and software versions. You
can change the simulated hardware and software version from within iOS
By default, \QC uses the Xcode version set as current on the Mac computer.
To check the version, enter the following command:
\c {xcode-select --print-path}
To change the version, select \gui Preferences > \gui iOS, and select
another Xcode version in the \gui {Xcode path} field. This setting overrides
the version set by entering the \c {xcode-select --version} command.
\section1 Configuring Devices
The process of configuring devices and the UI varies slightly depending on
the Xcode version that you use. The instructions in this section describe
the process and UI when using Xcode version 4.6.3.
To configure connections between \QC and an iOS device:
\list 1
\li Connect the device to a Mac computer with a USB cable.
\li Start Xcode to configure the device:
\list 1
\li Select \gui Windows > \gui Organizer.
\li Select the \gui + button to add the connected device.
\li Select the device you want to add in the list of devices.
\li If you do not have an Apple developer account, you can now
create one, for a charge.
\li When your account is ready, you can add the device. Your
Apple developer certificate is copied to the device.
\li The first time you connect the device, you are asked to
enable developer mode on the device.
The next time you connect the device to the Mac computer, \QC
detects it automatically. To disable automatic connections to a
device that you do not use for development, select \gui Preferences >
\gui iOS, and deselect the
\gui {Ask about devices not in developer mode} check box.
\li To specify build settings:
\list 1
\li Open a project for an application you want to develop for the
\li Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
add a kit for building and running applications on iOS.
\li Check that the \gui {iOS build} field contains the build
commands for an Xcode build. To add an Xcode build step, select
\gui {Add Build Step} > \gui xcodebuild.
\li Select \gui Run to specify run settings.
Usually, you can use the default settings.
When you run the project, \QC uses Xcode to deploy the application to the
Your signing certificate is used to sign application packages for deployment
to the device.
......@@ -21,7 +21,7 @@
\contentspage index.html
\previouspage creator-developing-bb10.html
\page creator-developing-generic-linux.html
\nextpage creator-developing-maemo.html
\nextpage creator-developing-ios.html
\title Connecting Embedded Linux Devices
......@@ -19,7 +19,7 @@
\contentspage index.html
\previouspage creator-developing-generic-linux.html
\previouspage creator-developing-ios.html
\page creator-developing-maemo.html
\nextpage creator-developing-meego.html
......@@ -65,6 +65,12 @@
Linux devices (with no MADDE support) installed on the development
PC, you can add it and the device to \QC.
\li \l{Connecting iOS Devices}
You use the tools delivered with Xcode to connect devices to \QC.
\QC detects the tools and configured devices automatically and uses
the tools to build, deploy, and run applications.
\li \l{Connecting Maemo Devices}
Maemo 5 (Fremantle) is a Linux-based software platform developed by
......@@ -245,6 +245,7 @@
\li \l{Connecting Android Devices}
\li \l{Connecting BlackBerry 10 Devices}
\li \l{Connecting Embedded Linux Devices}
\li \l{Connecting iOS Devices}
\li \l{Connecting Maemo Devices}
\li \l{Connecting MeeGo Harmattan Devices}
\li \l{Connecting QNX Devices}
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment