Apple Account Management

PDF for offline use

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-04

Overview

the Apple account management interface provides a way to view all developments teams associated with an Apple ID. It also allows you to view more details about each team by displaying a list of Signing Identities and Provisioning Profiles that are installed on your machine.

Authentication of your Apple ID is performed on the command line with fastlane. fastlane must be installed on your machine for you to be successfully authenticated. More information on fastlane and how to install it is detailed in the fastlane guides.

The Apple Account dialog in Visual Studio for Mac allows you to do the following:

  • Manage Certificates – This feature allows you to create and install development and distribution signing identities for iOS and Mac Apps ️

    Requirements

Apple account management is available on Visual Studio for Mac. It is not currently available on Visual Studio for Windows.

You must have an Apple Developer account to use this feature. More information on Apple developer accounts is available in the Device Provisioning guide.

Signing in with the Apple Account Dialog

  1. To open go to Xamarin Studio > Preferences > Apple Developer Account:

    Apple Developer Account options

  2. Press the + button to start authentication through fastlane. This will bring up the following alert dialog:

    fastlane prompt

  3. Once you press OK, the terminal application will open allowing you to enter your details:

    Terminal opens to enter credentials

  4. Enter your Apple ID and Password.

  5. Once your Apple ID and password have been entered, you will automatically be returned to Xamarin Studio. Select Always Allow on the following dialog:

  6. Here, you'll see your Apple ID, along with any teams that your Apple ID is part of.

  7. Select any team and press the View Details… button. This will display a list of all Signing Identities and Provisioning Profiles that are installed on your machine:

Managing Signing Identities and Provisioning Profiles

The team details dialog displays a list of Signing Identities, organized by type. The Status column advises you if the certificate is:

  • Valid – The signing identity (both the certificate and the private key) is installed on your machine and it has not expired.

  • Not in Keychain – There is a valid signing identity on Apple's server. To install this on your machine, it must be exported from another machine. You cannot download the signing identity from the Apple Developer Portal as it will not contain the private key.

  • Private key is missing – A Certificate with no private key is installed in the keychain.

  • Expired – The Certificate is expired. You should remove this from your keychain.

Create a Signing Identities

To create a new signing identity, select the Create new Certificate drop-down button and select the type that you require. If you have the correct permissions a new signing identity will appear after a few seconds.

If an option in the drop-down is greyed out and unselected, as illustrated below, it means that you do not have the correct team permissions to create this type of certificate.

Download Provisioning Profiles

The team details dialog also displays a list of all provisioning profiles connected to your developer account. You can download all provisioning profiles to your local machine by pressing the Download all Profiles button

Troubleshooting

View Details dialog is empty

This is currently a known issue, relating to bug #53906. Make sure that you are using the latest stable version of Visual Studio for Mac

If you are experiencing issues logging in your account, please try the following:

  • Open the keychain application and under Category select Passwords. Search for deliver., and delete all entries.

"Error Adding Account. Please Sign in with an app-specific password"

This is because 2 factor authentication is enabled on your account. Make sure that you are using the latest stable version of Visual Studio for Mac

Failed to create new certificate

"You have reached the limit for certificates of this type"

The maximum number of certificates allowed have been generated. To fix this, browse to the Apple Developer Center and revoke one of the Production Certificates.

Known Issues:

  • Sometimes the View Details dialog can take an inordinate amount of time to fetch the signing identities and profiles.
  • Often the focus may not return to Xamarin Studio after entering your details, causing your account not to be added. If this is the case, try the process again.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.