Linking Native API

Introduction

Linking API enables you to both send and receive links between applications. For example, opening the Phone app with number dialed in or opening the Google Maps and starting a navigation to a chosen destination. You can also utilise Linking to make your app able to respond to links opening it from other applications.

To use Linking you need to first import it from react-native

import {Linking} from 'react-native'

You can detect when your app is launched from an external URL.

componentDidMount() {
  const url = Linking.getInitialURL()
  .then((url) => {
    if (url) {
      console.log('Initial url is: ' + url)
    }
  }).catch(err => console.error('An error occurred ', err))
}

To enable this on iOS Link RCTLinking to your project.

To enable this on Android, follow these steps.

To open a link call openURL.

Linking.openURL(url)
.catch(err => console.error('An error occurred ', err))

The preferred method is to check if any installed app can handle a given URL beforehand.

Linking.canOpenURL(url)
.then(supported => {
  if (!supported) {
    console.log('Unsupported URL: ' + url)
  } else {
    return Linking.openURL(url)
  }
}).catch(err => console.error('An error occurred ', err))

URI Schemes

Target AppExampleReference
Web Browserhttps://stackoverflow.com
Phonetel:1-408-555-5555Apple
Mailmailto:email@example.comApple
SMSsms:1-408-555-1212Apple
Apple Mapshttp://maps.apple.com/?ll=37.484847,-122.148386Apple
Google Mapsgeo:37.7749,-122.4194Google
iTunesSee iTunes Link MakerApple
Facebookfb://profileStack Overflow
YouTubehttp://www.youtube.com/v/oHg5SJYRHA0Apple
Facetimefacetime://user@example.comApple
iOS Calendarcalshow:514300000 [1]iPhoneDevWiki

[1] Opens the calendar at the stated number of seconds since 1. 1. 2001 (UTC?). For some reason this API is undocumented by Apple.