I wanted to release this a couple days ago, but I have been battling connectivity problems at home.
In my last BlackBerry PlayBook post we went through what resources we needed and how to get Flash Builder 4 installed and integrated with the BlackBerry PlayBook SDK. Next we'll look at installing the BlackBerry PlayBook simulator.
The simulator is actually a bootable ISO image that is intended to be run inside of a VMWare virtual machine. I am sure there are resources on how to get VMWare Player (Windows) or VMWare Fusion (Mac) installed on your system, so I will not be covering it in this post. Instead, I will assume you already have it installed.
First, we need to run the download of the simulator, which essentially just unpacks the ISO. On the Mac you'll have a file called BlackBerryPlayBookSimulator-Installer-Mac.zip and on Windows you'll have BlackBerryPlayBookSimulator-Installer-Win.exe. Unzipping the file or running the exe should result in an ISO file called BlackBerryPlayBookSimulator.iso. Move this file to any location you like, but make note of it, we'll need it in a bit. I put mine right into my Virtual Machines folder that VMWare created for me in /Users/jason/Documents/Virtual Machines
I am on a Mac, so my instructions will be using VMWare Fusion. Hopefully VMWare Player will be similar.
1. Open VMWare Fusion, you should have a VMWare Library that looks something like this: (Though it will probably be empty)
2. Click on the "New" Button in the lower left-hand corner of the library. You'll be prompted to create a new Virtual Machine
3. Choose to "Continue without Disk"
4. Choose "Use Operating System Installation Disk Image File". And you'll be prompted with a file chooser dialog. FInd the ISO file and choose it. Click Continue.
5. When prompted to "Choose Operating System", choose OS: Other, version: Other. NOTE: Be sure to choose OTHER for both options. Do NOT choose "Other 64-Bit" for the version or you'll get a network adapter that won't work right and when you go to get the IP address of your VM later you'll get a "Network Interface" error.
6. Click Continue and then choose "Customize Settings". You'll be prompted to give your VM a name, call it whatever you like.
7. You'll now get a settings window that looks like this. We need to change two settings.
8. Click on "Processors and RAM" and change the RAM to "1024" (You can probably enter 512 if you are running on a POS). Then click Show All to return to the settings.
9. Click on Display and check the box for Accelerate 3D Graphics. You can then close the settings window.
10. Finally, we can launch the VM by clicking on the play button (triangle) in the Library window. This will start the VM, and after a short boot process you'll be prompted with:
11. Type "Y" and hit enter. The boot process will continue and before long you'll have your PlayBook simulator up-and-running.
NOTE: Not actual size :)
12. Now we need to change some settings to allow remote connection from FB4. Click on the "Gear" icon in the upper-right.
13. Click on security and choose to "Enable" next to "Development mode is off.
14. You will be prompted to create a password. This is for your "device"'s security. I'm sure it matters more for a real devices, but since we are making this VM available on the network, we should probably assume it's for the best. Make a note of what it is, I have already had to start over once cause I did not :)
15. Once you have Dev Mode enabled, click on the new "Hammer" icon that has appeared. Write down the IP address that the device is using. We'll use this when we connect from FB4 in a bit.
One recommendation I will make is it not bother ever turning of this VM. Instead, use the "Suspend" action available at the top of the VM window. This is much faster and will hopefully prevent us from getting a new IP from VMWare (Cause then we'd have to go change it in FB4 as you'll see).
Since these posts are consistently longer than I expect I will make "Connecting Flash Builder and the simulator" my next post and I will probably do it this weekend.