This guide illustrates how to set up an Apple device for deployment, and deploy an application. It covers how to:

Transcription

1 Device Provisioning Overview Before you can deploy your application to a device, you need to have an active subscription with the Apple Developer Program. Visit the Apple Developer Portal to get registered. Apple has outlined a set of special guidelines that developers must follow in order to do everything from deploying to a device to shipping to the App Store. These steps ensure that everything you create or use during the development process, including your applications and devices, can be traced back to your Apple Developer account. This guide illustrates how to set up an Apple device for deployment, and deploy an application. It covers how to: 1. Generate a certificate 2. Provision the device 3. Provision the application and devide to use store technologies 4. Launch the application on device with Xamarin Studio and Visual Studio Let's get started. Requesting a Development Certificate The first step in setting up a development device is requesting a development certificate from Apple. Development certificates and associated keys are a critical piece of information for you as an ios developer: they establish your identity with Apple and associate you with a given device and profile for development, akin to putting your digital signature on your applications. Apple checks for certificates to enforce control over the devices to which you are allowed to deploy. Note: Losing the certificate and associated keys can be incredibly disruptive, as will require you to revoke your existing certificate and re-provision any associated devices, including those registered for ad-hoc deployment. Apple's Xcode will be required to manage development teams, certificates and provisioning profiles. The following sections describe the steps required to use Xcode to generate and install the necessary certificates and profiles to develop and deploy ios applications from Xamarin Studio. Adding Your Apple ID Account in Xcode Before any of the required certificates or profiles and be added, the developer must attach their Apple ID Account

2 to Xcode. 1. Start Xcode. 2. Choose Xcode Menu > Preferences Click the Accounts tab. 4. Click the Add (+) button and select Add Apple ID... from the popup menu: 5. If you have an Apple ID that belongs to an Apple Developer Program, enter your Apple ID and password, and click the Add button:

3 6. Otherwise, click Join a Program in the lower-left corner of the dialog and the Apple Developer Program Page will be displayed in the default web browser: 7. Select a program from the list and follow the onscreen instructions to sign up for an account. 8. Once the new account has been successfully created, return to Xcode and fill in the new account information and click the Add button to continue:

4 Generate a Development Certificate Manually If you are using Visual Studio for Xamarin.iOS development, you also have the option of provisioning manually using the Apple Developer Portal. This requires a few more steps, but the process is not difficult: 1. Login to the Certificates, Identifiers, and Profiles section of the Developer Portal and select the Certificates section from the ios Apps column. Then, hit the "+" to create a new certificate: 2. Select the "ios App Development" option for certificate type. This screen may look different depending on your account privileges:

5 3. To generate a certificate manually, launch Keychain Access from Applications on your Mac. Navigate to the main menu, and select Certificate Assistant and Request a Certificate from a Certificate Authority Fill in your information, and select the option to save Certificate to disk:

6 5. Save the Certicifate somewhere you can find it: 6. Back in the Provisioning Portal, upload the Certificate to the portal and submit:

7 If you do not have admin privileges, you will have to wait for Certificate approval from an account manager. 7. Once the Certificate is approved, download it from the Provisioning Portal: 8. Double clicking on the downloaded Certificate will launch Keychain Access and open the My Certificates panel, showing the new certificate(s):

8 Note: If your Apple Developer account is part of a team, you will see your team members' profiles appear in the Organizer window alongside yours. Understanding Certificate Key Pairs We've mentioned that the Developer Profile contains certificates, their associated keys, as well as any provisioning profiles associated with the account. There are actually two versions of your Developer Profile - one is on the Developer Portal, and the other lives on your local Mac. The difference between the two is the type of keys they contain: the Profile on the Portal houses all the public keys associated with your certificates, while the copy on your local Mac contains all the private keys. For the certificates to be valid, the key pairs must match. Keep a backup of the Developer Profile on your local Mac, because if the private keys are lost, all the certificates and provisioning profiles will need to be regenerated. Provisioning for Development Now that you ve established your identity with Apple and have a Development Certificate, let's set up a provisioning profile so you can deploy to your Apple device. A provisioning profile is a set of digital entities that connects devices and developers with a valid Apple developer account. A device must have your provisioning profile installed in order for you to deploy to it. Note: If your application makes use of store technologies such as icloud or Passbook, you need to provision both the application and the device in the Developer Portal. For more information, see the next section on provisioning applications that use store technologies. Add a Device To generate a provisioning profile, we will first add a device. Devices are added manually using the Apple Developer Portal:

9 1. First, plug in a USB data cable to the ios device. Launch itunes and navigate to the device panel. The device details should appear: Click on the device serial number in itunes to bring up the UDID (Unique Device Identifier). Right click on the UDID to copy it: 2. In the Provisioning Portal, navigate to the Devices section and click the "+" to add a new device. Enter the device name and UDID, and submit: 3. Confirm your device information and submit the request. The device will appear in the device list:

