Hide table of contents
Xcode Help
Welcome
Get started in Xcode
Create a project
Run your app
Create the user interface
Write code
Debug code
Use source control
Test your app
Distribute your app
Xcode basics
Build and run apps
Test, profile, and analyze apps
Configure the main window
About the main window
Show or hide main window areas
Change editor views
Use tabs in the main window
Manage files and navigate symbols
Locate and manage files
Add files and folders
Navigate the symbols
Jump to files and symbols while editing
Open a file containing a symbol
Open a file in the hex editor
Use workspaces for related projects
Reference another project
Choose where to display a file
Search documentation
Rename a project or an app
Edit property lists
Migrate to Swift 4 @objc inference
Customize Xcode
Manage general settings
Add accounts, servers, and repositories
Add an Apple ID
Configure actions for events
Configure how files are displayed
Manage fonts and colors
Configure code editing and indentation
Customize keyboard shortcuts
Customize the Touch Bar controls
Configure source control
Customize text macros
Customize the new file header
Manage simulators and toolchains
Install simulator runtimes
Switch toolchains
Verify, reveal, and delete toolchains
Specify locations of project files
Choose the build system
Create playgrounds
Create, edit, and execute
Add auxiliary code
Add resources
Use rich comments
Add, move, and rename pages
Copy pages between playgrounds
View results of a statement
Add a live view
Add a literal to a playground
Run your app on a device
Signing workflow
Run on a connected device
Pair a wireless device
Run on a wireless device
Troubleshoot a wireless device
View signing reports
Edit source code
Fix issues while writing code
Use code completion
Match braces, parentheses, and brackets
Edit all occurrences of a symbol
Edit using multiple cursors
Add missing protocol requirements
Add code with the Action menu
Extract code to functions and variables
Create and use snippets
Find and replace content
Add code annotations to the jump bar
Fold or collapse your code
Refactor your code
View symbol declarations and reference
Analyze your code
Switch syntax coloring styles
Lay out user interfaces
Interface Builder workflow
Add objects and media
Add user interface objects
Add media objects
Add custom objects
Render custom views
Debug custom views
Switch to alignment rectangle
Place views using guides
Add a user defined runtime attribute
Set the file’s owner
Auto resize and position objects
About Auto Layout
Specify distance and alignment constraints
Specify size and position
Control-drag a constraint
View and manage constraints
Find and resolve Auto Layout issues
Edit a constraint
Set the intrinsic size
Support dark mode (macOS)
Add device-specific variations
View device configurations
Create user interface variations (iOS, tvOS, watchOS)
Edit variations of property values (iOS, tvOS, watchOS)
Connect objects to code
Send messages to a UI object
Receive messages from a UI object
Manage connections
Add, remove, and edit Cocoa bindings
Edit objects and storyboards
Storyboards, scenes, and connections
Add scenes and views
Add a segue
Configure a segue
Add a storyboard reference
Configure object attributes
Layer views
Set the initial scene
Refactor a storyboard
Preview layouts in different device configurations
Preview your app’s Touch Bar items
Add simulated bars
Set a simulated screen size
Toggle placeholder backgrounds
Work with assets
About Asset catalogs
Add an App Store icon
Use an asset catalog for a launch screen (iPhone)
Create trait-based asset variations (iOS, tvOS, watchOS)
Provide dark appearances (macOS)
Add AR images and objects
Create texture atlases
About SceneKit scene editor
Preview 3D scenes
Add a resizable area to an image
SpriteKit particle emitter editor
Add a particle emitter to your project
Add a particle emitter to a scene
Change background and texture
Manage a particle’s life cycle
Control movement and physics reactions
Adjust size and rotation
Change a particle’s color
Create custom shaders
Debug your app
Debug area overview
Control the execution of your running app
Debug a running app or process
Run an app with diagnostics
Examine variables and threads
View variables
See variable values at runtime
Examine threads and stacks
View threads
Suspend and resume threads
Set breakpoints
Add breakpoints to your code
Navigate and manage breakpoints
Pause execution when events occur
Examine views
View hierarchy debugger
Examine the view hierarchy
Filter the hierarchy
Focus the hierarchy
Inspect a view or constraint
Open the source code
Optimize performance
Monitor an app using gauges
Monitor energy usage (iOS, Mac)
Profile an app
View logs and reports
View and address issues
Show the Touch Bar simulator
Simulate a location
Test code
Run UI tests and unit tests
Add a test class
Add a test target
View test reports
View test failures
Manage performance tests
Enable code coverage
Select run options for tests
Configure targets and builds
Edit General settings
General pane
Edit identity settings
Set the bundle ID
Set the app category (macOS)
Set the version and build
Edit signing settings
Assign a project to a team
Manually sign apps
Edit deployment info
Create a launch screen
Edit Info settings
Edit the information property list
Add export compliance keys
Set the copyright key (macOS)
Set supported document types
Edit build settings
What is a build setting?
Configure build settings
Learn about a build setting
Build variations for different platforms
Evaluate build setting inheritance
Monitor build status
Add a build configuration file
Configure build phases
What are build phases?
Create target dependencies
Link to libraries and frameworks
Run a shell script
Write a build phase script
Add headers to a target
Strip Swift symbols
Manage schemes
Configure schemes
Add, delete, rename, and share schemes
Build multiple targets
Build targets in parallel
Specify runtime arguments and environment variables
Simulate a runtime location
Switch schemes and destinations
Configure capabilities
Add a capability
Configure app groups
Configure App Sandbox (macOS)
Configure Apple Pay
Configure associated domains (iOS, tvOS, watchOS)
Configure background modes (iOS, tvOS, watchOS)
Enable hardened runtime (macOS)
Configure HealthKit (iOS, watchOS)
Configure HomeKit (iOS, tvOS, watchOS)
Configure iCloud services
Enable iCloud services
Manage iCloud containers
Manage CloudKit schemas and records
Configure keychain sharing
Configure Maps
Enable Maps and select modes
Configure a routing app
Configure game controllers (tvOS)
Enable push notifications
Configure Wallet
Configure Siri (iOS, watchOS)
Configure network extensions
Localize your app
What is localization?
Add a language
Make a resource localizable
Add language plural variants
Export localizations for translation
Import localizations
Lock views
Test localizations
Xcode Localization Catalog
Stringsdict file format
Manage devices
Locate a device ID
Install and uninstall apps
Install a beta OS
View and import device logs
Find crash and energy logs
Manage app containers
Take a screenshot
Create a simulator
Pair Apple Watch simulators
View paired Apple Watches
Maintain signing assets
What is app signing?
Export developer accounts
Manage signing certificates
Download provisioning profiles
Manage profiles on devices
View or remove a signing certificate
Signing troubleshooting
If a signing certificate is missing
If an intermediate certificate authority is missing
If a code signing error occurs
If a build has an entitlement error
Manage source control
Source control workflow
Create a local repository
Pull, commit, and push changes
Show changes in the source editor
Compare file revisions
View the history of commits
Add a remote repository account
Create a remote from a local repository
Clone a project from a repository
Add a remote to a local repository
Add collaborators and share a repository
Manage branches
Use tags
Add a README file
Archive, distribute, and test
About the Archives organizer
Prepare for app distribution
Create an archive
Test a beta version
Distribute an app using TestFlight (iOS, tvOS, watchOS)
Distribute to registered devices (iOS, tvOS, watchOS)
Export an app (iOS, tvOS, watchOS)
Manually manage distribution signing
Distribute to registered computers (macOS)
Export an app (macOS)
Test the Mac Installer Package
Create an enterprise app
Develop and distribute enterprise apps
Manually trust a developer on iOS
Distribute outside the Mac App Store
Distribute notarized or Developer ID apps
Upload a macOS app to be notarized
Test a Developer ID app
Enable and disable Gatekeeper
Create a Developer ID installer package
Submit apps to the App Store
What is app thinning?
Distribute through the App Store
Validate an app
Upload an app
Upload in-app purchase content
Verify the build settings
Supported Xcode and Application Loader versions
View crash and energy reports
Crashes organizer
Energy organizer
How reports are created
Select a crash or energy report
View a crash or energy report
Inspect a crash or energy report
View crash or energy report statistics
Symbolicate crash and energy logs
What is symbolication?
Download debug symbols
If logs aren’t symbolicated
Share crash data and statistics with developers
If no crash or energy reports appear
Supported crash reports
Supported energy reports
Perform continuous integration
Continuous integration overview
Configure Xcode Server
Set up Xcode Server
Start and stop Xcode Server
Connect to Xcode Server
Share schemes with Xcode Server
Create a bot
Configure bots
Bot scheme and action settings
Allow Xcode Server to manage signing
Create bot triggers
Configure a bot to run app on multiple devices
Configure a bot to create iOS App files
Xcode Server environment variables
Duplicate, edit, and delete bots
Run, cancel, and delete integrations
View bot integration results
Troubleshoot build failures
If your project has a target dependency cycle
If multiple commands produce the same output
If you use the deprecated Always Search User Paths build setting
Reference
Archive export files
Build settings
Configuration Settings File
Text Macros
Text macro format
Text macros
Xcode Help
Welcome to Xcode
Copyright © 2019 Apple Inc. All rights reserved.
Change Language
Close
English (U.S.)