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

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
Adición del SDK de MobileFirst React Native
Actualización del SDK de MobileFirst React Native
Artefactos generados del SDK de MobileFirst React Native
Guías de aprendizaje con las que continuar

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:

CLI de React Native y MobileFirst CLI están instalados en la estación de trabajo del desarrollador.
Una instancia remota o local de MobileFirst Server que esté en ejecución.
Lea las guías de aprendizaje Configuración del entorno de desarrollo de MobileFirst y Configuración del entorno de desarrollo de React Native.

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

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).
Cambie el directorio a la raíz del proyecto de React Native: cd hello
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.
Enlace las bibliotecas del plugin ejecutando el mandato:
```
react-native link
```
Nota: Este mandato no es necesario desde react-native 0.60
Solo para iOS, instale las dependencias de Mobilefirst Pod
```
cd ios && pod install
```

Aplicación existente

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
```
Enlace las bibliotecas del plugin ejecutando el mandato:
```
react-native link
```
Nota: Este mandato no es necesario desde react-native 0.60
Solo para iOS, instale las dependencias de Mobilefirst Pod
```
cd ios && pod install
```

Registro de la aplicación

Abra una ventana Línea de mandatos y vaya a la raíz de la plataforma en concreto (iOS o Android) del proyecto.
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:

Cargue MobileFirst Operations Console.

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á:

Revisar las guías de aprendizaje de Utilización de Mobile Foundation SDK
Revisar las guías de aprendizaje de Desarrollo de adaptadores
Revisar las guías de aprendizaje de Autenticación y seguridad
Revisar las guías de aprendizaje de Notificaciones
Revisar Todas las guías de aprendizaje

▲

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.

Last modified on February 27, 2020