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>
}