Utilización de la CLI de MobileFirst para gestionar artefactos de MobileFirst

Visión general

IBM Mobile Foundation proporciona una herramienta de interfaz de línea de mandatos (CLI) a los desarrolladores, mfpdev, para gestionar con facilidad artefactos de servidor y de cliente.
Mediante la CLI podrá gestionar aplicaciones basadas en Cordova que utilicen el plugin MobileFirst y aplicaciones que utilicen MobileFirst Native SDK.

También podrá crear, registrar y gestionar adaptadores en instancias de MobileFirst Server locales y remotas así como administrar proyectos desde la línea de mandatos o a través de los servicios REST o desde MobileFirst Operations Console.

Los mandatos mfpdev tienen dos modalidades: la modalidad interactiva y la modalidad directa. En la modalidad interactiva, se especifican mandatos sin opciones y a medida que es necesario se le solicitan respuestas. En la modalidad directa, se especifica un mandato completo, incluidas las opciones, sin que se le solicite información. Cuando corresponda, los indicadores de solicitud son sensibles al contexto para la plataforma de destino de la aplicación, tal como lo determina el directorio desde el que se ejecuta el mandato. Utilice las teclas de cursor del teclado para moverse a través de las selecciones y pulse la tecla Intro cuando la selección que desee esté resaltada y seguida por el carácter “>”.

En esta guía de aprendizaje aprenderá a instalar el mfpdev CLI (Command Line Interface) y cómo utilizarlo para gestionar instancias, aplicaciones y adaptadores de MobileFirst Server.

Para obtener más información con relación a la integración de SDK en aplicaciones Cordova y nativas, consulte las guías de aprendizaje en la categoría de Adición de Mobile Foundation SDK.

Ir a

• Requisitos previos
• Instalación de MobileFirst CLI
• Lista de mandatos de CLI
• Modalidad directa e interactiva
• Gestión de instancias de MobileFirst Server
• Gestión de aplicaciones
• Gestión y realización de pruebas con adaptadores
• Mandatos de utilidad
• Actualización y desinstalación de la interfaz de línea de mandatos

Requisitos previos

MobileFirst CLI está disponible como un paquete NPM en el registro NPM.

Asegúrese de que node.js y npm estén instalados en el entorno de desarrollo con el propósito de instalar paquetes NPM.
Siga las instrucciones de instalación en nodejs.org para instalar node.js.

Para confirmar que node.js está correctamente instalado, ejecute el mandato node -v.

node -v
v6.11.1

Nota: La versión de node.js mínima soportada es 4.2.3. Además, con los paquetes en rápida evolución de node y npm, la CLI de MobileFirst puede no ser totalmente funcional con todas las versiones disponibles de node y npm incluidas las versiones más recientes.

Para las versiones de la CLI de MobileFirst hasta iFix versión 8.0.2018040312, inclusive, asegúrese de que node tenga la versión 6.11.1 y que npm tenga la versión 3.10.10, para el funcionamiento adecuado de la CLI.

Para la CLI de MobileFirst iFix versiones 8.0.2018100112 y posteriores, puede utilizar Node versión 8.x o 10.x

Instalación de MobileFirst CLI

Para instalar la interfaz de línea de mandatos ejecute el mandato:

npm install -g mfpdev-cli --no-optional

Si el archivo .zip de la interfaz de línea de mandatos (CLI) se descargó desde el Centro de descargas de MobileFirst Operations Console, utilice el mandato:

npm install -g <path-to-mfpdev-cli.tgz>

• Si desea instalar la CLI sin dependencias opcionales añada el distintivo --no-optional: npm install -g --no-optional path-to-mfpdev-cli.tgz

Para confirmar la instalación, ejecute el mandato mfpdev sin argumentos de forma que imprima el texto de ayuda:

NAME
     IBM MobileFirst Foundation Command Line Interface (CLI).

SYNOPSIS
     mfpdev <command> [options]

DESCRIPTION
     The IBM MobileFirst Foundation Command Line Interface (CLI) is a command-line
     for developing MobileFirst applications. The command-line can be used by itself, or in conjunction
     with the IBM MobileFirst Foundation Operations Console. Some functions are available from  
     the command-line only and not the console.

     For more information and a step-by-step example of using the CLI, see the IBM Knowledge Center for
     your version of IBM MobileFirst Foundation at

          https://www.ibm.com/support/knowledgecenter.
    ...
    ...
    ...

Lista de mandatos de CLI

Modalidad directa e interactiva

