diff --git a/doc/images/qtcreator-ios-device-configurations.png b/doc/images/qtcreator-ios-device-configurations.png new file mode 100644 index 0000000000000000000000000000000000000000..da6b6a4f01d682564c17efa873f4121956fb04f1 Binary files /dev/null and b/doc/images/qtcreator-ios-device-configurations.png differ diff --git a/doc/src/ios/creator-ios-dev.qdoc b/doc/src/ios/creator-ios-dev.qdoc new file mode 100644 index 0000000000000000000000000000000000000000..4e9cd2f75cf1b1befb01e3fb7d2384222a11e902 --- /dev/null +++ b/doc/src/ios/creator-ios-dev.qdoc @@ -0,0 +1,145 @@ +/**************************************************************************** +** +** Copyright (c) 2013 Digia Plc and/or its subsidiary(-ies). +** 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. +** +** +****************************************************************************/ + + /*! + + \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 + \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. + + \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. + + 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. + + \endlist + + 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 + device. + + \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. + + \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 + +*/ diff --git a/doc/src/linux-mobile/linuxdev.qdoc b/doc/src/linux-mobile/linuxdev.qdoc index f4accdcf0286d518aae090930c16103f7d1944ce..4c3559cbb4b6df60742e3c45c2dcb8c2fba041bc 100644 --- a/doc/src/linux-mobile/linuxdev.qdoc +++ b/doc/src/linux-mobile/linuxdev.qdoc @@ -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 diff --git a/doc/src/linux-mobile/maemodev.qdoc b/doc/src/linux-mobile/maemodev.qdoc index c6b8b887f9b6cd3c850855131ff71a2162cc2c42..9c4878c0fd60e89556fcb1f1d965f8a0f3b51309 100644 --- a/doc/src/linux-mobile/maemodev.qdoc +++ b/doc/src/linux-mobile/maemodev.qdoc @@ -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 diff --git a/doc/src/overview/creator-mobile-targets.qdoc b/doc/src/overview/creator-mobile-targets.qdoc index 3a5fdbeab20e984291033b0370677a781d2f7e0d..c1f2197dd4f589c87f634a7645bf359f3354327e 100644 --- a/doc/src/overview/creator-mobile-targets.qdoc +++ b/doc/src/overview/creator-mobile-targets.qdoc @@ -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 diff --git a/doc/src/qtcreator.qdoc b/doc/src/qtcreator.qdoc index b8d8ddc9d6271a5ed1a06ee398da2cd9e0a6787d..319d3f5172444a685ef15265ef02da3aa1af7792 100644 --- a/doc/src/qtcreator.qdoc +++ b/doc/src/qtcreator.qdoc @@ -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}