We'll dive right into hands-on development at the Developer Event with no time allocated for environment set-up. Please perform the steps below prior to your event so you are all ready to go on the day of your event.
| Step |
Action |
|
|---|
| 1 |
- If you already have Xcode installed on your machine, ensure it is Xcode 7 or later. If you are already running one of these versions, proceed to step 3
|
|
| 2 |
- Install Xcode directly from the Apple App Store
- If you would prefer you can also download Xcode directly from https://developer.apple.com/xcode/ with a valid Apple ID. An Apple developer account which costs $99 per year is not required
|
|
| 3 |
- Start Xcode and on the "Welcome to Xcode" screen click Create a new Xcode project or go under the File menu and click New followed by Project
- To keep it interesting select Game and then click Next
- Specify a "Product Name", "Organization Name", and "Organization Identifier" (in the format com.domain) keeping the rest of the defaults unchanged and click Next
- On the next screen you will specify where you would like to save your project and then actually create and save your project by clicking Create
- Finally click the play triangular button at the top of the window to launch your application in the simulator
- If the application launches and displays properly you can proceed to the next step
|
|
| 4 |
- Ensure your iOS device is plugged into your Mac
- Go back up to the top of the screen and to the right of the play triangular button click the current target and under Device select your device
- On the General tab look in the Signing section and if you have not yet associated an account you will see "No accounts found". If you see this you can click on the Add Account... button or in the menu click Xcode and then Preferences....
- Click on the + in the lower left of the Accounts tab and click Add Apple Id... after which you can enter your Apple ID or create a new one
- In order to deploy an application to a device you need an Apple ID but you don't need to pay the $99 annual fee to join the developer program unless you plan to publish to the public Apple App Store
- Close the dialog and now in the Signing section you should see a Team drop down where you can select your "(Personal Team)"
- Click the play triangular button again and this time it should deploy and launch on your device
- Note if this is your first time doing this Xcode may take some time as it downloads symbol files
- If your app does not launch or you get a dialog indicating that the app "Could not launch" you will need to trust your Developer App certificate. To do this open settings on your device and under General then Device Management you should see the email for the Apple ID you used. Click on your Apple ID email and then on the next screen indicate that you trust the developer followed by a confirmation
- If you are using Xcode 7.3 with a recent OSX releases you may see "Could not find Developer Disk Image". Options include going with a newer version of Xcode or switching to an iOS device with older iOS version. If neither is an option for your situation labs requiring a device should be limited so if needed you can get by with the simulator
- If the app launches and displays on your device, just like you saw previously in the simulator, you should exit Xcode and proceed to the next step
|
|
| 5 |
- Download the latest BlackBerry Dynamics SDK from here Downloads
- Double click on the tar file and inside your should see a pkg file on which you should double click
- This will launch the installer where you should click Continue, Continue, Agree, Continue, and Install. You will probably then be prompted for your username and password following which the actual install will occur. When done click Close and proceed to the next step
|
|
| 6 |
- Launch Xcode and either from the "Welcome to Xcode" launch screen or on the menu File, New, Project and select the template as "BlackBerry Dynamics" and click Next
- Specify a "TestGDApp", Team, Organization Name, Organization Identifier in the format com.domain keeping the rest the defaults followed by clicking Next
- On the next screen you will specify where you would like to save your project and then actually create and save your project using the Create key
- Open the Info.plist file and and click on Information Property List to display the + sign. Click on it to add a new row of type String with a key of "GDLibraryMode" and value of "GDEnterpriseSimulation"
- Finally click the play triangular button at the top of the window to launch your application in the simulator
- Since this is a BlackBerry Dynamics application on first launch it will prompt for your email address and access key to activate your application. Since this is in Enterprise Simulation mode the Access Key can be any numbers you want just so long as all the fields are populated following which you should hit enter
- Next it will prompt you for a password and then ask you to confirm that password
- If the application launches and displays properly you can proceed to the next step
|
|
| 7 |
- Copy the com.good.gd.example.rssreader directory from your home directory under
~Library\Application Support\BlackBerry\Good.platform\iOS\Examples\objective-c\
to your project directory. Since this is currently hidden I have included a zip of the directory for your easy access here
- Open the project in Xcode using the "Welcome to Xcode" screen via the "Open another project..." option or File then Open and select the RSSReader project
- Open RSSReader-Info.plist and click on Information Property List to display the + sign. Click on it to add a new row of type String with a key of GDLibraryMode and value of GDEnterpriseSimulation
- Finally click the play triangular button at the top of the window to launch your application in the simulator
- Since this is a BlackBerry Dynamics application on first launch it will prompt for your email address and access key to activate your application. Since this is in Enterprise Simulation mode the Access Key can be any numbers you want just so long as all the fields are populated following which you should hit enter
- Next it will prompt you for a password and then ask you to confirm that password.
- If the application launches and displays properly (blank screen) you can proceed to the next step
|
|
| 8 |
- If you are doing only iOS Native development you are now ready to do mobile development at the event.
- If your are doing iOS development for Cordova or Xamarin please return to the page from which you were directed here in order to complete the remainder of the steps needed for these development environments
|
|