Todos los mandatos se pueden ejecutar en la modalidad interactiva o directa. En la modalidad interactiva, se le solicitarán para el mandato los parámetros necesarios y se utilizarán algunos valores predeterminados. En la modalidad directa, se deben proporcionar parámetros con el mandato que se está ejecutando.

Ejemplo:

mfpdev server add en la modalidad interactiva:

? Enter the name of the new server definition: mydevserver
? Enter the fully qualified URL of this server: http://mydevserver.example.com:9080
? Enter the MobileFirst Server administrator login ID: admin
? Enter the MobileFirst Server administrator password: *****
? Save the admin password for this server?: Yes
? Enter the context root of the MobileFirst administration services: mfpadmin
? Enter the MobileFirst Server connection timeout in seconds: 30
Verifying server configuration...
The following runtimes are currently installed on this server: mfp
Server profile 'mydevserver' added successfully.

El mismo mandato en la modalidad directa sería

mfpdev server add mydevserver --url http://mydevserver.example.com:9080 --login admin --password admin --setdefault

Para averiguar la sintaxis correcta para un mandato en la modalidad directa, utilice mfpdev help <command>.

Gestión de instancias de MobileFirst Server

Utilice el mandato mfpdev server <option> para gestionar instancias de MobileFirst Server que ya se están utilizando. Debe haber listada al menos una instancia de servidor como la instancia predeterminada. Se utiliza siempre el servidor predeterminado si no se especifica otro.

Listar las instancias de servidor

Para listar todas las instancias de MobileFirst Server disponibles para ser utilizadas, ejecute el mandato:

mfpdev server info

De forma predeterminada, se crea automáticamente un perfil de servidor local que la CLI utiliza como la predeterminada actual.

Adición de una nueva instancia de servidor

Si está utilizando otra instancia de MobileFirst Server local o remota puede añadirla a la lista de instancias disponibles a utilizar con el mandato:

mfpdev server add

Siga las solicitudes interactivas para proporcionar un nombre al servidor, el URL de servidor y las credenciales de usuario y contraseña.
Por ejemplo, para añadir una instancia de MobileFirst Server que se ejecuta en un servicio de IBM Cloud de Mobile Foundation debería añadir lo siguiente:

$ mfpdev server add
? Enter the name of the new server profile: MyBluemixServer
? Enter the fully qualified URL of this server: https://mobilefoundation-7abcd-server.mybluemix.net:443
? Enter the MobileFirst Server administrator login ID: admin
? Enter the MobileFirst Server administrator password: *****
? Save the administrator password for this server?: Yes
? Enter the context root of the MobileFirst administration services: mfpadmin
? Enter the MobileFirst Server connection timeout in seconds: 30
? Make this server the default?: Yes
Verifying server configuration...
The following runtimes are currently installed on this server: mfp
Server profile 'MyBluemixServer' added successfully.

• Sustituya “fully qualified URL of this server” con su propio valor.

Editar instancias de servidor

Si desea editar los detalles de una instancia de servidor registrada, ejecute el siguiente mandato y siga las solicitudes interactivas para seleccionar el editor a editar y proporcione la información para actualizarlo.

mfpdev server edit

Para establecer el servidor como el predeterminado, utilice:

mfpdev server edit <server_name> --setdefault

Eliminar instancias de servidor

Para eliminar una instancia de servidor de la lista de servidores registrados, ejecute el mandato:

mfpdev server remove

Y seleccione el servidor de la lista interactiva

Cómo abrir MobileFirst Operations Console

Para abrir la consola del servidor predeterminado, ejecute el siguiente mandato:

mfpdev server console

Para abrir la consola para otro servidor, informe del nombre de servidor como un parámetro del mandato:

mfpdev server console <server_name>

Eliminación de aplicaciones y adaptadores del servidor

Para eliminar todas las aplicaciones y todos los adaptadores registrados en un servidor ejecute el mandato:

mfpdev server clean

A continuación, seleccione en la solicitud interactiva el servidor en el que realizar la eliminación.
Esto colocará la instancia del servidor en estado sin cualquier aplicación o adaptador desplegado.

Gestión de aplicaciones

El mandato mfpdev app <option> sirve para gestionar aplicaciones creadas con Mobile Foundation SDK.

Registro de una aplicación en una instancia de servidor

Una aplicación se debe registrar en MobileFirst Server cuando esté lista para ser ejecutada.
Para registrar una aplicación, ejecute el siguiente mandato desde la carpeta raíz del proyecto de la aplicación:

mfpdev app register

