1# Sdk-Upgrade-Guide
2
3## Overview
4
5This topic walks you through on how to upgrade your existing SDK and make necessary adaptations to your application.
6
7## Upgrade and Adaptation Process
8
9![SDK-GuideMap](figures/SDK-GuideMap.png)
10
11The entire SDK upgrade and adaptation process is divided into five phases:
12
131. Upgrading the SDK: Obtain the latest SDK version and installing the SDK.
14
152. Viewing behavior changes: Read changelogs.
16
173. Verifying the environment: Use DevEco Studio of the latest version for build and verification.
18
194. Making upgrade adaptations: Use the Suap tool to upgrade your application.
20
215. Testing: Use the image of the latest version to test the functions of the upgraded application and new project.
22
23### Upgrading the SDK
24
25You can upgrade the SDK in either of the following ways:
26
27- Trigger automatic upgrade in DevEco Studio.
28- Download the latest SDK version from the official website and upgrade it.
29
30For example, to obtain the SDK version of OpenHarmony-4.0-Beta2, visit [Acquiring Source Code from Mirrors](OpenHarmony-v4.0-beta2.md#acquiring-source-code-from-mirrors).
31
32For details on how to use the full SDK, see [Switching to Full SDK](../application-dev/faqs/full-sdk-switch-guide.md).
33
34After the SDK upgrade, update the **compileSdkVersion** and **compatibleSdkVersion** configuration items in the **build-profile.json5** file of DevEco Studio.
35
36![arkts-basic-grammar](figures/compileSdkVersion.png)
37
38
39### Viewing Behavior Changes
40
41Changelogs are always provided along with each version release on the official website. From these changelogs, you can know the behavior changes and incompatible changes after the upgrade, as well as the change impact and adaptation guide.
42
43Changelogs are archived in the [changelogs](changelogs) folder.
44
45### Verifying the Environment
46
47After you switch to the full SDK of the latest version, an error will be reported when incompatible APIs are being built in DevEco Studio. You are advised to use the latest DevEco Studio for build and verification.
48
49To obtain the latest DevEco Studio version, see [Acquiring the Application Development Tool (HUAWEI DevEco Studio)](../device-dev/get-code/gettools-ide.md#acquiring-the-application-development-tool-huawei-deveco-studio).
50
51### Making Upgrade Adaptations
52
53Incompatible API changes may cause application build failures or event function problems. To quickly adapt to the latest SDK, you are advised to use the Suap tool to upgrade and adapt your application. The Suap tool generates an update report on DevEco Studio. The report contains the changes in the SDK of the new version and the code location. You can click **Locate Code** on DevEco Studio to access the corresponding page and modify your code.
54
55To obtain the Suap tool, search for OpenHarmony SDK Upgrade Assistant in the DevEco Studio plug-in market.
56
57### Testing
58
59After the SDK upgrade and adaptation, download the image of the latest version and perform function tests on the device to ensure that the adaptation is successful. You are advised to use the emulator provided by DevEco Studio to perform the test.
60