Knappsack ios Build and Deployment Guide

Transcription

1 Knappsack ios Build and Deployment Guide So you want to build and deploy an ios application to Knappsack? This guide will help walk you through all the necessary steps for a successful build and deployment. Setting up your Apple Developer account If you haven t already, the first step is to set up your developer account at Apple. You can create a new account by going to and selecting the ios Dev Center link. Click on the link to register, which can be found under the Log in button found at the top of the website, or Log in if you already have an existing Apple ID and password. ios Provisioning Portal

2 Once you have logged into the ios Dev Center, at the right of the screen you will find a link to the ios Provisioning Portal. Click on this link to start creating your provisioning profile, which is necessary to develop and deploy your ios apps. The simplest way to get setup with your developer provisioning certificate is by using the Development Provisioning Assistant. There should be a link to launch the assistant from the Home screen of your ios provisioning portal. Distribution Profile In your organization, there can be only one distribution certificate generated for submitting your application for delivery via in house or Ad Hoc distribution. This is how you are able to distribute your application via Knappsack. If you click on the Distribution tab on the left side of the screen in your ios Provisioning portal, there is a link that goes to the Distributing Enterprise Apps for ios Guide. I have also provided the link here: apps/#app43ad8905

3 Sharing Distribution Profile Once you have a valid distribution profile, there is a way to share it amongst your organization so that other people can build against it. The following steps assume that you already have a valid distribution profile and certificate on your computer. 1. In your ios provisioning profile, under the Provisioning section, click on the Distribution tab. You should see your distribution profile here. Download it to an easily accessible folder on your computer. 2. Select Certificates from the bar on the left and go to the Distribution tab. Download your distribution certificate from this web page. 3. Open up your Keychain Access program on your computer. It is typically found under ~/Applications/Utilities. On the left side, select Certificates and look for your Distribution Profile. It should be preceded by iphone Distribution: 4. You should see a drop down triangle to the left of it as shown in the picture below. If you click on it you should see a private key in it. If so, you have a valid distribution certificate that can be distributed to other members of your team. If not, you need to go through the process of creating a valid distribution profile again, following the steps outlined in the link provided above. 5. Right click on this certificate and then select Export Save it to an easily accessible folder path and make sure it is saved as a Personal Information Exchange (.p12) 8. Now, in order for someone else to sign off on applications correctly, they need to have all of the above files on hand: the Distribution profile, Distribution certificate, and the distribution (.p12) file. 9. On the other computer you want to validate, install the distribution certificate into the keychain by double clicking the file. 10. Drag and drop the.p12 file into keychain access. You should see a dropdown arrow next to the certificate. This will contain the key that validates the profile. 11. Finally, drag and drop the distribution profile into the Organizer window that you open in XCode. Make sure that it has the green valid profile status on the right hand side, and you should be all setup to distribute your apps on Knappsack!

4 Deploying your app for Knappsack Once you have a working build of your application that you wish to distribute out with Knappsack, you will need to make sure that certain project options are selected in order to have your project available to download and use. Configuring your project settings Under the main header for your project, select your project target and then Build Settings. Find the Code Signing tab and make sure under Code Signing Identity that you have selected your iphone Distribution profile. Then at the top of Xcode select your build target and set it to ios Device, or the device you are testing on if you have one plugged in.

5 Under your Xcode menu select Product >Archive. Once it is done building, open up your Organizer window and under Archives, you should see the recent build. Select the topmost Archive version, and then on the right side of the screen you should see Validate and Distribute buttons. Select the Distribute button and you should see the following window. Select the Save for Enterprise or Ad Hoc deployment option. Make sure you select your distribution profile as the one to code sign against, and not your developer profiles. Click next and then save the file to a location that is easily accessible. Now it s time to upload that file to Knappsack.

6 Uploading your file to Knappsack Go to and log into your account. At the top of the screen, you should see a menu option called Manage Application. Click on that link. Select the groups associated with your project and then click on edit. On this screen you will see three tabs at the top. Select the one named Applications and then from the drop down select Create New. Select the appropriate Application Type; iphone, ipad, or ios application if it is universal. Fill out the rest of the form and then hit the submit button.

7 Once you have a basic application created, you need to then push up your current version from the.ipa file we created earlier in Xcode from an archive. If the application you just created is brand new you will be automatically redirected to the Create Version page. Now you can just enter your version number and upload the.ipa file under installation file and now your file is up and available for download from Knappsack! Note: Depending on the state you selected while uploading the application version only certain people will be able to see that given version. That s it! Additional documentation will soon be available at