01-入门指引¶

1. OpenHarmony 4.0 Release版本的配套文档¶

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

[https://docs.openharmony.cn/pages/v4.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

[https://docs.openharmony.cn/pages/v3.2/zh-cn/release-notes/OpenHarmony-v3.2-release.md/#%E9%85%8D%E5%A5%97%E5%85%B3%E7%B3%BB]

5. OpenHarmony Full-SDK 替换：¶

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

Full-SDK 在云盘附件中”OH-FullSDK-windows-x64-4.0.10.16-Release”

替换Full-SDK参考文档：

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

6. 商显特有接口API文档：¶

查看ShiMetaAPI文档

7. OS固件烧录指南¶

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

8. USB联调调试APP指南¶

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

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

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

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

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

hdc list targets
150100414a54443452069035fa308800

9. 常见问题&解决¶

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`,相关权限[社区链接](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/security/permission-list.md/)

"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. 注意¶

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