Hello World with Monoberry

 
Monoberry is a library that allow the native application developing with Mono and C#, in the actual version, only graphic applications can be developed with Open GL ES 1.0 and 2.0, besides an access to the BlackberryPlatform Service libraries.

Tools required to Develop with Monoberry

To develop with Monoberry, the following tools are required:
-          Visual Studio 2012 (Professional, Premium o Ultimate) - http://www.microsoft.com/visualstudio/eng/downloads#d-2012-editions
-          Blackberry OS 10 Native SDK - http://developer.blackberry.com/native/download/
-          Blackberry OS 10 Emulator  - http://developer.blackberry.com/native/download/
-          Monoberry Tools for Visual Studio - http://visualstudiogallery.msdn.microsoft.com/b4803586-b446-4df1-8254-978f00ceb52d
The tools should be installed in the order from the list shown before.

Hello World with Monoberry

The creation of an application of Monoberry, is very easy like any other mobile platform. For this first example we will create a dialogue chart where the next message is shown: “Hello world from Latin America with Monoberry”.

Step 1: Create a new Project

To create a new Project, you have to open Visual Studio 2012, and then go to the option File-> New -> Project and then choose the option Monoberry Application, as seen on the next print screen:

We’ll name the project “HelloWorldMonoberry” and then we click on the “OK” button.
Then an assistant is displayed so that we can configure the basic parameters of the application:

The first step is to configure the SDK, in case to be the first Project, we don’t have any SDK registered, we must register clicking on the “Manage SDKS” button, this will open a new window where we should type the SDK name and the path that we want to register, for our example we’ll use the following data and click the “Add” button: 
-          Name: Default SDK
-          Path: C:\bbndk\host_10_0_9_404

Then we’ll close the dialogue chart clicking on the “Close” button and then we can choose the SDK, to go forward in the assistant:

As a next step, we have to configure the emulator, for this we have to ad done, with a name and IP address, to get the emulator’s IP address, we have to open the emulator and scroll down, on the left corner you can see the address, as seen on the print screen:


For this guide we’ll use the following:
-          Name: Test Device
-          IP Address: 192.168.42.128

For the third step, we have to add the application´s basic data, like name, author, author’s identifier, description and extra permissions for the application can run. The following data will be used as example:
-          Name: HelloWorld
-          Autor: Unknown
-          AutorID: hYAVVGfacBFUKY7rJsXs2e2lxY0
-          Description: Basic Hello World Application

For the last step, the assistant will display a summary of all the entered data, so you can check that they are correct:

After clicking on the “Finish” button, the assistant will close and Visual Studio will proceed to create the project, which will have the following structure:

Step 2: Clear the Project

We have to delete the file, Cube.cs  and then delete all the code lines referent to that class, from the method Main housed in the Program.cs file, so that it is like shown: 
using System;
using System.Text;
namespace HelloWorldMonoberry
{
    class Program
    {
        public static void Main(string[] args)
        {
        }
    }
}

Step 3: Add the Monoberry libraries

As a next step we have to add the Monoberry libraries from NuGet, for this reason we will open the Package Manager Console and run the following sentence:
-          Install-Package MonoRuntimeForMonoberry
-          Install-Package Monoberry
The first sentence adds the Mono runtime for Blackberry OS 10 together with the basic libraries for operating Monoberry which are:
-          MsCorLib
-          System.dll
-          System.Drawing.dll
-          System.Xml.dll
The second sentence will add the Monoberry reference to our project:
-          BlackberryPlatformService.dll
-          OpenTKBlackberry.dll

Step 4: Add code to display a dialogue

The next step, will add the objects necessary to display a dialogue on the screen. The dialogue is simple:
                var run = true;
                string message = string.Format("Hola Mundo desde Latinoamérica con Monoberry!. BPS Version: {0}",
                    PlatformServices.GetVersionBPS().ToString());
                while (run)
                {
                    Dialog.Alert("CLOSE ME!", message, new Button("Close", () => run = false));
                }

 

As you can see, we just call a dialogue, where we sent the following parameters:
-          Título: “CLOSE ME!”
-          Mensaje: “Hola mundo desde Latinoamerica con Monoberry!....”
-          Boton: new Button("Close", () => run = false), el Segundo parametro del boton, es el comportamiento que tendrá cuando se lo pulse.

Step 5: Launch the application

To launch the application, first we have to enable a previous configuration. First we have to go to the project’s properties, to the Debug section:

In this section, we have to enable the “Start external program” option and the path, we have to add the powershell’s location, which is: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
After, in the argument section we have to add the following (the file path ““Monoberry_Launcher.ps1” should be the same from the project):
-file "C:\Users\user.name\Documents\Visual Studio 2012\Projects\HelloWorldMonoberry\HelloWorldMonoberry\PackagerScripts\Monoberry_Launcher.ps1"
With everything configured, the only thing we need is to save the changes from the project’s properties and launch the application with “Ctrl + F5”: 

Hola Mundo con Monoberry

 

Monoberry es una librería que permite el desarrollo de aplicaciones nativas con Mono y C#, en la versión actual, solo se pueden desarrollar aplicaciones graficas con Open GL ES 1.0 y 2.0, además de acceso a las librerías del Blackberry Platform Service

Herramientas necesarias para el Desarrollo con Monoberry