10 Team Provisioning Profile By default, adding a device will create an ios Team Provisioning Profile. We can view this profile and add additional profiles by returning to the ios Provisioning Portal and navigating to Provisioning > Development: If you are an individual developer, the Team Provisioning Profile will contain information about all of your devices and development certificates. If you are sharing a team Apple Developer account, the Team Provisioning Profile will keep track of all devices used by your team, as well as all developer certificates. The Team Provisioning Profile also includes a Wildcard App ID. This in an App ID that will match any app created by you or your team that does not use store technologies, and allow you to deploy these apps to your device. A device is considered provisioned when a provisioning profile contains information about that device is installed on the device. Provisioning for Store Technologies Store technologies, also called entitlements, require a special provisioning process. These technologies include: icloud Passbook Game Center Apple Push Notifications Newsstand

11 Routing apps (such as Maps) In-App Purchases Inter-App Audio Data protection/file security Requesting Signing Identities After the certificates or provisioning profiles have been created in the Apple Developer Portal use the above steps, they will need to be pulled into Xcode so they that they can be accessed by Xamarin Studio. 1. Quit Xamarin Studio. 2. Start Xcode. 3. Choose Xcode Menu > Preferences Click the Accounts tab. 5. Click the View Details... button: 6. The Account Details sheet will be displayed.

12 7. Click the Refresh icon button in the lower left hand corner of the screen: 8. After the list of available Provisioning Profiles has been updated, click the Done button. 9. Quit Xcode. 10. Start Xamarin Studio. The new certificates or provisioning profiles will be available in Xamarin Studio and ready to use. Note: It is sometime necessary to stop and restart Xamarin Studio before it will see any new or modified certificates or profiles updated by Xcode. Set Entitlements in Xamarin Studio You can set entitlements for your projects directly in Xamarin Studio by editing the project's Info.plist and Entitlements.plist in the advanced.plist editor. 1. Before you can add entitlements to your project, you need to set a bundle identifier. Open your application's Info.plist by double-clicking on the file in the Solution Pad.

13 2. To enable Maps integration with your application or Enable Background Modle, scroll down in the Info.plist and check the application's requirements: 3. Next, open the Entitlements.plist file by double clicking on the file in the Solution Pad. You can enable icloud, Passbook, and other store technologies directly in the.plist editor:

14 Older applications may not have an Entitlements.plist in the solution, but one can be added by right-clicking on the project and choosing Add > New File > ios > Entitelements.plist: 4. When you build your application, Xamarin Studio will automatically create a provisioning profile for your application with the required entitlements. Manually Provision for Store Technologies An application using store technologies requires unique application and device provisioning profiles. This section covers the required steps to provision both app and device. Refer to this Apple diagram from the Provisioning

15 Your App For Store Technologies guide for an overview of what information needs to be exchanged between the application and the provisioning profile in order for an application to launch on a device. In the previous example, we relied on the Wildcard App ID provided by the Team Provisioning Profile. Because this application will have special permissions to use store technologies, we can no longer use the team profile, and need to generate a explicit identifier for our app. The first step is to create this identifier, called the App ID. This section explains how to provision profiles with entitlements using Xamarin Studio. The next section explains how to provision manually. To create the App ID manually: 1. Login to the Certificates, Identifiers, and Profiles section of the Developer Portal and select the Identifiers section from the ios Apps column. Then, hit the "+" to create a new App ID: Under Description, enter a friendly name for your App ID so you can find it later. 2. The Prefix, otherwise known as the Bundle Seed ID, is auto-generated by Apple. Two applications sharing the same Prefix can share keychain information and determine the availability of services. For example, the certificates associated with a particular Prefix also determines whether Push Notifications are available. We will select the Team ID:

16 3. For the Suffix, set an Explicit App ID. The store technologies will not work with a Wildcard App ID: 4. Next, select the services (store technologies) that the application needs. We've selected icloud, Data Protection, and Push Notifications (Game Center and In-App Purchases are selected by default):

17 Note: Game Center and In-App Purchases services are selected by default whenever you create a new App ID; however, they are not available as part of the Team Provisioning Profile (or any profile that uses a Wildcard App ID). 5. Confirm the new App ID: With the App ID in place, the next step is to create a provisioning profile using the new App ID. This profile will contain the App ID with the store services enabled, your developer profile, and the devices that are allowed to run the application. Generate a Provisioning Profile

18 To generate a provisioning profile, do the following: 1. Under Provisioning Profiles in the Developer Portal, select Development and then hit "+" to create a new one. Again, choose ios App Development in the available profiles list: 2. From the list of App IDs, select the one we just created:

19 3. From the list of developer certificates, select yours: 4. From the list of devices, select the devices you want your application to run on:

20 5. Name the profile, and Generate:

21 6. Finally, download and install the new profile: You are now ready to deploy an app that uses store technologies! Launch an Application on Device with Xamarin Studio Now that either the team provisioning profile or unique provisioning profile is installed on the device, we can take advantage the App ID to deploy any application to the device. 1. In Xamarin Studio, select the device name from the second dropdown. This option is located on the top left and determines the location to which the application will deploy.

22 Hit the play button to deploy. 2. A popover will appear asking for permission to use your signing key. Select "Allow" or "Always Allow" depending on how much you enjoy popovers. 3. The application should deploy to the device:

23 Launch an Application on Device with Visual Studio 1. Ensure that the device is connected to the Mac build host. 2. In Visual Studio, select iphone at the deployment target, and chose the device name from the third dropdown menu at the top: Summary In this guide, we generated a certificate and a provisioning profile that allowed us to deploy an application to device in both Xamarin Studio and Visual Studio.