Adición del SDK de MobileFirst Foundation a aplicaciones React Native

improve this page | report issue

Visión general

En esta guía de aprendizaje, aprenderá a añadir el SDK de MobileFirst a una aplicación React Native nueva o existente, creada con la CLI de React Native. También aprenderá a configurar MobileFirst Server para que reconozca la aplicación, y a buscar información sobre los archivos de configuración de MobileFirst que se cambian en el proyecto.

El SDK de MobileFirst React Native se proporciona como un plug-in de npm de react native, que se registra en NPM.

Los plugins disponibles son:

  • react-native-ibm-mobilefirst - El plug-in de SDK de núcleo

Ir a:

Componentes del SDK de React Native

react-native-ibm-mobilefirst

El plug-in react-native-ibm-mobilefirst es el plug-in de MobileFirst central para React Native y es necesario. Si instala cualquier otro plug-in de MobileFirst, también se instala automáticamente el plug-in react-native-ibm-mobilefirst en el caso de que todavía no lo esté.

Requisitos previos:

Adición del SDK de Mobile Foundation React Native

Siga las instrucciones siguientes para añadir el SDK de Mobile Foundation React Native a un proyecto nuevo o existente de React Native, y regístrelo en MobileFirst Server.

Antes de empezar, asegúrese de que MobileFirst Server está en ejecución.

Si está utilizando un servidor instalado localmente: Desde una ventana de línea de mandatos, vaya a la carpeta del servidor y ejecute el mandato: ./run.sh.

Adición del SDK

Nueva aplicación

  1. Crear un proyecto de React Native: react-native init projectName.
    Por ejemplo:

    react-native init Hello
    
    • Hello es el nombre de carpeta y el nombre de la aplicación.

    El archivo index.js de la plantilla permite utilizar características de MobileFirst adicionales como, por ejemplo, la traducción de aplicación multilingüe y opciones de inicialización (consulte la documentación del usuario para obtener más información).

  2. Cambie el directorio a la raíz del proyecto de React Native: cd hello

  3. Añada los plug-ins de MobileFirst utilizando el mandato de la CLI de NPM: npm install react-native-plugin-name Por ejemplo:

    npm install react-native-ibm-mobilefirst
    

    El mandato anterior añade el plug-in del SDK de MobileFirst Core al proyecto de React native.

  4. Enlace las bibliotecas del plugin ejecutando el mandato:

    react-native link
    

Aplicación existente

  1. Vaya a la raíz de su proyecto React Native existente y añada el plug-in de React Native central de MobileFirst:

    npm install react-native-ibm-mobilefirst
    
  2. Enlace las bibliotecas del plugin ejecutando el mandato:

    react-native link
    

Registro de la aplicación

  1. Abra una ventana Línea de mandatos y vaya a la raíz de la plataforma en concreto (iOS o Android) del proyecto.

  2. Registre la aplicación en MobileFirst Server:

    mfpdev app register
    
  • iOS:

    Si su plataforma es iOS, se le solicitará que proporcione el BundleID de la aplicación. Importante: El BundleID es sensible a las mayúsculas y minúsculas.

    El mandato de interfaz de línea de mandatos (CLI) mfpdev app register se conecta primero al MobileFirst Server para registrar la aplicación, a continuación genera el archivo mfpclient.plist en la raíz del proyecto Xcode y le añade los metadatos que identifican al MobileFirst Server.

  • Android:

    Si su plataforma es Android, se le solicitará que proporcione el nombre del paquete de la aplicación. Importante: El nombre de paquete es sensible a las mayúsculas y minúsculas.

    El mandato de la CLI mfpdev app register se conecta primero al MobileFirst Server para registrar la aplicación y después genera el archivo mfpclient.properties en la carpeta [raíz proyecto]/app/src/main/assets/ del proyecto Android Studio y para añadirlo en los metadatos que identifican al MobileFirst Server.

Si se utiliza un servidor remoto, utilice el mandato mfpdev server add para añadirlo.

El mandato de CLI mfpdev app register primero se conecta al MobileFirst Server para registrar la aplicación. Cada plataforma se registra como una aplicación en MobileFirst Server.

Sugerencia: También es posible registrar aplicaciones desde MobileFirst Operations Console:

  1. Cargue MobileFirst Operations Console.
  2. Pulse el botón Nuevo junto a Aplicaciones para registrar una nueva aplicación y seguir las instrucciones en la pantalla.

Actualización del SDK de MobileFirst React Native

Para actualizar el SDK de MobileFirst React native con el último release, elimine el plug-in react-native-ibm-mobilefirst: ejecute el mandato npm uninstall react-native-ibm-mobilefirst y, a continuación, ejecute el mandato npm install react-native-ibm-mobilefirst para añadirlo de nuevo.

Los releases de SDK se pueden encontrar en el repositorio NPM de SDK.

Artefactos generados del SDK de MobileFirst React Native

Entorno Android

mfpclient.properties

Ubicado en la carpeta ./app/src/main/assets/ del proyecto Android Studio, este archivo define las propiedades utilizadas del lado del cliente para registrar su aplicación Android en MobileFirst Server.

Propiedad Descripción Valores de ejemplo
wlServerProtocol Protocolo de comunicación con MobileFirst Server. http o https
wlServerHost Nombre de host de MobileFirst Server. 192.168.1.63
wlServerPort Puerto de MobileFirst Server. 9080
wlServerContext Vía de acceso de raíz de contexto de la aplicación en MobileFirst Server. /mfp/
languagePreferences Establece el idioma predeterminado para los mensajes de sistema del SDK de cliente. en

Entorno iOS

mfpclient.plist

Ubicado en la raíz del proyecto, este archivo define las propiedades del lado del cliente utilizadas para registrar la aplicación iOS en MobileFirst Server.

Propiedad Descripción Valores de ejemplo
protocol Protocolo de comunicación con MobileFirst Server. http o https
host Nombre de host de MobileFirst Server. 192.168.1.63
port Puerto de MobileFirst Server. 9080
wlServerContext Vía de acceso de raíz de contexto de la aplicación en MobileFirst Server. /mfp/
languagePreferences Establece el idioma predeterminado para los mensajes de sistema del SDK de cliente. en

Guías de aprendizaje con las que continuar

Con el SDK de MobileFirst React Native ahora integrado, podrá:

Last modified on October 03, 2018