Technical Note TN2215

Troubleshooting Application Archiving in Xcode

This technote answers common issues encountered while archiving iOS and Mac applications in Xcode. See "Archiving Your App" for more information about archiving applications in Xcode.

Why is the Archive menu item grayed out in Xcode ?
Xcode successfully archived my application, but the Archives Organizer does not list my archive
<Project name> does not contain a single–bundle application or contains multiple products. Please select another archive, or adjust your scheme to create a single–bundle application.
The Upload to App Store and Validate buttons are grayed out in the Archives Organizer
Unexpected Save Built Products and Export as Xcode Archive options in the Archives Organizer when attempting to export my archive
Document Revision History

Why is the Archive menu item grayed out in Xcode ?

The Archive menu item may be grayed out in Xcode for any of the following reasons:

Figure 1  Archive action selected in the scheme editor Build pane

Xcode successfully archived my application, but the Archives Organizer does not list my archive

The Organizer may not list your archive after a successful Product > Archive for any of the following reasons:

Figure 2  Reveal Archive in Organizer selected in the scheme editor Archive pane
Figure 3  Skip Install set to NO for the MyApp application

<Project name> does not contain a single–bundle application or contains multiple products. Please select another archive, or adjust your scheme to create a single–bundle application.

You may be getting this message for any of the following reasons:

Figure 4  Headers build phase

The Upload to App Store and Validate buttons are grayed out in the Archives Organizer

If the Archives Organizer shows Upload to App Store and Validate as shown in Figure 5, then your archive is likely a generic Xcode archive rather than an app archive. You cannot package generic archives nor submit them for review. See <Project name> does not contain a single–bundle application or contains multiple products. Please select another archive, or adjust your scheme to create a single–bundle application. for information on how to avoid building a generic archive.

Figure 5  A generic Xcode archive
Figure 6  Archive of an iOS application

Unexpected Save Built Products and Export as Xcode Archive options in the Archives Organizer when attempting to export my archive

If the Archives Organizer shows Save Built Products and Export as Xcode Archive as shown in Figure 7, then your archive is likely a generic Xcode archive rather than an app archive. See <Project name> does not contain a single–bundle application or contains multiple products. Please select another archive, or adjust your scheme to create a single–bundle application. for information on how to avoid building a generic archive.

Figure 7  Attempting to export a generic archive


Document Revision History


DateNotes
2015-10-15

Updated for Xcode 7.

2015-10-14

Updated for Xcode 7.

2015-08-18

Editorial update.

2015-03-27

Updated for Xcode 6.

2014-07-17

Fixed typos.

2014-03-17

Updated the "Unexpected Save Built Products and Export as Xcode Archive options in the Archives Organizer when attempting to distribute my archive" section.

2012-06-28

Added information on how to resolve the Archives Organizer's "Save Built Products" and "Export as Xcode Archive" issue.

2011-09-12

New document that describes how to resolve common issues encountered while archiving iOS and Mac applications in Xcode.