为探究OpenHarmony 屏幕截图API做的工作

​​想了解更多关于开源的内容，请访问：​​

​​51CTO 开源基础软件社区​​

​​https://ost.51cto.com​​

一、安装VMware Workstation Player

1、下载VMware Workstation Player（文章中别名：VM Player）

​​VM Player下载地址​​

2、安装VM Player

（1）点击VMware-player-full-xxx.exe，进入安装向导

（2）勾选接受许可协议条款

（3）更改安装位置（如果仅有一个磁盘，请移至1.2.4）

（4）用户体验设置，可默认，也可以取消勾选

（5）快捷方式默认

（6）开始安装

（7）完成安装（个人使用跳过许可即可）

3、打开VM Player

4、设置USB插入后直接连接到主机（Player --> 文件 --> 首选项）

至此VM Player安装完成。

二、准备Ubuntu20.04系统镜像包

1、 ​​Ubuntu系统下载 | Ubuntu​​

2、由于下载下来的文件格式为.torrent，需要使用迅雷下载完整的ISO文件。

Ubuntu镜像包准备完毕。

三、创建OpenHarmony虚拟机

1、打开VM Player，点击主页的创建新虚拟机

2、勾选稍后安装操作系统，点击下一步

3、选择客户机操作系统和版本

4、设置虚拟机名称和位置（如果有多个盘的话，建议存储在非C盘中）

5、指定磁盘大小

6、完成虚拟机创建

7、编辑虚拟机设置

（1）设置内存（建议多点）

（2）指定ISO镜像文件位置

（3）开启共享文件夹

（4）移除USB控制器

名为OpenHarmony的Ubuntu虚拟机创建成功。

四、开始安装Ubuntu操作系统

1、点击VM Player主页的播放虚拟机

2、在安装向导界面左侧语言栏选择中文(简体)，当然也可以使用默认

3、点击安装向导界面试用Ubuntu（由于安装时无法正常显示，所以需要调分辨率）

4、在虚拟机桌面右键打开终端，输入xrandr -s 1280x800,回车即可

5、点击虚拟机桌面安装Ubuntu20.04LTS，进行安装

（1）以下图不需要文字描述

（2）点击选择位置

（3）填写必要的信息

（4）等待安装完成，耗时比较久，可以做点其他事

Ubuntu操作系统安装成功。

五、准备标准系统环境

1、搭建Ubuntu环境

（1）将Ubuntu Shell 环境修改为bash

a. 执行命令查看是否为bash，如果不是则按照[b]操作，若是则跳过。

b. 执行命令，将Shell由dash改为bash。

c. 更改成功。

（2）下载​​华为集成开发环境IDE DevEco Device Tool下载 | HarmonyOS设备开发​​ Linux版本

（3）解压DevEco Device Tool软件包，并对解压后的文件夹进行赋权

unzip devicetool-linux-tool-3.0.0.401.zip
chmod u+x devicetool-linux-tool-3.0.0.401.sh

（4）执行命令按照DevEco Device Tool

sudo ./devicetool-linux-tool-3.0.0.401.sh

等待安装完成。

出现图中红框内容，则表示安装成功。

（5）安装SSH服务

a. 执行命令sudo apt-get install openssh-server安装SSH服务。

b. 执行命令sudo systemctl start ssh启动SSH服务，执行命令sudo systemctl status ssh查看状态，为active(running)则启动成功。

（6）获取标准系统源码

a. 执行命令sudo apt-get install git git-lfs安装git客户端和git-lfs。

b. 配置用户信息。

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

c. 安装码云repo工具。

curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo  #如果没有权限，可下载至其他目录，并将其配置到环境变量中
chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

如果提示 Command 'curl' not found, but can be installed with: sudo apt install curl 则执行命令 sudo apt-get install curl 安装 curl。

若提示权限不够，则在命令前加sudo。

d. 使用repo+https下载发布Tag节点源码。

• 创建源码存放目录。

• 进入创建的源码存放目录，执行以下命令下载源码。

repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v3.2-Beta1 --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

提示/usr/bin/env: "python": 没有那个文件或目录,则执行命令sudo ln -sf /usr/bin/python3 /usr/bin/python创建一个链接。

e. 在源码目录下执行bash build/prebuilts_download.sh安装编译器及二进制工具。

2、搭建Windows环境

（2）下载​​华为集成开发环境IDE DevEco Device Tool下载 | HarmonyOS设备开发​​ Windows版本

（2）安装DevEco Device Tool

a. 点击devicetools-windows-tool-xxx.exe打开安装向导。

b. 选择安装位置。

c. 同时安装VSCode。

d. 选择python路径（如果安装过），没有安装，则选择下载安装。

e. 选择其他组件，默认即可。

f. 接受协议。

g. 等待安装完成，安装过程会弹出python安装界面，切勿操作。

h. 完成安装。

i. 打开VSCode，等待检查更新完成后重启。

（3）安装Remote-SSH

a. 在左侧扩展中搜索Remote-SSH，并安装。

b. 配置Ubuntu远程连接。

在Ubuntu虚拟机中执行ifconfig获取虚拟机IP地址，若提示Command 'ifconfig' not found, but can be installed with: sudo apt install net-tools则执行sudo apt-get install net-tools命令，然后再次执行ifconfig获取虚拟机IP地址。

c. 输入远程连接信息ssh tetcl@192.168.220.128 -A。

d. 选择配置文件。

e. 在远程资源管理器中出现刚才配置的IP地址时，则配置成功。

（4）连接远程Ubuntu

a. 选择Linux。

b. 选择Continue。

