最近,我尝试实现在 React Native APP 中调用浏览器打开链接的功能,现记录一下实现过程。
React Native 的 Linking API 提供了一个通用的接口来与传入和传出的 App 链接进行交互,例如浏览器。
如果要在 App 启动后也监听传入的 App 链接
1. Linking Libraries (iOS) - RCTLinking
在 node_modules/Libraries/LinkingIOS 中找到 RCTlinking.xcodeproj,拖到 XCode 工程下的 Libraries 分组里(参考 Linking Libraries - Manual linking)
如果XCode 工程下的 Libraries 分组里已经有 RCTlinking.xcodeproj,就不需要再加了。
2 AppDelegate.m 文件中添加
// 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];}
// iOS 8.x or older#import <React/RCTLinkingManager.h>- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{ return [RCTLinkingManager application:application openURL:url sourceApplication:sourceApplication annotation:annotation];}
// Universal Links- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler{ return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler];}
使用 Linking
import { Linking } from 'react-native'
如果 APP 被其注册过的外部 url 调起
componentDidMount() { Linking.getInitialURL().then((url) => { if (url) { console.log('Initial url is: ' + url); } }).catch(err => console.error('An error occurred', err));}
监听事件
componentDidMount() { Linking.addEventListener('url', this._handleOpenURL);},componentWillUnmount() { Linking.removeEventListener('url', this._handleOpenURL);},_handleOpenURL(event) { console.log(event.url);}
打开链接 url
如果系统不知道如何处理给定的 URL,则{@code openURL}方法会调用失败。如果你传入的 URL 不是一个 http 链接,则最好先通过{@code canOpenURL}方法检查一下。对于 web 链接来说,协议头("http://", "https://")不能省略!
Linking.openURL(url).catch((err) => console.error('An error occurred', err));
Linking.canOpenURL(url) .then((supported) => { if (!supported) { console.log("Can't handle url: " + url); } else { return Linking.openURL(url); } }) .catch((err) => console.error('An error occurred', err));