Para poder desarrollar con Monoberry, se necesitan las siguientes herramientas:
-          Visual Studio 2012 (Professional, Premium o Ultimate) - http://www.microsoft.com/visualstudio/eng/downloads#d-2012-editions
-          Blackberry OS 10 Native SDK - http://developer.blackberry.com/native/download/
-          Blackberry OS 10 Emulator  - http://developer.blackberry.com/native/download/
-          Monoberry Tools for Visual Studio - http://visualstudiogallery.msdn.microsoft.com/b4803586-b446-4df1-8254-978f00ceb52d
Las herramientas deben ser instaladas en el orden de la lista, antes descrita.

Hola Mundo con Monoberry

La creación de una aplicación de Monoberry, es muy sencilla como con cualquier otra plataforma móvil. Para este primer ejemplo crearemos un cuadro de dialogo donde se muestre el siguiente mensaje: “Hola Mundo desde Latinoamérica con Monoberry”.

Paso 1: Crear un nuevo proyecto

Para crear un nuevo proyecto, hay que abrir Visual Studio 2012, y luego dirigirse a la opción File-> New -> Project y luego hay que elegir el tipo de proyecto Monoberry Application, como se puede ver en la siguiente imagen:

Al proyecto le daremos el nombre de “HelloWorldMonoberry” y luego haremos clic en el botón “OK”.
Luego se nos desplegara un asistente para que podamos configurar los parámetros básicos de la aplicación:

El primer paso a configurar es el SDK, en caso de que sea el primer proyecto no tendremos ningún SDK registrado, por lo que deberemos registrar uno haciendo clic en el botón “Manage SDKS”, esto nos abrirá una nueva ventana donde deberemos ingresar el nombre y el path del SDK que queremos registrar, para nuestro ejemplo usaremos los siguientes datos y haremos clic en el botón “Add”:
-          Name: Default SDK
-          Path: C:\bbndk\host_10_0_9_404

Luego cerraremos el cuadro de dialogo con el botón “Close” y ahora podremos elegir el SDK, para poder avanzar en el asistente:

Como segundo paso, hay que configurar el emulador, para lo cual hay que agregar uno, con un nombre y dirección de IP, para conseguir la dirección de IP del emulador, hay que abrir el emulador y deslizar la pantalla hacia abajo, en esquina inferior izquierda se encuentra la dirección, como se puede ver a continuación:


Para la presente guía utilizaremos los siguientes datos:
-          Name: Test Device
-          IP Address: 192.168.42.128

Para el tercer paso, hay que agregar los datos básicos de la aplicación, como nombre, autor, identificador de autor, descripción y permisos extra para que la aplicación puede ejecutarse. Se usaran los siguientes datos de ejemplo:
-          Name: HelloWorld
-          Autor: Unknown
-          AutorID: hYAVVGfacBFUKY7rJsXs2e2lxY0
-          Description: Basic Hello World Application

Como último paso, el asistente nos mostrara un resumen de todos los datos ingresado, para que se pueda revisar que estén correctos:

Luego de hacer clic en el botón “Finish”, el asistente se cerrara y Visual Studio procederá a crear el proyecto, que tendrá la siguiente estructura:

Paso 2: Limpiar Proyecto

Hay que eliminar el archivo, Cube.cs y luego eliminar todas las líneas de código referente a esa clase, del método Main alojado en el archivo Program.cs, para que quede como se muestra:
using System;
using System.Text;
namespace HelloWorldMonoberry
{
    class Program
    {
        public static void Main(string[] args)
        {
        }
    }
}

Paso 3: Agregar las librerías de Monoberry

Como siguiente paso hay que agregar las librerías de Monoberry desde NuGet, para tal motivo, abriremos el Package Manager Console y ejecutaremos la siguiente sentencia:
-          Install-Package MonoRuntimeForMonoberry
-          Install-Package Monoberry
La primera sentencia agregara el runtime de Mono para Blackberry OS 10, junto con las librerías básicas para el funcionamiento de Monoberry, que son:
-          MsCorLib
-          System.dll
-          System.Drawing.dll
-          System.Xml.dll
La segunda sentencia agregara las referencias de Monoberry a nuestro proyecto:
-          BlackberryPlatformService.dll
-          OpenTKBlackberry.dll

Paso 4: Agregar código para mostrar un dialogo

El siguiente paso, será agregar los objetos necesarios para poder mostrar un dialogo en pantalla. El código, es simple:
                var run = true;
                string message = string.Format("Hola Mundo desde Latinoamérica con Monoberry!. BPS Version: {0}",
                    PlatformServices.GetVersionBPS().ToString());
                while (run)
                {
                    Dialog.Alert("CLOSE ME!", message, new Button("Close", () => run = false));
                }

 

Como se puede apreciar, solo llamamos a un Dialogo, donde le mandamos los siguientes parámetros:
-          Título: “CLOSE ME!”
-          Mensaje: “Hola mundo desde Latinoamerica con Monoberry!....”
-          Boton: new Button("Close", () => run = false), el Segundo parametro del boton, es el comportamiento que tendrá cuando se lo pulse.

Paso 5: Lanzar la aplicación

Para poder lanzar la aplicación, primero deberemos realizar una configuración previa. Primero hay que ir a las propiedades del proyecto, a la sección Debug:

En esa sección, hay que habilitar la opción “Start external program” y en el path, hay que agregar la ubicación de powershell, que es: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
Después, en la sección argumentos hay que agregar lo siguiente (la ruta del archivo “Monoberry_Launcher.ps1” debe ser la misma que la del proyecto):
-file "C:\Users\user.name\Documents\Visual Studio 2012\Projects\HelloWorldMonoberry\HelloWorldMonoberry\PackagerScripts\Monoberry_Launcher.ps1"
Ya con todo configurado lo único que necesitamos es guardar los cambios de las propiedades del proyecto y lanzar la aplicación con “Ctrl + F5” y listo: