Neocon Propaganda Machine

    @theankur/react-native-keep-awake
    TypeScript icon, indicating that this package has built-in type declarations

    0.0.1 • Public • Published

    DEPRECATION NOTICE

    This package has been deprecated in favor of https://www.npmjs.com/package/expo-keep-awake. That package does everything this one does and is maintained by the excellent Expo team.

    END DEPRECATION NOTICE

    This React Native package allows you to prevent the screen from going to sleep while your app is active. It's useful for things like navigation or video playback, where the user expects the app to remain visible over long periods without touch interaction.

    Installation

    As the first step, install this module:

    React Native 0.57+

    npm install --save react-native-keep-awake
    

    React Native 0.56 and below

    v4 of this module targets gradle 3 syntax, which is not available by default for React Native v0.56 and below. If you are targeting an older version of React Native, stick to v3 of this module:

    npm install --save react-native-keep-awake@3
    

    RNPM

    The plugin can be installed using react-native link on both iOS and Android. Once installed with npm, just run:

    react-native link react-native-keep-awake
    

    Manual install

    iOS

    1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
    2. Go to node_modulesreact-native-keep-awake and add KCKeepAwake.xcodeproj
    3. In XCode, in the project navigator, select your project. Add libKCKeepAwake.a to your project's Build PhasesLink Binary With Libraries
    4. Click KCKeepAwake.xcodeproj in the project navigator and go the Build Settings tab. Make sure 'All' is toggled on (instead of 'Basic'). In the Search Paths section, look for Header Search Paths and make sure it contains both $(SRCROOT)/../../react-native/React and $(SRCROOT)/../../../React - mark both as recursive.

    Android

    1. Open up `android/app/src/main/java/[...]/MainApplication.java (React Native 0.29+)
    • Add import com.corbt.keepawake.KCKeepAwakePackage; to the imports at the top of the file
    • Add new KCKeepAwakePackage() to the list returned by the getPackages() method
    1. Append the following lines to android/settings.gradle:
    include ':react-native-keep-awake'
    	project(':react-native-keep-awake').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-keep-awake/android')
    1. Insert the following lines inside the dependencies block in android/app/build.gradle:
    compile project(':react-native-keep-awake')

    Usage

    There are two ways to use this package: by rendering it as a component, or by explicitly calling the KeepAwake.activate() and KeepAwake.deactivate() static methods. Both are demonstrated below.

    import React, { Component } from 'react';
    import { View, Text } from 'react-native';
    
    import KeepAwake from 'react-native-keep-awake';
    
    // Method 1
    class MyComponent extends Component {
      render() {
        if (this.props.screenShouldBeAwake) {
          return (
            <View>
              <Text>Screen will be kept awake</Text>
              <KeepAwake />
            </View>
          )
        } else {
          return (
            <View>
              <Text>Screen can sleep</Text>
            </View>
          );
        }
      }
    }
    
    // Method 2
    function changeKeepAwake(shouldBeAwake) {
      if (shouldBeAwake) {
        KeepAwake.activate();
      } else {
        KeepAwake.deactivate();
      }
    }

    In method 1, the screen will be locked awake when the <KeepAwake /> component is mounted, and the lock will be disabled when the component is unmounted. Method 2 gives you more explicit control of when the lock is active or not.

    Install

    npm i @theankur/react-native-keep-awake

    DownloadsWeekly Downloads

    1

    Version

    0.0.1

    License

    MIT

    Unpacked Size

    26.5 kB

    Total Files

    15

    Last publish

    Collaborators

    • theankur