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

网友投稿 256 2023-05-26

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

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.sh1.2.

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

复制sudo ./devicetool-linux-tool-3.0.0.401.sh1.

等待安装完成。

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

（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 store1.2.3.

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 requests1.2.3.

如果提示 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 pull1.2.3.

提示/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.1281.2.

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;1.2.3.4.

（2）配置权限

a. module.json5中配置权限。

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

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) }1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.

（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以上 }1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.

复制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.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.

八、存在问题

1、 system_core授权回显

2、screenshot.save()返回undefined