README

react-native-android-appcheck

Tool to check for install status of apps on Android

Why?

Linking.canOpenURL works well for "Deep Links" with custom schema (e.g. exampleapp://), however it is less useful when an app only implements "App Links" with domain verification (i.e. android:autoVerify="true"). See this Android documentation page: https://developer.android.com/training/app-links/verify-site-associations#the-difference

Since a browser is capable of opening general HTTPS URLs, Linking.canOpenURL('https://applink.exampleapp.com') will always return true, whether or not "exampleapp" is installed.

One real-world example of this is Apple Music on Android. On iOS, the music:// schema can be queried for, but on Android (>= 6.0), only an "app link" is available. In this case, custom schemas are present, but the autoVerify attribute 'locks' the intent-filter to the https domains. Android versions lower than 6.0 are probably still able to query for the custom schemes (autoVerify implemented in 6.0/Marshmallow).

Status

Android:
- Testing functionality
iOS:
- No support planned
react-native:
- supported versions ">= 0.60.5"

Installation

with react-native ">=0.60.5"

0. Setup Swift and Kotlin

Modify android/build.gradle:

buildscript {
  ext {
    ...
+   kotlinVersion = "1.3.50"
  }
...

  dependencies {
+   classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlinVersion}")
    ...

1. Install latest version from npm

$ npm i react-native-android-appcheck -S

Demo

Android	iOS
???	???

Example

import checkPackage from 'react-native-android-appcheck'

(async function() {
  const isInstalled = await checkPackage('com.chat.fakeapp');
  console.log(`App is installed: ${isInstalled}`);
}());

Reference

prop	type	default	desc
packageName	`string`	none	Android package name

Usage no npm install needed!