01-入门指引

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

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

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

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

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

https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/deveco_overview-0000001053582387-V3?catalogVersion=V3

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

3. OpenHarmony应用程序示例

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

[OpenHarmony/applications_app_samples]

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指南

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

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

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

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

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

hdc list targets
150100414a54443452069035fa308800

8. 常见问题&解决

9.1. 选择为Openharmony SDK开发环境

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

9.2. 升级App为system权限

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

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

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

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

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

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

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"

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

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

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

10. 注意

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