react-native-openanything

Open anything in your react-native app.

Supports call, email, text (sms), iMessage (iOS only), Map, PDF, etc.

Installation

React Native >= 0.49

npm install react-native-openanything

General Guide

This library is promise based and each method returns a promise.

    import {Call} from 'react-native-openanything';

    Call('+155555555555').catch(err => console.error(err));

Available Methods

Call a number from your app!

Call(phone, prompt = false)

Prop	Description	Default
phone	A string that represents the phone number to call.	Required
prompt	If set to true, it will ask the user for permission to call. Only iOS	false

---

Send an email from your app!

Email(to = false, subject = false, body = false, cc = false, bcc = false)

Parameter	Description	Default
to	A value that indicates the recipient e-mail. Can either be string for single recipient or an array for multiple recipients.	false optional
subject	A string for the subject for the e-mail.	false optional
body	A string for the body message for the e-mail.	false optional
cc	Same as to however the recipient(s) will be designated for the cc field.	false optional
bcc	Same as to however the recipient(s) will be designated for the bcc field.	false optional

Note: The default email application will be open even if no parameter is set.

---

Send an text (sms) from your app!

Text(phone, message = false, autoEncode = true)

Parameter	Description	Default
phone	A string that represents the phone number to call.	Required
message	A string for the message.	false optional
autoEncode	If set to true, the method will auto encode the message.	true optional

By default this method tries to properly encode the message however in same cases that might not work. If you have trouble just set the autoEncode parameter to false.

Note: If message is not a string, this method will open the default text client regardless.

---

Open any URL from your app!

Web(url)

Parameter	Description	Default
url	A string that represents the url.	Required

---

Displays a map from your app!

Map(address)

Parameter	Description	Default
address	A string that represents the address.	Required

Note: You can either provide an string or an array with latitude and longitude to this method.

---

Opens a YouTube Video

Youtube(video)

Parameter	Description	Default
video	A string that contains the Youtube video id.	Required

---

Opens Twitter

Twitter(user)

Parameter	Description	Default
user	A string that contains the Twitter User Id that should be open.	Required

---

Opens Facebook

Facebook(user)

Parameter	Description	Default
user	A string that contains the Facebook User Id that should be open.	Required

---

Opens Instagram User, Media, Camera, App, Location and Tag

Instagram(user)

Parameter	Description	Default
user	A string that contains the Instagram User Id that should be open.	Required

InstagramMedia(media)

Parameter	Description	Default
user	A string that contains the Instagram Media Id that should be open.	Required

InstagramLocation(location)

Parameter	Description	Default
user	A string that contains the Instagram Location Id that should be open.	Required

InstagramTag(tag)

Parameter	Description	Default
user	A string that contains the Instagram Tag Id that should be open.	Required

InstagramApp()

Opens the Instagram App.

InstagramCamera()

Opens the Instagram Camera.

---

Only iOS Launch Facetime

Facetime(target, audioOnly = false)

Parameter	Description	Default
target	A string that representing a phone number or a username.	Required
audioOnly	A boolean value indicating if facetime is an audio call	false optional

Low level methods

Note: You should only use these methods if you know what you doing.

---

Supported - checks if a deep linking URL is supported on the current device.

Supported(url)

Parameter	Description	Default
url	The url to check.	Required

---

Open - opens an deep linking URL.

Open(url)

Parameter	Description	Default
url	The url to open.	Required

---

Launch - Combines Supported and Open

Launch(url)

Parameter	Description	Default
url	The url to verify and open.	Required

---

Issues and how to resolve them

App is not allowed to query scheme

On iOS you might run into this issue. The reaon is that you have to explicit add the requesting query schemes into the pinfo.list variable LSApplicationQueriesSchemes.

e.g. for Facebook you would add fb. Please refer to the example list below for the correct query scheme string:

Target	Query Scheme
Facebook	fb
Instagram	instagram
Twitter	twitter
LinkedIn	linkedin
WhatsApp	whatsapp

Examples

You can either import specific modules:

import { Call, Text, Web, Map, EMail } from 'react-native-openanything';

...

render() {

	<View>
    	<Button onPress={() => Call('+12105551234')}>
        	<Text>Call</Text>
        </Button>
        <Button onPress={() => Text('+12105551234', 'Can you please call me!')}>
        	<Text>Text</Text>
        </Button>
    </View>
}

or import all modules as wildcard:

import * as OpenAnything from 'react-native-openanything';

...

render() {

	<View>
    	<Button onPress={() => OpenAnything.Call('+12105551234')}>
        	<Text>Call</Text>
        </Button>
        <Button onPress={() => OpenAnything.Call('+12105551234', 'Can you please call me!')}>
        	<Text>Text</Text>
        </Button>
        <Button onPress={() => OpenAnything.Email('[email protected]')}>
        	<Text>E-Mail</Text>
        </Button>
        <Button onPress={() => OpenAnything.Web('http://www.google.com')}>
        	<Text>Google Homepage</Text>
        </Button>
        <Button onPress={() => OpenAnything.Map('Google')}>
        	<Text>Google HQ</Text>
        </Button>
    </View>
}