1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Creator documentation.
**
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** 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. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
**
****************************************************************************/
/*!
\contentspage {Qt Creator Manual}
\previouspage creator-developing-generic-linux.html
\page creator-developing-ios.html
\nextpage creator-developing-qnx.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 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 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 Make sure that you have Xcode and Qt for iOS installed.
\li Connect the device to the Mac computer with a USB cable.
\li Start Xcode to configure the device:
\list 1
\li Select \uicontrol Window > \uicontrol Organizer.
\li Select the \uicontrol + 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.
\endlist
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
\l{http://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/EnrollingADP/EnrollingADP.html}
{enroll in the iOS Developer Program}. The certificate is copied to the
device when you configure 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 \uicontrol Preferences >
\uicontrol iOS, and deselect the
\uicontrol {Ask about devices not in developer mode} check box.
\note If \QC does not detect the devices, the iOS plugin might not be
enabled. Select \uicontrol {Qt Creator} > \uicontrol {About Plugins} >
\uicontrol {Device Support} > \uicontrol iOS and restart \QC.
\li To specify build settings:
\list 1
\li Open a project for an application you want to develop for the
device.
\li Select \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol {Add Kit} to
add a kit for building and running applications on iOS.
\image qtcreator-ios-add-kit.png "Build & Run Settings"
\endlist
\li Select \uicontrol 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
device.
Your signing certificate is used to sign application packages for deployment
to the device.
\endlist
\note If you cannot deploy applications, because a provisioning profile is
missing, try refreshing the list of provisioning profiles in Xcode. Select
\uicontrol Xcode > \uicontrol Preferences > \uicontrol Accounts > \uicontrol {View Details}, and
then select the \uicontrol Refresh button.
\section1 Viewing Device Connection Status
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 \uicontrol Preferences >
\uicontrol Devices.
\image qtcreator-ios-device-configurations.png "Devices dialog"
If the current device state is \uicontrol Connected, (the traffic light icon is
orange), you need to configure the device using Xcode.
\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
\l{http://developer.apple.com/library/ios/documentation/IDEs/Conceptual/iOS_Simulator_Guide/Introduction/Introduction.html}
{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 in the run
settings for the project. Select \uicontrol Projects > \uicontrol Run, and then select
the device to simulate in the \uicontrol {Device type} field.
\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, enter the following command:
\c {xcode-select --version}
*/
|