Este mandato se puede ejecutar desde la raíz de la aplicación Cordova, Android, iOS o Windows.
Utilizará el tiempo de ejecución y el servidor predeterminado para ejecutar las siguientes tareas:

• Registrar una aplicación con un servidor.
• Generar un archivo de propiedades de cliente predeterminado para la aplicación.
• Colocar la información del servidor en el archivo de propiedades de cliente.

Para una aplicación Cordova, este mandato actualizará el archivo config.xml.
Para una aplicación iOS, este mandato actualizará el archivo mfpclient.plist.
Para una aplicación Android, este mandato actualizará el archivo mfpclient.properties.

Para registrar una aplicación en un tiempo de ejecución y en un servidor que no sea el predeterminado, utilice la sintaxis:

mfpdev app register <server> <runtime>

Para la plataforma Cordova Windows, se debe añadir el argumento -w <platform> al mandato. El argumento <platform> es una lista de plataformas de Windows que se deben registrar separadas por comas. Los valores válidos son windows,windows8 y windowsphone8.

mfpdev app register -w windows8

Configuración de una aplicación

Cuando se registra una aplicación, los atributos relacionados con el servidor se añaden a su archivo de configuración.
Para cambiar los valores de estos atributos, ejecute el siguiente mandato:

mfpdev app config

Este mandato presentará de forma interactiva una lista de atributos que se pueden cambiar y solicitará el valor de los nuevos atributos.
Los atributos disponibles variarán para cada plataforma (iOS, Android, Windows).

Las configuraciones disponibles son:

• El tiempo de ejecución y la dirección de servidor que se registrarán

  Caso de uso de ejemplo: para registrar una aplicación en un MobileFirst Server con una dirección determinada, pero tener también la aplicación conectada a una dirección de servidor distinta, por ejemplo, un dispositivo DataPower:

  1. Ejecute mfpdev app register para registrar la aplicación en la dirección de MobileFirst Server esperada.
  2. Ejecute mfpdev app config y cambie el valor de la propiedad server para que coincida con la dirección del dispositivo DataPower. También puede ejecutar el mandato en la modalidad directa: mfpdev app config server http(s)://server-ip-or-host:port.

• Estableciendo una clave pública para la característica de autenticidad de Direct Update
• Estableciendo un idioma predeterminado de aplicación (el valor predeterminado es inglés (en))
• Habilitar o inhabilitar la prueba de suma de comprobación de recursos web
• Extensiones de archivo a ignorar durante una prueba de suma de comprobación de recursos web

Vista previa de una aplicación de Cordova

Obtenga una vista previa de los recursos web de una aplicación Cordova mediante un navegador. La vista previa de una aplicación permite un rápido desarrollo sin la necesidad de utilizar simuladores ni emuladores específicos de las plataformas nativas.

Antes de ejecutar el mandato de vista previa, debe preparar el proyecto añadiendo la variable wlInitOptions. Complete los siguientes pasos:

1. Añade la variable wlInitOptions a su archivo JavaScript principal, que es index.js en una aplicación Cordova estándar.

   var wlInitOptions = {
      mfpContextRoot:'/mfp', // "mfp" is the default context root of MobileFirst Server
      applicationId:'com.sample.app' // Replace with your own value.
   };
   

2. Registre de nuevo la aplicación utilizando el siguiente mandato:

   mfpdev app register
   

3. Ejecute el siguiente mandato:

   cordova prepare
   

4. Obtenga una vista previa de la aplicación Cordova ejecutando el siguiente mandato desde la carpeta raíz de la aplicación Cordova:

   mfpdev app preview
   

Se le solicitará que seleccione la plataforma para la vista previa y el tipo de vista previa a utilizar. Hay dos opciones de vista previa: MBS (Mobile Browser Simulator) y navegador.

• MBS - Mobile Browser Simulator. Este método simula un dispositivo móvil en un navegador, así como proporciona una simulación de API de Cordova rudimentaria como, por ejemplo, la de cámara, subida de archivos o geoubicación, entre otras. Nota: No es posible utilizar el navegador cordova con la opción MBS.
• Navegador - Representación de navegador simple. Este método presenta los recursos www de la aplicación Cordova como una página web de navegador normal.

Para obtener detalles sobre las opciones de vista previa, consulte la guía de aprendizaje de Desarrollo Cordova.

Actualización de recursos web para Direct Update

Los recursos web de una aplicación cordova como, por ejemplo, archivos .html, .css y .js dentro de una carpeta www se pueden actualizar sin la necesidad de reinstalar la aplicación en el dispositivo móvil. Esto es posible con la característica de Direct Update que Mobile Foundation proporciona.

