Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ltrudu/CriticalPermissionsHelper
A simple wrapper to easilly grant critical permission to an application on Zebra Devices
https://github.com/ltrudu/CriticalPermissionsHelper
Last synced: 8 days ago
JSON representation
A simple wrapper to easilly grant critical permission to an application on Zebra Devices
- Host: GitHub
- URL: https://github.com/ltrudu/CriticalPermissionsHelper
- Owner: ltrudu
- License: mit
- Created: 2022-11-07T12:31:55.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-03-07T13:08:25.000Z (8 months ago)
- Last Synced: 2024-08-01T13:33:34.443Z (3 months ago)
- Language: Java
- Size: 94.7 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
*Please be aware that this library / application / sample is provided as a community project without any guarantee of support*
=========================================================
# CriticalPermissionsHelper
[](https://jitpack.io/#ltrudu/CriticalPermissionsHelper)
[](https://jitpack.io/#ltrudu/CriticalPermissionsHelper)
## Easy grant critical permissions to your Zebra's device
Forget about AccessMgr, StageNow, EMDK, certificates, application signature... complexity....
Just grant some critical permissions on your Zebra device in one method call (see at the end of this document).
Includes: ACCESS_NOTIFICATIONS, PACKAGE_USAGE_STATS, SYSTEM_ALERT_WINDOW, BATTERY_STATS, MANAGE_EXTERNAL_STORAGE, GET_APP_OPS_STATS, ALL_DANGEROUS_PERMISSIONS
Have fun with Zebra's devices :)
## Sample Repository
https://github.com/ltrudu/CriticalPermissionsHelper-Sample
## Description
A wrapper to easily grant critical permissions to your application running on Zebra's Android devices with Android >= A11
Available permissions are:
```txt
#1. Access Notifications:
Controls permission to access Notifications on the device.
#2. Package Usage Stats:
Controls permission to access app usage statistics for the device.
#3. System Alert Window:
Controls permission to use the System Alert Window, which allows one app to draw its window(s) over another.
#4. Get AppOps Stats:
Controls permission to access app operations statistics, used to determine the resources being used by apps on the device.
#5. Battery Stats:
Controls permission to access battery statistics for the device.
#6. Manage External Storage:
Controls management of USB and/or SD card storage media attached to the device.
#7. All Dangerous Permissions (MX >= 13.1, StageNow >= 5.11.0)
Grants all permissions that requires runtime permission model
To know which permissions are listed as Dangerous, execute the following ADB command:
adb shell pm list permissions -g -d
```
This wrapper will use the EMDK with MX's AccessMgr feature to grant, deny or verify (WIP) critical permissions.
## Implementation
To use this helper on Zebra Android devices running Android 10 or higher, first declare a new permission in your AndroidManifest.xml
The EMDK permission is compulsary, the others are depending on your needs.
```xml
```
Sample AdroidManifest.xml:
```xml
?xml version="1.0" encoding="utf-8"?>
TODO: Add these permissions to your manifest -->
TODO: Add uses-library com.symbol.emdk to your manifest -->
```
Update your project build.graddle file to add jitpack repository
```text
maven { url 'https://jitpack.io' }
```
Sample project build.gradle
```text
buildscript {
repositories {
google()
jcenter()
maven { url 'https://jitpack.io' }
}
dependencies {
classpath 'com.android.tools.build:gradle:7.2.1'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
google()
maven { url 'https://jitpack.io' }
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
```
Finally, add CriticalPermissionsHelper dependency to your application build.graddle file:
```text
implementation 'com.github.ltrudu:CriticalPermissionsHelper:+'
```
Sample application build.graddle:
```text
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:28.0.0'
testImplementation 'junit:junit:4.13'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
implementation 'com.github.ltrudu:CriticalPermissionsHelper:+'
}
```
Now you can use the following snippet codes to grant permissions.
The type of permissions you can grant:
```java
EPermissionType.ACCESS_NOTIFICATIONS
EPermissionType.PACKAGE_USAGE_STATS
EPermissionType.SYSTEM_ALERT_WINDOW
EPermissionType.GET_APP_OPS_STATS
EPermissionType.BATTERY_STATS
EPermissionType.MANAGE_EXTERNAL_STORAGE
EPermissionType.ALL_DANGEROUS_PERMISSIONS
```
Snippet code to grant a permission:
```java
private void enablePermission(final Context aContext, final EPermissionType aPermissionType)
{
// Enable permission
CriticalPermissionsHelper.grantPermission(aContext, aPermissionType, new IResultCallbacks() {
@Override
public void onSuccess(String message, String resultXML) {
Log.d(TAG, aPermissionType.toString() + " granted with success.");
}
@Override
public void onError(String message, String resultXML) {
Log.d(TAG, "Error granting " + aPermissionType.toString() + " permission.\n" + message);
}
@Override
public void onDebugStatus(String message) {
Log.d(TAG, "Debug Grant Permission " + aPermissionType.toString() + ": " + message);
}
});
}
```
Snippet code to disable a permission:
```java
private void disablePermission(final Context aContext, final EPermissionType aPermissionType)
{
// Enable permission
CriticalPermissionsHelper.denyPermission(aContext, aPermissionType, new IResultCallbacks() {
@Override
public void onSuccess(String message, String resultXML) {
Log.d(TAG, aPermissionType.toString() + " granted with success.");
}
@Override
public void onError(String message, String resultXML) {
Log.d(TAG, "Error granting " + aPermissionType.toString() + " permission.\n" + message);
}
@Override
public void onDebugStatus(String message) {
Log.d(TAG, "Debug Grant Permission " + aPermissionType.toString() + ": " + message);
}
});
}
```
The verifyPermission method is a work in progress.
Check the sample for more information.