React Native Linking 基本用法封装

Linking提供了一个通用的接口来与传入和传出的 App 链接进行交互

背景

  • 官方文档
  • 在App开发中我们经常会用到Linking跳转,如:跳转应用市场,拨打手机号,打开微信等等。
  • 下面针对这些需求进行了基本的封装。

跳转App应用市场

/**
 * app应用市场下载
 * iOS: itms-apps://itunes.apple.com/cn/app/  +【名称】/【id + id编号】 如:itms-apps://itunes.apple.com/cn/app/wei-xin/id414478124
 * android: market://details?id= + 【app 包名】 如: market://details?id=com.tencent.mm
 * @param {*} address 下载地址
 */
export const openMarket = ({ androidAddress = '', iOSAddress = '' }) => {
  const linkingUrl = Platform.OS === 'ios' ? `itms-apps://itunes.apple.com/cn/app/${iOSAddress}` : `market://details?id=${androidAddress}`
  Linking.canOpenURL(linkingUrl).then(async supported => {
    if (supported) {
      Linking.openURL(linkingUrl)
    } else {
      Toast.show('找不到可提供下载的应用市场')
    }
  })
}

拨打手机号

/**
 * 拨打手机
 * @param {*} tel 手机号
 */
export const openTel = (tel) => {
  Linking.canOpenURL(`tel:${tel}`).then(async supported => {
    if (supported) {
      Linking.openURL(`tel:${tel}`)
    } else {
      await Clipboard.setString(tel)
      Toast.show('您的设备不支持,已为您复制手机号!')
    }
  })
}

打开微信

export const openWechat = () => {
 Linking.canOpenURL('weixin://').then(supported => {
   if (supported) {
     Linking.openURL('weixin://')
   } else {
     Alert.alert('没有安装微信',
       '请先安装微信客户端再打开',
       [
         { text: '取消' },
         { text: '安装',
           onPress: () => {
             openMarket({
               androidAddress: 'com.tencent.mm',
               iOSAddress: 'wei-xin/id414478124'
             })
           } }
       ])
   }
 })
}

浏览器打开链接

/**
 * 打开浏览器
 * @param {*} url url地址
 */
export const openWebBrowser = (url) => {
  Linking.canOpenURL(url).then(supported => {
    if (supported) {
      Linking.openURL(url)
    } else {
      Toast.show('找不到可以打开的浏览器')
    }
  })
}

React Navigation深度链接

  • 结合React Navigation我们可以打开App并跳转到App任何界面
  • 应用场景:用户点击推送消息,打开App并跳转到消息详情界面。
  • 假设App中我们有OrderDetailScreen这个界面,router配置如下:
const mainNavigator = createStackNavigator({
....
  order_detail: {
    screen: OrderDetailScreen,
    path: 'order_detail'
  }
....
  • 我们可以使用以下命令跳转到详情页面
return Linking.canOpenURL('myapp://main/order_detail').then(supported => {
        if (!supported) {
          console.log('Can\'t handle url: myapp://main/order_detail')
        } else {
          return Linking.openURL('myapp://main/order_detail/' + data.money)
        }
      }).catch(err => console.error('An error occurred', err))

常用URL Scheme

/**
  一、常用URL Scheme
    QQ: mqq://
    微信: weixin://
    新浪微博: weibo:// (sinaweibo://)
    腾讯微博: tencentweibo://
    淘宝: taobao://
    支付宝: alipay://
    美团: imeituan://
    知乎: zhihu://
    优酷: youku://
  二、配置Scheme白名单(仅ios,Android平台不需要)
    在项目的info.plist中添加一LSApplicationQueriesSchemes,类型为Array。
    添加需要支持的项目,类型为字符串类型;
 */
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容