Chapter 1 Getting Started Guide

1. OpenHarmony 5.0 Release Version Supporting Documentation

OpenHarmony Official APP Development Homepage Address (including complete API reference and Demo):

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

2. OpenHarmony APP Development Tool Download Address:

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

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

For installation and configuration, please refer to the official documentation:

3. OpenHarmony Application Examples

The following website contains official example demos for common application scenarios, which can be referenced for learning based on needs

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

4. OpenHarmony Standard SDK Download Address:

4.1 Standard Path SDK

Generally, manual download is not required. The development tool in step 2 can automatically download the latest release version SDK

5. OpenHarmony Full-SDK Replacement:

Full-SDK is an SDK that provides all OpenHarmony interfaces, including high-privilege APIs required for system applications, used for vendor application development.

Reference document for self-compiling and replacing Full-SDK:

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

6. OS Firmware Burning Guide

Similar to the burning tools and steps for various Android platforms

7. USB Debugging APP Guide

1. Connect the device OTG port to the computer using a USB cable.

2. Add the hdc tool to the environment variable on the computer. Path: your openharmonysdk/10/toolchains,

	For example: D:\\SDK\\OpenHarmony\\sdk\\10\\toolchains

3. Enable USB debugging on the device: Settings --> System --> Developer Options --> USB Debugging.

4. Open the command line tool on the computer, run `hdc list targets`. If connected successfully, it will print the device as follows:

	hdc list targets
    150100414a54443452069035fa308800

8. Common Problems & Solutions

8.1 Selecting OpenHarmony SDK Development Environment

build-profile.json5 declares "runtimeOS": "OpenHarmony"

8.2 Upgrading App to System Permission

Calling system-related APIs such as power.reboot('reboot_test') requires system permission. The information is relatively scattered, and you may encounter some issues. Below are the steps to configure system permission

Upgrading APP to system permission requires modifications in two places: adding requestPermissions in DevEco Studio, and configuring as system in the OpenHarmony SDK. The following uses the reboot interface power.reboot('reboot_test'); as an example.

A. Use the interface in DevEco Studio related business code:

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

B. Add permission ohos.permission.REBOOT in module.json5:

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

C. Modify the UnsgnedReleasedProfileTemplate.json file in OpenHarmony SDK. The file address in this example is:

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

Modify "bundle-name" to the application package name, and apl to "system_core"

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

D. Regenerate the key: DevEco Studio --> Project Structure --> project --> Signing Configs. Note: uncheck Support HarmonyOS, go to the related folder and check the modification time of the newly generated key to confirm if it was regenerated. If not regenerated, delete the old key first, then regenerate.

F. Run the APP. If installed successfully and "reboot failed, err" is not printed, the reboot is successful and the System permission upgrade is complete.

G. System Signature

Find the above file in the sdk directory and modify as follows

9. Note

• Read more official documentation, search more on Baidu, and experiment more

---