Documentation Archive


Xcode Overview

Running on a Device

Xcode will launch an OS X app on your development Mac.

image: ../art/AdventureLaunchedMac.pdf

To run your iOS and watchOS apps on a device (an iPad, iPhone, iPod touch, or Apple Watch) during development, four things are required:

  • The device is connected to your Mac.

  • You are a member of an Apple developer program.

  • You have a valid signing identity for the developer program.

  • The device is provisioned for development use by that developer program.

Xcode guides you through any missing parts of these requirements and can usually do the work of obtaining a signing identity and device provisioning profile.

To run your iOS app on a device (an iPad, iPhone, or iPod touch) during development, the device must be connected to your Mac, and the device must be provisioned for development by Apple. If your Mac app uses certain Apple technologies—such as iCloud, Game Center, and In-App Purchase—your Mac must be provisioned.

Apple implements an underlying security model to protect user data and to protect your app from being modified and distributed without your knowledge. Throughout the development process, you create assets and enter information that Apple uses to verify the identify of you, your devices, and your apps. These assets include provisioning profiles, which identify your development devices.

To obtain a provisioning profile for a device, you need an Apple Developer Program membership and associated signing identity. For detailed information on doing this, see App Distribution Quick Start.

Choosing Your Device for the Run Destination

When you plug the device into your Mac, the device’s name and the iOS release it is running appear as a destination in the Scheme menu. Choose your device as the destination, and then click the Run button to build and run your app on the device.