react-native-lock-task

react-native-lock-task

Getting started

$ npm install react-native-lock-task --save

Mostly automatic installation

$ react-native link react-native-lock-task

Settings

yourProject/android/app/src/main/AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.yourProject">
+   <uses-permission android:name="android.permission.MANAGE_DEVICE_ADMINS" />
+   <uses-permission android:name="android.permission.DISABLE_KEYGUARD" />
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
+       android:launchMode="singleTask"
+       android:stateNotNeeded="true">

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
+               <category android:name="android.intent.category.HOME" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

+       <receiver android:name="com.rnlocktask.MyAdmin"
+           android:label="@string/sample_device_admin"
+           android:description="@string/sample_device_admin_description"
+           android:permission="android.permission.BIND_DEVICE_ADMIN">
+           <meta-data android:name="android.app.device_admin"
+               android:resource="@xml/my_admin" />
+           <intent-filter>
+               <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
+           </intent-filter>
+       </receiver>
    </application>
</manifest>

yourProject/android/app/src/main/res/values/strings.xml

<resources>
    <string name="app_name">yourNameApp</string>
+   <string name="sample_device_admin">yourNameApp</string>
+   <string name="sample_device_admin_description">yourNameAppTitle</string>
</resources>

yourProject/android/app/src/main/res/xml/my_admin.xml

+ <device-admin xmlns:android="http://schemas.android.com/apk/res/android">
+     <uses-policies>
+         <limit-password />
+         <watch-login />
+         <reset-password />
+         <force-lock />
+         <wipe-data />
+     </uses-policies>
+ </device-admin>

Add the library types to your project by creating (or editing) a index.d.ts in your project root directory with the line:

declare module 'react-native-lock-task';

and then add it to your tsconfig.json

{
  ...
  "include" : ["index.d.ts"]
}

Reinstall application

• Start your emulator
• Install project

Set owner device adb

• Settings --> Accounts --> Delete All
• adb shell dpm set-device-owner com.yourProject/com.rnlocktask.MyAdmin

Usage

import RNLockTask from 'react-native-lock-task';
RNLockTask.isAppInLockTaskMode();
RNLockTask.startLockTask();
RNLockTask.startLockTaskWith(["com.google.android.youtube", "com.sega.sonicdash"]);
RNLockTask.stopLockTask();
RNLockTask.clearDeviceOwnerApp();