creator-ios-dev.qdoc 5.63 KB
Newer Older
Leena Miettinen's avatar
Leena Miettinen committed
1 2
/****************************************************************************
**
3
** Copyright (c) 2014 Digia Plc and/or its subsidiary(-ies).
Leena Miettinen's avatar
Leena Miettinen committed
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
** Contact: http://www.qt-project.org/legal
**
** 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.
**
**
****************************************************************************/

    /*!

21
    \contentspage {Qt Creator Manual}
Leena Miettinen's avatar
Leena Miettinen committed
22 23
    \previouspage creator-developing-generic-linux.html
    \page creator-developing-ios.html
24
    \nextpage creator-developing-qnx.html
Leena Miettinen's avatar
Leena Miettinen committed
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

    \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 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

Leena Miettinen's avatar
Leena Miettinen committed
50 51 52
        \li Make sure that you have Xcode and Qt for iOS installed.

        \li Connect the device to the Mac computer with a USB cable.
Leena Miettinen's avatar
Leena Miettinen committed
53 54 55 56 57

        \li Start Xcode to configure the device:

            \list 1

Christian Stenger's avatar
Christian Stenger committed
58
                \li Select \gui Window > \gui Organizer.
Leena Miettinen's avatar
Leena Miettinen committed
59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74

                \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.

            \endlist

Leena Miettinen's avatar
Leena Miettinen committed
75 76 77 78 79 80 81
        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.

Leena Miettinen's avatar
Leena Miettinen committed
82 83 84 85 86 87
        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.

88 89 90
        \note If \QC does not detect the devices, the iOS plugin might not be
        enabled. Select \gui {Qt Creator} > \gui {About Plugins} >
        \gui {Device Support} > \gui iOS and restart \QC.
Leena Miettinen's avatar
Leena Miettinen committed
91

Leena Miettinen's avatar
Leena Miettinen committed
92 93 94 95 96 97 98 99 100 101
        \li To specify build settings:

        \list 1

            \li Open a project for an application you want to develop for the
                device.

            \li Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
                add a kit for building and running applications on iOS.

Leena Miettinen's avatar
Leena Miettinen committed
102 103
                \image qtcreator-ios-add-kit.png "Build & Run Settings"

Leena Miettinen's avatar
Leena Miettinen committed
104 105 106 107 108 109 110 111 112 113 114 115 116 117
        \endlist

        \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
    device.

    Your signing certificate is used to sign application packages for deployment
    to the device.

    \endlist

118 119 120 121 122
    \note If you cannot deploy applications, because a provisioning profile is
    missing, try refreshing the list of provisioning profiles in Xcode. Select
    \gui Xcode > \gui Preferences > \gui Accounts > \gui {View Details}, and
    then select the \gui Refresh button.

Leena Miettinen's avatar
Leena Miettinen committed
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
    \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 \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.

    \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 from within iOS
    Simulator.

    \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}

Leena Miettinen's avatar
Leena Miettinen committed
154
*/