Jagerfield/Android-Utilities-Library

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.Jagerfield:android-Utilities-Library:v3.0'
	}

	dependencies {
		implementation("com.github.Jagerfield:android-Utilities-Library:v3.0")
	}

	<dependency>
	    <groupId>com.github.Jagerfield</groupId>
	    <artifactId>android-Utilities-Library</artifactId>
	    <version>v3.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.Jagerfield" % "android-Utilities-Library" % "v3.0"


                            
    :dependencies [[com.github.Jagerfield/android-Utilities-Library "v3.0"]]

Readme

Android Utilities Library

While developing Andorid apps, I gathered the functions that I repeatedly used and kept them in a utility class. The number of these functions grew, in addition there was need to manage the “Permissions” in a clean easy way. Therefore, I created a library which currently provides the following utilities: Permissions, Memory, Battery, Device Info, Network, SoftKeyboard.

The Permissions utility can be used for SDK versions 15-25 check.
If the SDK version is < 23, then it will check for the existance of the permission in the Manifest.
The library utilities' functions will return the name of the missing permission.

The images below are taken from running the app on a simulator.

The sample app for Android Utilities Library is available on Google Play:

Library Installation

In the app build.gradle add the following:

Add JitPack repository at the end of repositories

repositories
{
   maven { url 'https://jitpack.io' }
}

Add the following dependency

dependencies
{
   compile ('com.github.Jagerfield:Android-Utilities-Library:v3.0') {
      exclude group: 'com.android.support' }
}

##Checking Permissions To test the Permissions utility:

1. Image 1
   a.In Settings->Apps->Android Utilities->App info->Permissions turn all the permission switches off.
2. Image 2-3
   a.In the first tab "Permissions".
   b.Click on "Check Permissions" button.
   c.And deny all permissions.
3. Image 4
   a.Click on "Get" button.
   b.Deny the first two permissions.
   c.For the last two permissions, check the boxes "Never Show Again", then deny them.
4. Image 5
   a.Click on "Get" button, and accept the two permissions showing in the denied permissions section.
5. Image 5
   a.Click then on the "Settings" button.
6. Image 6
   a.Go to the app permissions, switch all permissions on.
7. Image 7
   a.Click on "Check Permissions" button and check the final status.

##Permissions Util

PermissionsUtil contains the following functions:

IGetPermissionResult contains the following functions:

Managing permissions

First, check the status of your app permissions. The functions (getPermissionResults) and (requestPermissions) can either take an array or a string as an argument.

  PermissionsUtil permissionsUtil = AppUtilities.getPermissionUtil(activity);
  IGetPermissionResult result = permissionsUtil.getPermissionResults(PERMISSIONS_ARRAY);

        if (result.isGranted())
        {
            //Add your code here
        }
        else if (!result.isGranted() && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M)
        {
            //There are missing permissions ask for them
            permissionsUtil.requestPermissions(PERMISSIONS_ARRAY);
        }
        else if (!result.isGranted() && Build.VERSION.SDK_INT < Build.VERSION_CODES.M)
        {
            //For SDK less than M, there are permissions missing in the manifest
            String missingPermissions = TextUtils.join(", ", result.getMissingInManifest_ForSdkBelowM()).trim();
            Toast.makeText(activity, "Following permissions are missing : " + missingPermissions, Toast.LENGTH_LONG).show();
            Log.e(C.TAG_LIB, "Following permissions are missing : " + missingPermissions);
        }

The function (requestPermissions) in the previous paragraph will call the (checkSelfPermission), and the user will get to choose to accept or deny permissions. The system will then make a callback in (onRequestPermissionsResult) in the MainActivity.

    @Override
    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults)
    {
        PermissionsUtil permissionsUtil = AppUtilities.getPermissionUtil(activity);

          if (requestCode == permissionsUtil.getPermissionsReqCodeId())
          {
             IGetPermissionResult result = null;
             result = permissionsUtil.getPermissionResults(permissions);

             if (result == null) { return; }

             if (result.isGranted())
              {
                 //Add your code here
              }
             else
              {
                 //Write your code here
                 //For SDK >= M, there are permissions missing and you can get them.
                 String deniedPermissions = TextUtils.join(", ", result.getUserDeniedPermissionsList()).trim();
                 String neverAskAgainPermissions = TextUtils.join(", ", result.getNeverAskAgainPermissionsList()).trim();
              }
          }
     }

For SDK >= M, if you want to let the library to show the user a dialog to manage missing permissions, then use this code:

@Override
    public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults)
    {
        PermissionsUtil permissionsUtil = AppUtilities.getPermissionUtil(this);

        if (requestCode == permissionsUtil.getPermissionsReqCodeId())
        {
            IGetPermissionResult result = null;
            result = permissionsUtil.getPermissionResults(permissions);

            if (result.isGranted())
            {
                //Write your code here
                return;
            }

            PermissionsManager.getNewInstance(this, result, permissions, new PermissionsManager.PermissionsManagerCallback()
            {
                @Override
                public void onPermissionsGranted(IGetPermissionResult result) {

                    /**
                     * User accepted all requested permissions
                     */
                     
                    //Write your code here
                }

                @Override
                public void onPermissionsMissing(IGetPermissionResult result)
                {
                    //Write your code here
                    Toast.makeText(MainActivity.this, "User didn't accept all permissions", Toast.LENGTH_LONG).show();
                }
            });
        }
    }

##Memory Util