Integrar con React Native CLI
En el desarrollo de aplicaciones mĂłviles con React Native, a menudo surge la necesidad de mostrar contenido web dentro de la aplicaciĂłn. Para lograr esto, existen varias opciones, entre las cuales se destacan el uso de Custom Tabs (para Android) y Safari View Controller (para iOS). Estas tecnologĂas permiten abrir pĂĄginas web en un navegador nativo integrado en la aplicaciĂłn, brindando una experiencia de navegaciĂłn mĂĄs fluida y coherente para los usuarios.
En este paso vamos a instalar y configurar las dependencias necesarias para implementar Safari View Controller en tu proyecto desarrollado en React Native.
Uso de InAppBrowser
Client-Side
Con React Native CLI, te sugerimos usar React-Native-InAppBrowser, una dependencia altamente flexible que brinda una soluciĂłn completa para integrar un navegador web dentro de tu aplicaciĂłn de React Native. Al considerar el uso de React-Native-InAppBrowser-Reborn se tuvieron en cuenta los siguientes aspectos:
- Es una dependencia que permite brindar una experiencia de navegaciĂłn web integrada y fluida dentro de la aplicaciĂłn.
- Cuenta con una gran variedad de funciones personalizables para adaptarse a las necesidades especĂficas de la aplicaciĂłn.
- Mantiene a los usuarios dentro del contexto de la aplicaciĂłn, aumentando la retenciĂłn y la coherencia de la experiencia.
Para instalarla, ejecuta el siguiente comando en tu terminal.
npm install react-native-inappbrowser-reborn --save
yarn add react-native-inappbrowser-reborn
Luego, ejecuta el siguiente comando para instalar la dependencia.
plain
cd ios && pod install && cd ..
ImplementaciĂłn de React-Native-Inappbrowser
Client-Side
Para implementar la dependencia React-Native-Inappbrowser, sigue el ejemplo que mostramos a continuaciĂłn.
JavaScript
import {
Button,
Linking
} from 'react-native';
import InAppBrowser from 'react-native-inappbrowser-reborn';
const ButtonCustomTabs = () => {
const openUrl = async (url) => {
if (await InAppBrowser.isAvailable()) {
InAppBrowser.open(url, {
// iOS Properties
dismissButtonStyle: 'cancel',
preferredBarTintColor: '#453AA4',
preferredControlTintColor: 'white',
readerMode: false,
animated: true,
modalEnabled: true,
// Android Properties
showTitle: true,
toolbarColor: '#6200EE',
secondaryToolbarColor: 'black',
enableUrlBarHiding: true,
enableDefaultShare: true,
forceCloseOnRedirection: false, // Animation
animations: {
startEnter: 'slide_in_right',
startExit: 'slide_out_left',
endEnter: 'slide_in_left',
endExit: 'slide_out_right',
},
});
} else {
Linking.openURL(url);
}
};
return ( < Button title = "Press Me"
onPress = {
() =>
openUrl('https://url-to-open.com')
}
/> );
};
export default ButtonCustomTabs;
CĂłmo volver a tu App
Client-Side
Los Deep Links, tambiĂ©n conocidos como enlaces profundos, son una forma poderosa de permitir la navegaciĂłn directa a pantallas o secciones especĂficas de una aplicaciĂłn mĂłvil.
Crear un Deep Link
Desde nuestro checkout es posible configurar Deep Links para volver a tu aplicaciĂłn, ya sea haciendo click en un link de âVolverâ, o de forma automĂĄtica al terminar todo un flujo de pago exitoso, para luego ser redirigido a tu App.
Para esto debemos agregar en la creaciĂłn de la preferencia de pago las propiedades back_urls
y auto_return
segĂșn corresponda.
Para conocer mĂĄs, puedes acceder a la documentaciĂłn de URLs de retorno.
ConfiguraciĂłn de la aplicaciĂłn para la gestiĂłn del Deep Link
Client-Side
Para poder recibir y gestionar el Deep Link, deberĂĄs configurar en tu proyecto de React Native el scheme y path que componen los Deep Links que recibiste para redireccionar a alguna parte de tu aplicaciĂłn. Para ello, desde Xcode ubĂcate en la informaciĂłn de tu proyecto y agrega una nueva "URL Types".
Ingresa el identifier de su aplicaciĂłn y la URL Schemes del Deep Link.
Esto generarĂĄ el siguiente cĂłdigo en el archivo ios/appname/Info.plist:
info.plist
<key>CFBundleURLTypes</key>
<array>
<dict> <key>CFBundleURLSchemes
</key>
<array>
<string>myapp</string>
<string>com.test.TestExpoBrowser</string>
</array>
</dict>
</array>
Agrega el siguiente cĂłdigo al archivo ios/appname/AppDelegate.mm
AppDelegate.mm
// iOS 9.x or newer
#import < React / RCTLinkingManager.h >
-(BOOL) application: (UIApplication * ) application
openURL: (NSURL * ) url options: (NSDictionary < UIApplicationOpenURLOptionsKey, id > * ) options {
return [RCTLinkingManager application: application openURL: url options: options];
}
RecepciĂłn y gestiĂłn del Deep Link
Client-Side
Por Ășltimo, veremos cĂłmo podemos configurar nuestra aplicaciĂłn de React Native para recibir y gestionar los Deep Links. Esto se abordarĂĄ usando la dependencia react-native-inappbrowser.
En el caso de iOS es necesario cerrar Safari View Controller de manera manual. Para esto, deberås escuchar el evento de cuando cambia la url desde el componente que abre la ventana o el punto de entrada de la aplicación, y luego llamar el método para cerrar Safari View Controller.
Uso de react-native-inappbrowser-reborn
Sigue el siguiente ejemplo para cerrar Safari View Controller manualmente utilizando react-native-inappbrowser-reborn.
JavaScript
import {
useEffect
} from 'react';
import React from 'react';
import MainStack from './navigation/MainStack';
import {
Linking
} from 'react-native';
import InAppBrowser from 'react-native-inappbrowser-reborn';
import * as RootNavigation from './RootNavigation';
function App(): JSX.Element {
useEffect(() => {
Linking.addEventListener('url', event => {
const {
url
} = event;
if (url !== null && url.includes('myapp://')) {
InAppBrowser.close();
RootNavigation.navigate('Congrats');
}
});
}, []);
return <MainStack / > ;
}
export default App;