Setup SalesWarrior on XCode

Setup SalesWarrior App on XCode to compile and deliver on an iPad

Setup SalesWarrior App on XCode

A. Download XCode, AWS S3 SDK for iOS, and the source code:

1. Download and Install XCode version 5.0 or higher (https://developer.apple.com/xcode/downloads/)
2. Download and Unzip Amazon S3 SDK for iOS (http://aws.amazon.com/sdkforios/)

3. Open XCode and click on "Check out an existing project"

4. Enter in a repository location:  https://bitbucket.org/cmaldonados2r/ipad.git , and click Next. 
5. (You will be prompted for username and password on first try.  Your bitbucket username is shift2right, and password is your original 2013 password)
6. Enter in a directory where the workspace will be created on the machine and click Next.  Wait for the source code to be downloaded from BitBucket.

B. Fix/Re-link AWS S3 SDK library to locally downloaded library:

1. Click on WasteManagementCRM on the top left (in blue), then click on Build Phases tab.
2. Open up "Link Binary With Libraries" section.
3. Select AWSS3.framework, and click on the - (minus) sign to remove it.
4. Click on the + (plus) sign to add in the AWSS3.framework from the unzipped directory for the S3 SDK for iOS.

C. Compile and run the app locally on Simulator:

1. On top left Title bar, click on WasteManagementCRM (next to pencil and ruler icon), and select WasteManagementCRM_DEV, and select iOS Simulator - iPad.
2. Click on the triangle right arrow on the top left to run on the Simulator.

D. Compile and run through a device:

1. The device needs to be set on Development mode on XCode
   1. Plug-in a device
   2. Go to Organizer under Window menu
   3. Select the device then click on button "Development Mode"
   4. Close Organizer Window
2. On top left Title bar, click on WasteManagementCRM (next to pencil and ruler icon), and select WasteManagementCRM_DEV, and select iOS Device.
3. Click on the triangle right arrow on the top left to run on the device.

E.  Setup Distribution Certificate and Provisioning Profile. Here are a graph that depicts the Provisioning Profile Process as generic blocks.

1. Create a Certificate Signing Request (CSR)
   1. Use Keychain MacOSX application to generate one. This is needed to create a public and private key of your identity. It will be attached for you (the public part) to the certificate (next step).
      1. From Keychain Access menu choose Certificate Assistant and then Request a Certificate From a Certificate Authority
      2. Fill in only:
         1. User Email Address
         2. Save To Disk
   2. You'll need this file to attach it in step 2
2. Generate a Certificate
   1. There are two types
      1. Developer - Used to distribute apps to developers and testers
      2. Distribution - Used to distribute apps to Apple Store or an Enterprise Distribution (ad-hoc)
   2. Click on Development link in the Developer portal to generate a Developer Certificate by uploading the CSR file generated in step 1.
   3. Once generation has finished, download it to your computer, to a folder where you can later clearly identify it
3. App ID. A string that identifies the application that will be supported by the provisioning profile. Normally the App ID is the reversed company domain name with the app name at the end: com.shift2right.saleswarrior. If the app belongs to a group of other apps, the App ID should end with an asterisk: com.shift2right.* which will allow to sign several related apps.
   1. This string can be found in the bundle identifier in XCode:
      1. Go to Project Navigator and select the project name 'WasteManagementCRM'
      2. Click on General tab and find the bundle identifier as the first field on the detail editor
      3. On Developer portal, click on App IDs link and create a new one that matches your bundle identifier from XCode.
4. Device UUID. In order to distribute the binary to test devices or to Enterprise devices, the provisioning profile must include device's UUID. You can collect these UUIDs by plugin in the device and either in XCode or iTunes check the UUID and add them in the App ID section. Membership includes 100 devices per year, renewable each year.
   1. Click on Devices in the portal
   2. Click on the PLUS sign (top right) to add one by one or in bulk from a formatted file.
   3. You won't be able to change UUID once submitted. You can change the name though.
   4. You can cancel a UUID and its slot will be available in 3 months.
5. Provisioning Profiles
   1. There are two types
      1. Developer - Used to distribute apps to developers and testers
      2. Distribution - Used to distribute apps to Apple Store or as an Enterprise Distribution (ad-hoc)
   2. Click on Development and then the PLUS button (top right)
   3. Next, choose iOS App Development and click Continue
   4. Choose now the App ID for the app you'll be generating a provisioning for. Click Continue.
   5. Choose the Certificate you generated in step 2. Click Continue.
   6. Choose the devices IDs that will be included in the provisioning profile. Click Continue.
   7. Give it a clear and formatted name (highly recommended). I'd suggest something like [ADHOC_]<TYPE>_DDMMMYYYY
      1. [ADHOC] - Just an identifier that the provisioning profile is for AD-HOC deployment (Enterprise) or not
      2. <TYPE> - Could be DEV or PROD
      3. DD - day in double digits
      4. MM - abbreviated month name
      5. YYYY - year
   8. Once generation has finished, download it to your computer, to a folder where you can later clearly identify it
6. Install them in your developer computer
   1. Open the folder where you downloaded your certificate (step 2) and the provisioning profile (step 5)
   2. Double-click the Certificate so XCode can install it
   3. Double-click the Provisioning Profile so XCode can install it
7. Use the provisioning profile to sign an app. The Provisioning Profile contains now the CSR (your identity), the Certificate (public key), the App ID (bundle identifier) and Device UUIDs, so it's time to generate a binary and sign it with the provisioning profile to be able to install it on the devices:
   1. Plug-in a device to your Mac
   2. From the Schema pop-up (top left on XCode), select WasteManagementCRM_DEV, and then select the name of the device from the combo
   3. Choose Run from Product menu
   4. After building, XCode will choose the provisioning profile to run on the plugged-in device.
      1. Check that the provisioning profile was installed onto the device by going to Settings-->General-->Profiles