c. 输入设置的password（两个字竟然是敏感信息）。

若提示DevEco Device Tool需要重载，则点击重载即可。

（5）为了不用频繁输入远程虚拟机password，需要配置远程访问Ubuntu环境公钥

a. 打开Git bash命令（如果没有安装，则安装Git），执行命令，生成SSH公钥。

ssh-keygen -t rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub tetcl@192.168.220.128

b. 配置公钥。

c. 断开连接，重新连接远程Ubuntu，需要输入配置SSH Key时输入的password。

OpenHarmony标准系统环境准备完毕。

六、导入、编译、烧录

1、导入源码工程

a. 打开VSCode， 首先连接远程虚拟机，然后点击左侧DevEco，主界面 --> 主页 --> 导入工程。

b. 导入工程界面快速访问选择虚拟机（tetcl），选择源码所在目录。

c. 首次导入时，会出现如下提示框，点击导入。

d. 在选择工程导入类型界面中选择从OpenHarmony源码导入。

e. 导入工程界面中，产品选择hihope下的rk3568，OpenHarmony版本选择3.x，其他默认。

f. 打开源码，将在资源管理器下看到源码目录结构。

2、编译源码

a. 打开主界面工程，点击配置工程。

c. 在toolchain页签中，会自动检测依赖的编译工具链是否完备，如果提示部分工具链缺失，点击安装即可自动安装。

c. 在blank配置页中，设置源码的编译类型build_type，默认即可，然后单击右上角保存按钮。

d. 在PROJECT TASKS中，点击对应的开发板下的Build进行编译。

e. 编译成功后，会在out目录下输出对应开发板所需的镜像文件。

3、烧录（由于VSCode无法配置烧录分区选择使用瑞芯微烧录工具）

a. 打开瑞芯微烧录工具。

b. 将编译好的镜像文件拷贝到windows磁盘中。

c. 在瑞芯微烧录工具加载镜像窗口右键导入配置（并更改文件所在路径，确保能够找到）。

d. 连接开发板，长按更新键，然后按RESET按键，再点击瑞芯微烧录工具中的执行，在右侧会显示下载Boot，然后松开更新键，等待烧录完成。

七、制作截图AppDemo

1、创建ScreenShot项目

2、选择使用的Ability模板

3、编写代码

（1）导入模块

// ScreenShot/entry/src/main/ets/MainAbility/pages/index.ets
import screenshot from '@ohos.screenshot';
// screenshot.save()返回的是PixelMap，因此需要导入
import image from '@ohos.multimedia.image';

（2）配置权限

a. module.json5中配置权限。

// ScreenShot/entry/src/main/module.json5
{
    "requestPermissions": [
      {
        "name": "ohos.permission.CAPTURE_SCREEN"
      }
    ],
}

b. 因为screenshot是system_core等级，不仅仅需要在config.json中配置，还要修改profile文件中配置（Sdk/toolchains/版本/lib/UnsgnedReleasedProfileTemplate.json&UnsgnedDebugProfileTemplate.json）。

c. 配置完成后，对应用进行签名。

（3）查看权限是否授予

// MainAbility.ts onWindowStageCreate()
    onWindowStageCreate(windowStage) {
        // Main window is created, set main page for this ability
        console.log("[Demo] MainAbility onWindowStageCreate")
        var context = this.context;
        let array: Array<string> = ['ohos.permission.CAPTURE_SCREEN'];
        context.requestPermissionsFromUser(array).then((data) => {
            console.log('ScreenShot ---> MainAbility ---> data type: ' + typeof(data));
            console.log('ScreenShot ---> MainAbility ---> data: ' + JSON.stringify(data));
            console.log('ScreenShot ---> MainAbility ---> data permissions: ' + data.permissions);
            console.log('ScreenShot ---> MainAbility ---> data result: ' + data.authResults);
        }).catch(err => {
            console.error('ScreenShot ---> MainAbility ---> err: ' + JSON.stringify(err));
        })
        windowStage.setUIContent(this.context, "pages/index", null)
    }

（4）点击按钮，实现截图

// 获取屏幕截图
screenshot.save(options?: ScreenShotOptions, callback: AsyncCallback<image.PixelMap>):void
screenshot.save(options?: ScreenShotOptions): Promise<image.PixelMap>
// 设置截图图像的信息
ScreenShotOptions = {
  screenRect: {
    "left": 200,
    "top": 100,
    "width": 200,
    "height": 200
  }, // 表示截图图像的区域，不传值默认为全屏
  imageSize: {
    "width": 300,
    "height": 300
  }, // 表示截取图像的大小，不传值默认为全屏
  rotation: 0, // 表示截图图像的旋转角度，当前仅支持输入值为0，默认值为0
  displayId: 0// 表示截图图像的显示设备Display的ID号，API8以上
}

getScreen = (isFullScreen: boolean) => {
    let options: screenshot.ScreenshotOptions = {
      screenRect: { left: 0, top: 0, width: 400, height: 400 },
      imageSize: { width: 400, height: 400 },
      rotation: 0,
      displayId: 0
    }
    if (isFullScreen) {
      options = {
        rotation: 0
      }
    }
    screenshot.save(options, (err, data: image.PixelMap) => {
      if (err) {
        console.error('ScreenShot --> error: ' + JSON.stringify(err));
        return;
      }
      console.info('ScreenShot --> data: ' + JSON.stringify(data));
      this.image = data;
    })
  }

八、存在问题

1、 system_core授权回显

2、screenshot.save()返回undefined

​​想了解更多关于开源的内容，请访问：​​

​​51CTO 开源基础软件社区​​

​​https://ost.51cto.com​​。