#DAYU200体验官# 为探究OpenHarmony 屏幕截图API做的工作 原创 精华

目录

• 1 安装VMware Workstation Player
• 1.1 下载VMware Workstation Player（文章中别名：VM Player）
• 1.2 安装VM Player
• 1.2.1 点击VMware-player-full-xxx.exe，进入安装向导
• 1.2.2 勾选接受许可协议条款
• 1.2.3 更改安装位置（如果仅有一个磁盘，请移至1.2.4）
• 1.2.4 用户体验设置，可默认，也可以取消勾选
• 1.2.5 快捷方式默认
• 1.2.6 开始安装
• 1.2.7 完成安装（个人使用跳过许可即可）
• 1.3 打开VM Player
• 1.4 设置USB插入后直接连接到主机（Player --> 文件 --> 首选项）
• 2 准备Ubuntu20.04系统镜像包
• 2.1 [Ubuntu系统下载 | Ubuntu](https://cn.ubuntu.com/download)
• 2.2 由于下载下来的文件格式为.torrent，需要使用迅雷下载完整的ISO文件。
• 3. 创建OpenHarmony虚拟机
• 3.1 打开VM Player，点击主页的创建新虚拟机
• 3.2 勾选稍后安装操作系统，点击下一步
• 3.3 选择客户机操作系统和版本
• 3.4 设置虚拟机名称和位置（如果有多个盘的话，建议存储在非C盘中）
• 3.5 指定磁盘大小
• 3.6 完成虚拟机创建
• 3.7 编辑虚拟机设置
• 3.7.1 设置内存（建议多点）
• 3.7.2 指定ISO镜像文件位置
• 2.7.3 开启共享文件夹
• 3.7.4 移除USB控制器
• 4 开始安装Ubuntu操作系统
• 4.1 点击VM Player主页的播放虚拟机
• 4.2 在安装向导界面左侧语言栏选择中文(简体)，当然也可以使用默认
• 4.3 点击安装向导界面试用Ubuntu（由于安装时无法正常显示，所以需要调分辨率）
• 4.4 在虚拟机桌面右键打开终端，输入`xrandr -s 1280x800`,回车即可
• 4.5 点击虚拟机桌面安装Ubuntu20.04LTS，进行安装
• 4.5.1 以下图不需要文字描述
• 4.5.2 点击选择位置
• 4.5.3 填写必要的信息
• 4.5.4 等待安装完成，耗时比较久，可以做点其他事
• 5 准备标准系统环境
• 5.1 搭建Ubuntu环境
• 5.1.1 将Ubuntu Shell 环境修改为`bash`
• 5.1.2 下载[华为集成开发环境IDE DevEco Device Tool下载 | HarmonyOS设备开发](https://device.harmonyos.com/cn/develop/ide#download) Linux版本
• 5.1.3 解压DevEco Device Tool软件包，并对解压后的文件夹进行赋权
• 5.1.4 执行命令按照DevEco Device Tool
• 5.1.5 安装SSH服务
• 5.1.6 获取标准系统源码
• 5.2 搭建Windows环境
• 5.2.1 下载[华为集成开发环境IDE DevEco Device Tool下载 | HarmonyOS设备开发](https://device.harmonyos.com/cn/develop/ide#download) Windows版本
• 5.2.2 安装DevEco Device Tool
• 5.2.3 安装Remote-SSH
• 5.2.4 连接远程Ubuntu
• 5.2.5 为了不用频繁输入远程虚拟机password，需要配置远程访问Ubuntu环境公钥
• 6 导入、编译、烧录
• 6.1 导入源码工程
• 6.2 编译源码
• 6.3 烧录（由于VSCode无法配置烧录分区选择使用瑞芯微烧录工具）
• 7 制作截图AppDemo
• 7.1 创建ScreenShot项目
• 7.2 选择使用的Ability模板
• 7.3 编写代码
• 7.3.1 导入模块
• 7.3.2 配置权限
• 7.3.3 查看权限是否授予
• 7.3.4 点击按钮，实现截图
• 8 存在问题
• 8.1 `system_core`授权回显
• 8.2 `screenshot.save()`返回`undefined`

想到就开始行动，比想更重要。

可以忽略的一些废话😂😂😂
这篇文章到底为什么存在？存在的价值到底在哪儿？
我并没有思考这些，仅仅是想将在开发OpenHarmony应用程序路上遇到的一些问题或者解决方法记录下来，以便于在某个天气晴朗的下午我又遇到时可以方便查阅。~~
最终经历了4个炎热的10小时，我还是失败了😂😂😂，system_core授权成功，截图返回undefined😒😒😒，赤裸裸的嘲讽😰😰😰~~

1 安装VMware Workstation Player

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

VM Player下载地址

1.2 安装VM Player

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

1.2.2 勾选接受许可协议条款

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

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

1.2.5 快捷方式默认

1.2.6 开始安装

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

1.3 打开VM Player

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

＊═—═—═—═—═—═—＊至此VM Player安装完成＊═—═—═—═—═—═—＊

2 准备Ubuntu20.04系统镜像包

2.1 Ubuntu系统下载 | Ubuntu

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

＊═—═—═—═—═—═—＊Ubuntu镜像包准备完毕＊═—═—═—═—═—═—＊

3. 创建OpenHarmony虚拟机

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

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

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

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

3.5 指定磁盘大小

3.6 完成虚拟机创建

3.7 编辑虚拟机设置

3.7.1 设置内存（建议多点）

3.7.2 指定ISO镜像文件位置

2.7.3 开启共享文件夹

3.7.4 移除USB控制器

＊═—═—═—═—═—═—＊名为OpenHarmony的Ubuntu虚拟机创建成功＊═—═—═—═—═—═—＊

4 开始安装Ubuntu操作系统

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

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

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

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

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

4.5.1 以下图不需要文字描述

4.5.2 点击选择位置

4.5.3 填写必要的信息

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

＊═—═—═—═—═—═—＊Ubuntu操作系统安装成功＊═—═—═—═—═—═—＊

5 准备标准系统环境

5.1 搭建Ubuntu环境

5.1.1 将Ubuntu Shell 环境修改为bash

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

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


c. 更改成功

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

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

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

5.1.4 执行命令按照DevEco Device Tool

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

等待安装完成

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

5.1.5 安装SSH服务

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

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

5.1.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
1.
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 requests
1.
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 pull'
1.
2.
3.

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

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

5.2 搭建Windows环境

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

5.2.2 安装DevEco Device Tool

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

b. 选择安装位置

c. 同时安装VSCode

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

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

f. 接受协议

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

h. 完成安装

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

5.2.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地址时，则配置成功

5.2.4 连接远程Ubuntu

a. 选择Linux

b. 选择Continue

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

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

5.2.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
1.
2.

b. 配置公钥



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

＊═—═—═—═—═—═—＊OpenHarmony标准系统环境准备完毕＊═—═—═—═—═—═—＊

6 导入、编译、烧录

6.1 导入源码工程

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

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

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

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

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

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

6.2 编译源码

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

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


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

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

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

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

a. 打开瑞芯微烧录工具

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

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

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

7 制作截图AppDemo

7.1 创建ScreenShot项目

7.2 选择使用的Ability模板

7.3 编写代码

7.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.
5.
6.

7.3.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. 配置完成后，对应用进行签名

7.3.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.
17.

7.3.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.
19.
20.

  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.

8 存在问题

8.1 system_core授权回显

8.2 screenshot.save()返回undefined

如果有成功调用截图Api的大佬，可以分享一下。