Generar paquetes para la Store de Windows

Generar paquetes para la Store de
Windows
En este documento se recoge el proceso de generación de paquetes de WP8 y W8 para nuestros juegos
utilizando Wave Engine.

La solución escogida a modo de ejemplo para este tutorial, es la del QuickStarter Flying Kite, disponible
en: https://github.com/WaveEngine/QuickStarters/tree/master/FlyingKite

El documento se divide en cinco secciones:

               Convertir soluciones para Windows 8 y Windows Phone 8
               Preparar solución de Windows 8
               Generar paquete para la plataforma Windows 8
               Preparar solución de Windows Phone 8
               Generar paquete para la plataforma Windows Phone 8

Convertir soluciones para Windows 8 y
Windows Phone 8
 1. Para comenzar, debemos localizar la ruta donde tenemos la solución de nuestro juego (*.sln). Si
    al crear la solución dejaste la ruta por defecto deberías encontrarla en:
    C:\Users\username\Documents\Visual Studio 2013\Projects\

 2. A continuación lanzamos la herramienta Project Converter incluida en el SDK de Wave Engine.

 3. Al abrir la herramienta se mostrará una interfaz simple donde deberemos introducir la ruta de la
    solución de Windows Desktop. Es decir, la ruta buscada en el paso 1. Y marcar las plataformas
    destino a las que queremos convertir nuestro juego. Finalmente pulsamos el botón Convert
    para iniciar la conversión.

4. Se mostrará un cuadro de dialogo informándonos que para la solución de Windows 8
   deberemos realizar un último paso manualmente. Este es descrito más adelante en la sección
   correspondiente. Pulsa OK para continuar.

5. Tras completar este proceso, en el directorio de partida (Paso 1) deben haberse creado 1
   solución por cada una de las plataformas seleccionadas, además de los directorios
   correspondientes.

Preparar la solución de Windows 8
 1. Abrimos la solución de Windows 8, la cual tiene como nombre:
    nombreDelJuegoWindowsStore.sln

 2. Si es la primera vez que abrimos una solución de Windows 8, aparecerá una ventana en la que
    deberemos ingresar una cuenta LiveID de Microsoft, para obtener una licencia de desarrollo
    gratuita.

 3. Tras introducirla, iniciamos sesión. Con ello se renueva la licencia de desarrollo para 3 meses
    más.

4. Una vez abierta la solución, puede verse que la estructura de esta es equivalente a la existente
   en la solución de partida (Windows Desktop). Esta se compone de 2 proyectos, uno llamado
   “nombreDelJuegoProjectWindowsStore” que contiene los ficheros de código comunes a todas
   las plataformas, donde está incluida toda la lógica de nuestro juego. Y otro proyecto llamado
   “Launcher” que contiene los ficheros de código y de contenido específicos de cada plataforma.

5. Para comenzar, deberemos realizar los 3 pasos indicados en el paso 4 del apartado anterior:
       a. Abrimos el fichero Package.appxmanifest del proyecto Launcher.
       b. Seleccionar la pestaña Packaging y pulsar el botón Choose Certificate…
       c. En el desplegable seleccionar Create Test Certificate… y pulsar Ok

6. Por último, antes de lanzar la aplicación es necesario añadir los ficheros de contenido del juego.
   La herramienta debe haberlos incluido en el proyecto de Launcher, aunque estos harán
   referencia a ficheros que no existen físicamente. Estos ficheros no tienen por qué ser
   regenerados para las plataformas de Windows 8 y Windows Phone 8, de forma que es posible
   arrastrar directamente estos ficheros desde la carpeta de contenido del proyecto origen
   (Windows Desktop) al directorio Content de esta solución.

7. Finalmente es posible arrancar el juego en modo depuración para comprobar que todo ha ido
   correctamente.

Generar paquete para la plataforma
Windows 8
 1. Antes de comenzar a generar el paquete para la Store de Windows, es necesario revisar el
    manifiesto de la aplicación. Este podemos encontrarlo en el proyecto Launcher con el nombre
    Package.appxmanifest

 2. Este manifiesto consta de 4 pestañas, de las cuales solo revisaremos las 2 primeras:

            Application UI: En este apartado deberás indicar el nombre de tu juego, una descripción
             del mismo y los modos de rotación soportados. Adicionalmente podrás escoger los
             iconos que mostrará la aplicación. (Ver punto 3)

   Capabilities: En esta pestaña deberán indicarse las capacidades utilizadas por nuestra
           aplicación.
           NOTA: Si se utiliza algún servicio de publicidad, deberá marcar la capacidad Internet
           (Client).

