Android and iOS SDKs para desarrolladores de aplicaciones móviles

Este es el lugar para que los desarrolladores compilen, implementen, prueben y publiquen sus propios widgets de extensión (en lo sucesivo “widget”) para aplicaciones móviles con la plataforma iBuildApp.

Los archivos m123_myfirstapp.m y m123_myfirstapp.h son el punto de ingreso de su widget. En la muestra que figura a continuación, dichos archivos implementan “View” (Vista) con todas las funciones necesarias para configurar su pantalla y el ciclo de vida.

“View” (Vista) contiene “ImageView” (Vista de la imagen) con la imagen cargada del archivo de recursos del widget (nombrado de acuerdo con la convención de nomenclatura de archivos) y “WebView” (Vista web) iniciado por la aplicación host utilizando los datos cargados del archivo de recursos del widget (con formato XML).

La aplicación host analiza el archivo de recursos y guarda datos utilizando “UserDefaults” (Valores predeterminados del usuario). El widget de extensión carga esos datos de “UserDefaults” (Valores predeterminados del usuario) y los muestra en “WebView” (Vista web). Este esquema ilustra la posibilidad de transferir los datos al widget de extensión desde afuera.

Puede implementar cualquier funcionalidad que desee, tomando en cuenta las siguientes convenciones:

• El Controlador de vista inicial del widget debe cumplir con la convención de nomenclatura (m123_myfirstappViewController)
• NO puede utilizar el nombre RootViewController en su código
• Al cargar su widget en el sitio web de iBuildApp.com, también debe proporcionar la lista completa de marcos, bibliotecas estáticas y dinámicas y archivos de objetos requeridos para utilizar su widget.
• Todos los archivos de recursos deben asignarse a la carpeta userContent (consulte p. 3.2 y Fig. 2)
• Todos los archivos de recursos relacionados con la función deben ser nombrados de conformidad con las conveciones nomenclatura(consulte p. 3.2)

El funcionamiento de su función de aplicación iBuildApp

Es posible que deba cambiar “Scheme & Destination” (Esquema y Destino) activos para probar y depurar su widget (consulte las Fig. 6 y 7).

Fig. 6

Fig. 7

La opción que se muestra en la Fig. 6 es adecuada para la mayoría de los casos (Esquema: hostApp, Destino: iPhone 4.3 Simulator): Un ensamble, una compilación y una llamada de biblioteca estática (widget de extensión) de la aplicación host.

Para probar su widget, debe compilar y ejecutar su código; haga clic en el botón adecuado o seleccione “Product” (Producto) > “Run” (Ejecutar) en el menú de Xcode:

Fig. 8

Cuando se crea el widget, debe ensamblarse en el binario final: Configure los siguientes valores para “Scheme & Destination” (Esquema y Destino) activos:

• Esquema: hostApp
• Destino: iOS Device
• Arquitectura: iphoneos (consulte Fig. 4 y 5).

Luego, ejecute “Clean”(Limpiar) (consulte la Fig. 9) y “Build for Archiving” (Compilar para archivar) (Fig. 10). El área marcada en azul en la imagen que figura a continuación ilustra el Esquema y Destino activos para esta tarea:

Fig. 9

Fig. 10

Ahora su widget está listo para cargarse en el servidor de iBuildApp.com. Localice su carpeta de proyecto en la ventana “Finder” (Buscador), seleccione la carpeta userContent y comprímala utilizando la opción correspondiente para su menú de contexto:

Fig. 11

Obtendrá el archivo userContent.zip; cárguelo en el servidor de iBuildApp.com cuando publique su widget de extensión.

Utilizar su widget para aplicaciones de iBuildApp

El archivo M123.java es el punto de ingreso para su widget. En la muestra que figura a continuación, este archivo implementa “Activity” (Actividad) con las funciones necesarias para configurar su pantalla y el ciclo de vida.

“Activity” (Actividad) contiene “ImageView”(Vista de la imagen) con la imagen cargada del archivo de recursos del widget (nombrado de acuerdo con la convención de nomenclatura de archivos) y “WebView” (Vista web) iniciado por la aplicación host utilizando los datos cargados del archivo de recursos del widget (con formato XML).

La aplicación host analiza el archivo de recursos y guarda los datos utilizando EntityParser.java. El widget de extensión carga esos datos de EntityParser.java y los muestra en “WebView” (Vista web). Este esquema ilustra la posibilidad de transferir los datos al widget de extensión desde afuera.

Puede implementar cualquier funcionalidad que desee, tomando en cuenta las siguientes convenciones:

• La “Activity” (Actividad) inicial del widget debe cumplir con la convención de nomenclatura (m123)
• Todos los archivos de recursos deben asignarse a la carpeta res (consulte p. 3.2 y la Fig. 2)
• Todos los archivos de recursos relacionados con el widget deben nombrarse de acuerdo con las convenciones de nomenclatura (consulte p. 3.2)

El funcionamiento de su función de aplicación iBuildApp

Especifique el enlace al widget (como biblioteca) para probar y depurar su widget (consulte la Fig. 4 y la Fig. 5):

Fig. 4

Fig. 5

Para probar su widget, debe compilar iBuildAppSDKLauncher y, luego, ejecutarlo; haga clic en el botón adecuado o seleccione “Run As” (Ejecutar como) > “Android Application” (Aplicación de Android) en el menú de Eclipse:

Fig. 6

Ahora su widget está listo para cargarse en el servidor de iBuildApp.com. Localice su carpeta de proyecto en el administrador de archivos y comprímala en un archivo ZIP.

Obtendrá el archivo .zip; cárguelo en el servidor iBuildApp.com cuando publique su widget de extensión.

Utilizar su widget para aplicaciones de iBuildApp