Para obtener más detalles sobre cómo funciona Direct Update, consulte la guía de aprendizaje Utilización de Direct Update en aplicaciones Cordova.

Cuando desee enviar un nuevo conjunto de recursos web para actualizarlos en una aplicación cordova, ejecute el mandato

mfpdev app webupdate

Este mandato empaquetará los recursos web actualizados en un archivo .zip y los subirá a la instancia de MobileFirst Server registrada. Los recursos web empaquetados se pueden encontrar en la carpeta [cordova-project-root-folder]/mobilefirst/.

Para subir los recursos web a una instancia de servidor diferente, informe del tiempo de ejecución y el nombre de servidor como parte del mandato

mfpdev app webupdate <server_name> <runtime>

Utilice el parámetro –build para generar el archivo .zip con los recursos web empaquetados sin subirlos a un servidor.

mfpdev app webupdate --build

Para subir un paquete compilado con anterioridad, utilice el parámetro –file

mfpdev app webupdate --file mobilefirst/com.ibm.test-android-1.0.0.zip

Adicionalmente, se pueden cifrar los recursos utilizando el mandato

mfpdev app webencrypt

Este mandato especifica que se cree una versión cifrada del contenido del directorio wwww de la plataforma para su despliegue en dispositivos móviles. Disponible solo para plataformas iOS y Android.

Hacer pull y push a la configuración de la aplicación de MobileFirst

Después de que una aplicación de MobileFirst esté registrada en una instancia de MobileFirst Server, existe la posibilidad de cambiar algunas de las configuraciones de aplicación mediante la consola de MobileFirst Server y, a continuación, obtenerlas haciendo pull a dichas configuraciones desde el servidor a la aplicación con el siguiente mandato:

mfpdev app pull

También es posible cambiar las configuraciones de la aplicación localmente y hacer push de los cambios a MobileFirst Server con el mandato:

mfpdev app push

Ejemplo: Se pueden realizar correlaciones de ámbito para comprobaciones de seguridad en MobileFirst Operations Console y, a continuación, obtenerlas mediante pull desde el servidor mediante el mandato anterior. El archivo .zip se almacena en la carpeta [directorio raíz]/mobilefirst del proyecto, y se puede utilizar más tarde con mfpdev app push para subirlo a otras instancias de MobileFirst Server, permitiendo una puesta a punto y configuración rápida mediante la reutilización de una configuración predefinida.

Gestión y realización de pruebas con adaptadores

Puede gestionar los adaptadores con el mandato mfpdev adapter <option>.

Para obtener más información sobre los adaptadores consulte las guías de aprendizaje de la categoría Adaptadores.

Creación de un adaptador

Para crear un nuevo adaptador, utilice el mandato

mfpdev adapter create

Responda a las solicitudes para informar sobre el nombre, el tipo y el ID de grupo del adaptador

Compilación de un adaptador

Para compilar un adaptador, ejecute el siguiente mandato desde la carpeta raíz del adaptador:

mfpdev adapter build

De esta forma generará un archivo .adapter en la carpeta **/target**.

Despliegue de un adaptador

El siguiente mandato desplegará el adaptador en el servidor predeterminado:

mfpdev adapter deploy

Para desplegarlo en un servidor diferente, utilice:

mfpdev adapter deploy <server_name>

Llamada a un adaptador desde la línea de mandatos

Después de que se despliegue un adaptador es posible llamarlo desde la línea de mandatos para probar su comportamiento con el mandato:

mfpdev adapter call

Se le solicitará informar del adaptador, el procedimiento y los parámetros a utilizar. La salida del mandato será la respuesta del procedimiento del adaptador.

Obtenga más información en la guía de aprendizaje Pruebas y depuración de adaptadores.

Mandatos de utilidad

Utilice el siguiente mandato para establecer las preferencias de la interfaz de línea de mandatos (CLI) de mfpdev como, por ejemplo, el navegador predeterminado y la modalidad de vista previa predeterminada:

mfpdev config

Para ver el contenido de ayuda que describe todos los mandatos de mfpdev, utilice:

mfpdev help

El siguiente mandato generará una lista con información sobre el entorno:

mfpdev info

Para imprimir la versión de la CLI de mfpdev, utilice:

mfpdev -v

Actualización y desinstalación de la interfaz de línea de mandatos

Ejecute el siguiente mandato para actualizar la interfaz de línea de mandatos:

npm update -g mfpdev-cli

Ejecute el siguiente mandato para desinstalar la interfaz de línea de mandatos:

npm uninstall -g mfpdev-cli