鸿蒙开发（NEXT/API 12）【基础功能（申请访问剪贴板权限）】剪贴板服务

移动开发技术栈

于 2024-09-24 15:05:56 发布

阅读量795

点赞数 25

分类专栏：鸿蒙开发文章标签： harmonyos 鸿蒙系统鸿蒙 openharmony 华为系统架构剪切板

本文链接：https://blog.csdn.net/m0_70748845/article/details/142487779

版权

鸿蒙开发专栏收录该内容

613 篇文章 16 订阅

订阅专栏

概述

API version 12及之后，系统为提升用户隐私安全保护能力，剪贴板读取接口增加权限管控。

涉及接口如下：

名称	说明
getData( callback: AsyncCallback): void	读取系统剪贴板内容，使用callback异步回调。
getData(): Promise	读取系统剪贴板内容，使用Promise异步回调。
getDataSync(): PasteData	读取系统剪贴板内容, 此接口为同步接口。

访问剪贴板内容

剪贴板为应用提供如下两种访问内容的方式。

使用安全控件

使用[安全控件]访问剪贴板内容的应用，可以无需申请权限。

已经使用了安全控件的应用无需做任何适配就可以访问剪贴板内容。
申请ohos.permission.READ_PASTEBOARD权限

READ_PASTEBOARD是一个user_grant（用户授权）权限，使用自定义控件的应用可以通过申请ohos.permission.READ_PASTEBOARD权限，在用户授权的场景下访问剪贴板内容。

申请ohos.permission.READ_PASTEBOARD权限步骤：

1.在module.json5中配置所需申请的权限

"requestPermissions": [
  {
  "name": "ohos.permission.READ_PASTEBOARD",
  }
]

2.在调用getData接口之前增加用户授权弹窗。

import { hilog } from '@kit.PerformanceAnalysisKit';
import { abilityAccessCtrl, common, Permissions, UIAbility, bundleManager } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError, pasteboard } from '@kit.BasicServicesKit';

async function checkAccessToken(permission: Permissions): Promise<abilityAccessCtrl.GrantStatus> {
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
  let grantStatus: abilityAccessCtrl.GrantStatus = abilityAccessCtrl.GrantStatus.PERMISSION_DENIED;

  // 获取应用程序的accessTokenID
  let tokenId: number = 0;
  try {
    let bundleInfo: bundleManager.BundleInfo = await bundleManager.getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION);
    let appInfo: bundleManager.ApplicationInfo = bundleInfo.appInfo;
    tokenId = appInfo.accessTokenId;
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error(`Failed to get bundle info for self. Code is ${err.code}, message is ${err.message}`);
  }

  // 校验应用是否被授予权限
  try {
    grantStatus = await atManager.checkAccessToken(tokenId, permission);
  } catch (error) {
    let err: BusinessError = error as BusinessError;
    console.error(`Failed to check access token. Code is ${err.code}, message is ${err.message}`);
  }

  return grantStatus;
}

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  @State msgList: Array<string> = [];
  // @State oaid: string = '';
  @State permission_state: boolean = true;

  reqPermissionsFromUser(permissions: Array<Permissions>): void {
    let context = getContext(this) as common.UIAbilityContext;
    let atManager = abilityAccessCtrl.createAtManager();
    // requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗
    atManager.requestPermissionsFromUser(context, permissions).then((data) => {
      let grantStatus: Array<number> = data.authResults;
      let length: number = grantStatus.length;
      for (let i = 0; i < length; i++) {
        if (grantStatus[i] === 0) {
          // 用户授权，可以继续访问目标操作
          this.permission_state = true;
          this.msgList.push('申请权限成功');
        }
        else {
          // 用户拒绝授权，提示用户必须授权才能访问当前页面的功能，并引导用户到系统设置中打开相应的权限
          // openPermissionsInSystemSettings();
          console.error("user did not grant!")
          this.permission_state = false;
          this.msgList.push('申请权限失败');
        }
      }
      // 授权成功
    }).catch((err: String) => {
    })
  }

  async getPaste() {
    const permissions: Array<Permissions> = ['ohos.permission.READ_PASTEBOARD'];
    let grantStatus1: abilityAccessCtrl.GrantStatus = await checkAccessToken(permissions[0]);

    if (grantStatus1 === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
      try {
        let systemPasteboard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard();
        systemPasteboard.getData((err: BusinessError, pasteData: pasteboard.PasteData) => {
          if (err) {
            console.error('Failed to get PasteData. Cause: ' + err.message);
            return;
          }
          let text: string = pasteData.getPrimaryText();
          this.msgList.push('剪贴板内容：'+text);
        });
      } catch (err) {
        hilog.error(0x0000, 'testTag', '%{public}s', `get oaid by promise catch error: ${err.code} ${err.message}`);
      }
    } else {
      // 申请权限
      if(this.permission_state) {
        this.reqPermissionsFromUser(permissions)
      }else{

      }
    }
  }
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述