3. A continuación incluiremos los iconos que mostrará la aplicación. Por defecto, la herramienta
   Project Converter incluye los iconos con las dimensiones mínimas necesarias para una
   aplicación de Windows 8. Estos ficheros pueden ser sustituidos por otros con las mimas
   dimensiones que contengan los diseños específicos del juego.

   NOTA: La licencia de Wave Engine exige que el fichero SplahScreen.png no sea modificado.
   [Más información: PRIVACY NOTICE]

4. La solución ya está lista para generar el paquete para la Store de Windows 8. Para ello, haz clic
   derecho sobre el proyecto Launcher y selecciona Store > Create App Packages…

5. A continuación se mostrará un cuadro de dialogo que pregunta si el paquete que se va a generar
   es para la Windows Store. Pulsa sobre “Sign In” e introduce tus credenciales de la Store de
   Windows.

6. Selecciona el nombre de aplicación que tengas reservado para tu juego. Si no tienes aún
   ninguno, pulsa sobre “Reserve Name” para reservar uno. Una vez selecciones el nombre
   correcto, haz clic sobre “Next” y “Create” en la siguiente ventana.

7. Llegados a este punto, el paquete ya está generado en la localización indicada.

Preparar la solución de Windows Phone 8
 1. Abrimos la solución de Windows Phone 8, la cual tiene como nombre:
    nombreDelJuegoWP.sln

 2. Una vez abierta la solución, puede verse que la estructura de esta es equivalente a la existente
    en la solución de partida (Windows Desktop). Esta se compone de 2 proyectos, uno llamado
    “nombreDelJuegoProjectWP” que contiene los ficheros de código comunes a todas las
    plataformas, donde está incluida toda la lógica de nuestro juego. Y otro proyecto llamado
    “Launcher” que contiene los ficheros de código y de contenido específicos de cada plataforma.

 3. Por último, antes de lanzar la aplicación es necesario añadir los ficheros de contenido del juego.
    La herramienta debe haberlos incluido en el proyecto de Launcher, aunque estos harán
    referencia a ficheros que no existen físicamente. Estos ficheros no tienen por qué ser
    regenerados para las plataformas de Windows 8 y Windows Phone 8, de forma que es posible
    arrastrar directamente estos ficheros desde la carpeta de contenido del proyecto origen
    (Windows Desktop) al directorio Content de esta solución.

4. Finalmente es recomendable desplegar la solución para comprobar que todo funciona
   correctamente:
        Si dispones de Hyper-V en tu PC, es posible desplegar el juego en modo depuración
           sobre el emulador de Windows Phone. Para ello, abre el Configuration Manager y
           selecciona la plataforma x86.
        Si dispones de un dispositivo WP8 desbloqueado para desarrollar, es posible desplegar
           el juego en modo depuración sobre el dispositivo. Para ello, abre el Configuration
           Manager y selecciona la plataforma ARM.

Generar paquete para la plataforma
Windows 8
 1. Antes de comenzar a generar el paquete para la Store de Windows, es necesario revisar el
    manifiesto de la aplicación. Este podemos encontrarlo en el directorio Properties del proyecto
    Launcher con el nombre WMAppManifest.xml

 2. Este manifiesto consta de 4 pestañas, de las cuales solo revisaremos las 3 primeras:

            Application UI: En este apartado deberás indicar el nombre de tu juego y una
             descripción del mismo. Adicionalmente podrás escoger los iconos que mostrará la
             aplicación. (Ver punto 3)

   Capabilities: En esta pestaña deberán indicarse las capacidades utilizadas por nuestra
    aplicación.
    NOTA: Si se utiliza algún servicio de publicidad, deberá marcar la capacidad
    ID_CAP_NETWORKING

   Requierements: En esta pestaña deberá indicarse el harware específico del teléfono del
    cual haga uso el juego.

3. A continuación incluiremos los iconos que mostrará la aplicación. Por defecto, la herramienta
   Project Converter incluye los iconos con las dimensiones mínimas necesarias para una
   aplicación de Windows Phone 8. Estos ficheros pueden ser sustituidos por otros con las mimas
   dimensiones que contengan los diseños específicos del juego.

   NOTA: La licencia de Wave Engine exige que los ficheros de Splash Screen no sean modificados.
   [Más información: PRIVACY NOTICE]

4. Finalmente debe seleccionarse el perfil de configuración Release y la plataforma ARM.

5. La solución ya está lista para generar el paquete para la Store de Windows Phone 8. Para ello,
   solo es necesario construir el proyecto Launcher y se generará el paquete de WP8
   (Launcher_Release_ARM.xap) en el directorio de salida.