PermissionsDispatcher

PermissionsDispatcher предоставляет простой основанный на комментариях API для обработки разрешений во время выполнения. Библиотека снижает нагрузку, связанную с написанием множества проверочных операторов (независимо от того, предоставлены ли вам разрешения), и помогает поддерживать чистоту и безопасность кода.

Использование

Существует внутренний простой пример, который можно использовать в качестве ориентира.

Требования к запуску entry

1. Загрузите DevEco studio и SDK через DevEco studio 2.0+ и Native 2.0+.

Примечание: В китайском пути сборка Debug Hap(s) завершится неудачно. Рекомендуется размещать проект в полностью английском каталоге.

2. Интегрируйте в entry gradle следующие операции:

• Если вы используете har, поместите har в папку entry/libs.
• Измените implementation fileTree(dir: 'libs', include: ['.jar','.har']) для добавления *.har.
• Подготовьте config.json и build.gradle.

3. Добавьте соответствующие разрешения в config.json:

"reqPermissions": [
      {
        "name": "ohos.permission.CAMERA"
      }
    ]

4. В entry/build.gradle добавьте:

allprojects{
    repositories{
        mavenCentral()
    }
}
implementation 'io.openharmony.tpc.thirdlib:permissionsdispatcher-library:1.0.4'
implementation 'io.openharmony.tpc.thirdlib:permissionsdispatcher-processor:1.0.4'
annotationProcessor 'io.openharmony.tpc.thirdlib:permissionsdispatcher-processor:1.0.4'

1. Аннотации

PermissionsDispatcher вводит только несколько комментариев для сохранения простоты своего обычного API:

Пример использования аннотаций:

    @NeedsPermission(CAMERA_PERMISSION_NAME)
    public void toOpenPermission() {
        ToastUtil("Разрешение успешно запрошено");
    }

    @OnPermissionDenied(CAMERA_PERMISSION_NAME)
    public void toResetPermission() {
        ToastUtil("OnPermissionDenied разрешение отклонено");
    }

    @OnShowRationale(CAMERA_PERMISSION_NAME)
    public void showDialog(PermissionRequest request) {
        ToastUtil("showDialog объясняет причину необходимости открытия соответствующего разрешения, необходимо написать диалоговое окно выбора");
        // Подтвердить запрос
        request.proceed();
        // Отменить
//        request.cancel();
    }

    @OnNeverAskAgain(CAMERA_PERMISSION_NAME)
    public void toExplainPermission() {
        ToastUtil("OnNeverAskAgain объясняет, почему это разрешение было отклонено");
    }

2. Передача функций генерации

После создания соответствующего класса вызовите методы класса для начала запроса разрешений.

    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
          super.setUIContent(ResourceTable.Layout_ability_main);

        Button buttonStart = (Button) findComponentById(ResourceTable.Id_btn_main_apply);
        buttonStart.setClickedListener(new Component.ClickedListener() {
            @Override
            public void onClick(Component component) {
                //studio причина красного цвета, но также нормально работает, не паникуйте, в соответствующем entry->build->generated->sources файле выберите Mark Directory as -> выберите Generated Source Root.
                MainAbilityPermissionsDispatcher.toOpenPermissionWithPermissionCheck(MainAbility.this);
            }
        });
        
    }
 
Обратные вызовы метода
@Override
public void onRequestPermissionsFromUserResult(int requestCode, String[] permissions, int[] grantResults) {
   super.onRequestPermissionsFromUserResult(requestCode, permissions, grantResults);
   MainAbilityPermissionsDispatcher.onRequestPermissionsFromUserResult(this,requestCode,grantResults);
}

Проблемы

1. Из-за временных проблем студии после сборки невозможно найти сгенерированный файл. Необходимо выполнить следующие действия:

— Соберите проект, затем в папке entry->build->generated->sources->annotationProcessor->java->main->с папкой, соответствующей пакету, после сборки автоматически сгенерируйте файл. По причине студии его нельзя напрямую связать с файлом в этой папке. Сгенерируйте соответствующий xxPermissionDispatcher для ability/slice.

— В папке entry->build->generated->sources выберите Mark Directory как -> выберите Generated Source Root. Затем в ability или slice можно ссылаться.

2. Поскольку в slice нет метода onRequestPermissionsFromUserResult (xxx), информация о обратном вызове не может определить, были ли разрешения успешно получены или запрещены, что приводит к невозможности вызова методов, отмеченных @NeedsPermission и @OnNeverAskAgain после успешного или запрещённого запроса разрешений. Если иное не требуется по применимому законодательству или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, предоставляется на условиях «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ ЛЮБОГО РОДА, явных или подразумеваемых.

См. Лицензию для ознакомления с конкретным языком, регулирующим разрешения и ограничения по Лицензии.