Apple Account Management
- PDF for offline use
Let us know how you feel about this
last updated: 2017-04
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
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.
- Ensure you are connected to the internet. This is because fastlane communicates directly with the Apple Developer portal.
- Ensure you have fastlane tools installed
- Ensure you have the latest fastlane tools from https://download.fastlane.tools
- Before you begin, make sure to accept any user license agreements in the developer portal.
Signing in with the Apple Account Dialog
To open go to Xamarin Studio > Preferences > Apple Developer Account:
Press the + button to start authentication through fastlane. This will bring up the following alert dialog:
Once you press OK, the terminal application will open allowing you to enter your details:
Enter your Apple ID and Password.
Once your Apple ID and password have been entered, you will automatically be returned to Xamarin Studio. Select Always Allow on the following dialog:
Here, you'll see your Apple ID, along with any teams that your Apple ID is part of.
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
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.
- 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.