AndroidAnnotationsPermissionsDispatcherPlugin

Additional

Language
Java
Version
2.1.1 (Jan 24, 2018)
Created
Jun 20, 2016
Updated
Oct 24, 2019
Owner
permissions-dispatcher
Contributors
Shintaro Katafuchi (hotchemi)
WonderCsabo
Aleksander Mielczarek (AleksanderMielczarek)
vincentnock
fumiya-kume
5
Activity
Badge
Generate
Download
Source code
APK file

Show card

AndroidAnnotationsPermissionsDispatcherPlugin

Plugin for AndroidAnnotations allowing to use it together with PermissionsDispatcher. All you have to do is to include it in your dependencies.

Usage

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

allprojects {
 repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Add the dependency

dependencies {
    compile "com.github.hotchemi:permissionsdispatcher:${permissionsdispatcherVersion}"
    annotationProcessor "com.github.hotchemi:permissionsdispatcher-processor:${permissionsdispatcherVersion}"
    compile "org.androidannotations:androidannotations-api:${androidannotationsVersion}"
    annotationProcessor "org.androidannotations:androidannotations:${androidannotationsVersion}"
    annotationProcessor "com.github.AleksanderMielczarek:AndroidAnnotationsPermissionsDispatcherPlugin:${latestVersion}"
}

Example

@EActivity(R.layout.activity_main)
@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    @Click(R.id.permissionButton)
    protected void askForPermission() {
        showCamera();
    }

    @NeedsPermission(Manifest.permission.CAMERA)
    protected void showCamera() {
        Toast.makeText(this, "Permission for camera granted", Toast.LENGTH_SHORT).show();
    }

    @OnPermissionDenied(Manifest.permission.CAMERA)
    protected void onPermissionDeniedCamera() {
        Toast.makeText(this, "@OnPermissionDenied for camera", Toast.LENGTH_SHORT).show();
    }
    
    @OnShowRationale(Manifest.permission.CAMERA)
    protected void showRationaleForCamera(PermissionRequest request) {
        Toast.makeText(this, "OnShowRationale for camera", Toast.LENGTH_SHORT).show();
        request.proceed();
    }

    @OnNeverAskAgain(Manifest.permission.CAMERA)
    protected void showNeverAskForCamera() {
        Toast.makeText(this, "OnNeverAskAgain for camera", Toast.LENGTH_SHORT).show();
    }

}

Migrating to 2.x.x

Finally, you should not call the PermissionsDispatcher delegate class static methods anymore, this plugin will generate those calls for you. Just call the method which was annotated with @NeedsPermission. Overriding onRequestPermissionsResult and onActivtyResult (special permissions) should also be removed completely. See the example project for code.

Thanks

  • WonderCsabo for integrating plugin completely with PermissionsDispatcher

Changelog

2.1.1 (2018-01-24)

  • do not generate dispatcher calls if there is no @RuntimePermissions (#18)

2.1.0 (2017-10-29)

  • support PermissionsDispatcher 3.0.0
  • does not contain Kotlin support

2.0.3 (2017-08-09)

  • fix generating duplicated dispatchers (#10)

2.0.2 (2017-08-08)

  • fix special permissions handling (#9)

2.0.1 (2017-08-03)

  • fix not compiling code when AA is running first (#7)

2.0.0 (2017-07-12)

  • fully integration with PermissionsDispatcher

1.0.0 (2017-07-02)

  • rename module name
  • update dependencies

License

Copyright 2016 Aleksander Mielczarek

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.