forked from qt-creator/qt-creator
b67c3874b7
Change-Id: I2c7a9bce7ee92c59f91fa41f732f3c90a9e100e3 Reviewed-on: http://codereview.qt-project.org/4886 Reviewed-by: Christian Kandeler <christian.kandeler@nokia.com>
135 lines
4.8 KiB
Plaintext
135 lines
4.8 KiB
Plaintext
/****************************************************************************
|
|
**
|
|
** This file is part of Qt Creator
|
|
**
|
|
** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies).
|
|
**
|
|
** Contact: Nokia Corporation (info@qt.nokia.com)
|
|
**
|
|
**
|
|
** 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.
|
|
**
|
|
** If you have questions regarding the use of this file, please contact
|
|
** Nokia at info@qt.nokia.com.
|
|
**
|
|
****************************************************************************/
|
|
|
|
/*!
|
|
|
|
\contentspage index.html
|
|
\previouspage creator-developing-meego.html
|
|
\page creator-developing-generic-linux.html
|
|
\nextpage creator-developing-maemo.html
|
|
|
|
\title Connecting Generic Linux Devices
|
|
|
|
You can connect generic Linux devices to the development PC to build, run,
|
|
debug, and analyze applications on them from Qt Creator.
|
|
|
|
If you have the tool chain for building applications for generic Linux
|
|
devices (with no MADDE support) installed on the development PC, you can add
|
|
it to Qt Creator.
|
|
|
|
To be able to run and debug applications on generic Linux devices, you must
|
|
create device configurations and select them in the Qt Creator run
|
|
settings.
|
|
|
|
You use a wizard to create the connections. You can edit the settings later
|
|
in \gui {Tools > Options... > Linux Devices > Device Configurations}.
|
|
|
|
\image qtcreator-linux-device-configurations.png "Device Configurations dialog"
|
|
|
|
You can protect the connections between Qt Creator and a device by using
|
|
either a password or an SSH key. If you do not have an SSH key, you can
|
|
create it in Qt Creator. For more information, see \l {Generating SSH Keys}.
|
|
|
|
To configure connections between Qt Creator and generic Linux devices:
|
|
|
|
\list 1
|
|
|
|
\o Make sure that your device can be reached via an IP address.
|
|
|
|
\o Select \gui {Tools > Options... > Qt4 > Add} to add the Qt version
|
|
for the generic Linux.
|
|
|
|
\o Select \gui {Tools > Options... > Tool Chains > Add} to add the tool
|
|
chain for building the applications.
|
|
|
|
\o To deploy applications and run them remotely on devices, specify
|
|
parameters for accessing the devices:
|
|
|
|
\list 1
|
|
|
|
\o Select \gui {Tools > Options... > Linux Devices > Device
|
|
Configurations > Add > Generic Linux Device}.
|
|
|
|
\image qtcreator-screenshot-devconf-linux.png "Connection Data wizard"
|
|
|
|
\o In the \gui {The name to identify this configuration} field,
|
|
enter a name for the connection.
|
|
|
|
\o In the \gui {The device's host name or IP address} field,
|
|
enter the host name or IP address of the device.
|
|
|
|
\o In the \gui {The user name to log into the device} field,
|
|
enter the user name to log into the device and run the
|
|
application as.
|
|
|
|
\o In the \gui {The authentication type} field, select whether
|
|
to use \gui Password or \gui Key authentication, and enter
|
|
the user's password or the file that contains the user's
|
|
private key.
|
|
|
|
\o Click \gui {Next} to create the connection.
|
|
|
|
\endlist
|
|
|
|
\o To specify build settings:
|
|
|
|
\list 1
|
|
|
|
\o Open a project for an application you want to develop for the
|
|
device.
|
|
|
|
\o Select \gui {Projects > Desktop > Build}.
|
|
|
|
\o Select the Qt version and tool chain for the generic Linux
|
|
device.
|
|
|
|
\endlist
|
|
|
|
\o To specify run settings:
|
|
|
|
\list 1
|
|
|
|
\o Select \gui {Run > Add > Build Tarball and Deploy to Linux Host}
|
|
to add a new deploy configuration.
|
|
|
|
\image qtcreator-run-settings-linux-devices.png "Run settings for generic Linux devices"
|
|
|
|
\o In the \gui {Device configuration} field, select the device
|
|
connection.
|
|
|
|
\endlist
|
|
|
|
When you run the project, Qt Creator creates an installation package in
|
|
the build directory. The name of the directory is displayed in the
|
|
\gui {Create tarball} step.
|
|
|
|
The \gui {Deploy tarball via SFTP upload using device} step specifies
|
|
that Qt Creator uploads the tarball to the device and extracts it.
|
|
You can add custom deploy steps and remove the default step if
|
|
it is incompatible with your steps.
|
|
To only create a tarball and not copy the files to the device,
|
|
remove all deploy steps.
|
|
|
|
\endlist
|
|
|
|
*/
|
|
|