Setting up Unity to Build to Your Blackberry10 Device

To get your first project running on your Blackberry 10 device you will need to follow these steps. Note that you will need an internet connection since Unity needs to communicate with Blackberry servers.

1. Register with Blackberry: If you are not already registered with Blackberry you must go to https://www.blackberry.com/SignedKeys/codesigning.html and register. You will receive one or two emails with two .csj files as attachments. (Be sure to choose 'For BlackBerry PlayBook apps developed using BlackBerry WebWorks, BlackBerry NDK, or AIR - AND - For BlackBerry 10 apps developed using BlackBerry WebWorks, or the BlackBerry Native Plug-in for Visual Studio.'). These emails may take up to 2 hours to arrive. Part of the registration process involves creating a PIN. You will need this PIN in the next step.
2. Register Machine: In the Unity editor find Player Settings -> Blackberry -> Publishing and select 'Register'. Fill out the window. Note that the CSJ Pin is the PIN you entered when registering with Blackberry.
   
   If the log file shows errors, then please check you have entered the correct information. The password you enter (and confirm) can be any password, and is used to control access to the machine settings. (You can use 'Restore' to restore registration from a previous backup if you already have registered in the past. If the particular machine is already registered it should be recognized).
3. Create a backup: Use the 'Backup' button to create a backup zip file of the registration. If you fail to do this and you ever lose your registration files you will be unable to use that same account in the future.
   
4. Create a debug Token: A debug token is required to deploy to any Blackberry devices. In Player Settings->BlackBerry->Publishing Settings find Debug Token. Then select Create.
   
   Specify where to save the token and specify one or more PIN(s) to use. The PIN can be found on the device under Settings->About->Hardware. Enter the PIN in the text box and then press Add. The PIN is then added to the list of PINs. Next press the Generate Token button. Unity will communicate with the Blackberry servers and then create the bar file.
5. Enable Development Mode: Make sure the device is in Development mode under Settings -> Security and Privacy -> Development Mode. Take note of the IP address. (This IP address assumes a USB connection between Device and Computer - if you need to use Wifi then you can get the IP from About -> Network. The phone still must be in Development Mode). This IP needs to be filled out in 'Device Address' in the Unity Editor. The 'Device Password' is the same password used to unlock the phone (the phone will force a password set when you enable development mode).
   
6. Upload debug Token: You can now upload token to device (but you must fill out device IP/Password first). Once the token has been uploaded to the device you are able to build and run in the usual way.
7. Launching your game: Use File->Build settings. Switch to the Blackberry platform. Ensure that Build Type is set to Debug and Development build it checked. Then click the Build and Run button. Unity will make the game for you, and deploy it to the device. The game should then start up on the device. You've now built and run your first game on your Blackberry10 device.

Page last updated: 2013-10-09