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/] .. image:: media/ohos_help_01.png 2. OpenHarmony APP开发工具下载地址： --------------------------------------------- [https://developer.harmonyos.com/cn/develop/deveco-studio/] .. image:: media/ohos_help_02.png https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/deveco\_overview-0000001053582387-V3?catalogVersion=V3 .. image:: media/ohos_help_03.png 安装和配置可参考官方文档： 3. OpenHarmony应用程序示例 --------------------------------------------- 以下网址是官方关于常见的应用程序场景的示例Demo，可以根据需求参考学习 `[OpenHarmony/applications\_app\_samples] `_ .. image:: media/ohos_help_04.png 4. OpenHarmony标准SDK下载地址： --------------------------------------------- 4.1 标准路径sdk ----------- .. note:: 一般不用手动下载，第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指南 --------------------------------------------- 1. 电脑用USB线连接设备OTG口。 2. 电脑上把hdc工具添加到环境变量，路径：您的openharmonysdk/10/toolchains，     如：D:\\SDK\\OpenHarmony\\sdk\\10\\toolchains 3. 设备上打开USB调试开关，设置-->系统-->开发者选项-->USB调试。 4. 电脑上打开命令行工具，`hdc list targets`，连接成功可打印出设备，如下： .. code:: hdc list targets 150100414a54443452069035fa308800 9. 常见问题&解决 --------------------------------------------- 9.1. 选择为Openharmony SDK开发环境 --------------------------------------- build-profile.json5 声明 "runtimeOS": "OpenHarmony" .. image:: media/ohos_help_05.png 9.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 相关业务代码里使用接口： .. code:: 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`,相关权限[社区链接](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/security/permission-list.md/) .. code:: "module": { ----- "requestPermissions":[ { "name" : "ohos.permission.REBOOT" } ] ---- } C. OpenHarmony sdk修改UnsgnedReleasedProfileTemplate.json文件，如这边的文件地址为： .. code:: D:\SDKs\OpenHarmony\sdk\10\toolchains\lib 修改"bundle-name" 为应用包名,apl为"system_core" .. code:: "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，再重新生成**。 .. image:: media/ohos_help_06.png F. 运行APP，如果安装成功，且未打印 "reboot failed, err", 重启成功，且完成System权限升级。 G. 系统签名 .. image:: media/ohos_help_07.png 在sdk目录找到如上文件，修改如下 .. image:: media/ohos_help_08.png 10. 注意 -------------- * 多看官方文档，多百度，多试验