第一章 入门指引

1. OpenHarmony 5.0 Release版本的配套文档

OpenHarmony官网APP开发主页地址（含完整的API参考与Demo）：

[https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/application-dev-guide.md/]

TOOL

2. OpenHarmony APP开发工具下载地址：

[https://developer.harmonyos.com/cn/develop/deveco-studio/]

TOOL

[https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/deveco\_overview-0000001053582387-V3?catalogVersion=V3]

TOOL

安装和配置可参考官方文档：

3. OpenHarmony应用程序示例

以下网址是官方关于常见的应用程序场景的示例Demo，可以根据需求参考学习

[OpenHarmony/applications_app_samples] https://gitee.com/openharmony/applications_app_samples?_from=gitee_search

TOOL

4. OpenHarmony标准SDK下载地址：

4.1 标准路径sdk

一般不用手动下载，第2步开发工具可自动下载最新的realse版本SDK

5. OpenHarmony Full-SDK 替换：

Full-SDK是提供OpenHarmony全量接口的SDK，包含了系统应用所需要的高权限API，用于厂商开发应用。

自行编译替换Full-SDK参考文档：

https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/faqs/full-sdk-switch-guide.md/

6. OS固件烧录指南

如Android各平台的烧录工具和步骤

7. USB联调调试APP指南

1.  电脑用USB线连接设备OTG口。

2.  电脑上把hdc工具添加到环境变量，路径：您的openharmonysdk/10/toolchains，

	如：D:\\SDK\\OpenHarmony\\sdk\\10\\toolchains

3.  设备上打开USB调试开关，设置-->系统-->开发者选项-->USB调试。

4.  电脑上打开命令行工具，`hdc list targets`，连接成功可打印出设备，如下：

	hdc list targets
    150100414a54443452069035fa308800

8. 常见问题&解决

8.1 选择为Openharmony SDK开发环境

build-profile.json5 声明 "runtimeOS": "OpenHarmony"

TOOL

8.2 升级App为system权限

调用system相关api，如power.reboot('reboot_test'),需要system权限。资料相对比较分散，甚至遇到一些问题。以下是配置system权限的步骤

升级APP为system权限需要修改两个位置，一是DevEco Studio里添加requestPermissions，二是OpenHarmony sdk里配置为system。下面以重启接口power.reboot('reboot_test');为例。

A. DevEco Studio 相关业务代码里使用接口：

try {
  console.info('onPageShow reboot start.')
  // @ts-ignore
  power.reboot('reboot_test')
} catch (err) {
  console.error('reboot failed, err: ' + err)
}

B. module.json5里增加权限ohos.permission.REBOOT

	"module": {
		-----
		"requestPermissions":[
		  {
			"name" : "ohos.permission.REBOOT"
		  }
		]
		----
	}

C. OpenHarmony sdk修改UnsgnedReleasedProfileTemplate.json文件，如这边的文件地址为：

	D:\SDKs\OpenHarmony\sdk\10\toolchains\lib

修改"bundle-name" 为应用包名,apl为"system_core"

	"bundle-name":"com.smdt.ostools.agingtest",
	"apl":"system_core",
	"app-feature":"hos_system_app"

D. 重新生成key，DevEco Studio-->Project Structure -> project ->Signing Configs。此处要注意，要勾掉Support HarmonyOS，进入相关文件夹，看下新生成key的修改时间，确认是否重新生成，如果未重新生成，先删掉旧key，再重新生成。

TOOL

F. 运行APP，如果安装成功，且未打印 "reboot failed, err", 重启成功，且完成System权限升级。

G. 系统签名

TOOL

在sdk目录找到如上文件，修改如下

TOOL

9. 注意

  • 多看官方文档，多百度，多试验