HarmonyOS 鸿蒙Next切换应用为系统应用（调试阶段使用）

HarmonyOS 鸿蒙Next切换应用为系统应用（调试阶段使用） 切换应用为系统应用（调试阶段使用）

DevEco Studio 5.0.3.403及之后

1. 安装OpenHarmony SDK。

   在菜单File > Settings中，选择OpenHarmony SDK。

   OpenHarmony SDK安装完成。

2. 打开D:\Huawei\DevEcoStudioSdk\OpenHarmony\Sdk\11\toolchains\lib\UnsgnedReleasedProfileTemplate.json文件。

   {
     "bundle-info": {
       "bundle-name": "com.example.myapplication", // 修改为应用的Bundle名称
       "app-feature": "hos_system_app" // hos_system_app: 系统应用, hos_normal_app: 三方应用（默认值）
     }
   }
   

3. （可选）提升应用的APL等级。当应用使用到权限对应的权限级别为system_basic或者system_core时。此时需要提升应用的APL等级。

   打开D:\Huawei\DevEcoStudioSdk\OpenHarmony\Sdk\11\toolchains\lib\UnsgnedReleasedProfileTemplate.json文件。

   修改bundle-name字段为Demo对应的Bundle名称，并且修改apl参数属性以提升应用的APL等级。

   {
     "bundle-info": {
       "bundle-name": "com.example.myapplication",
       "apl": "system_core",
     }
   }
   

4. 切换应用为OpenHarmony应用。

   {
     "app": {
       "signingConfigs": [],
       "products": [
         {
           "name": "default",
           "signingConfig": "default",
           "compileSdkVersion": 11, // 3. 新增compileSdkVersion字段
           "compatibleSdkVersion": 11, // 2. 修改为数字11/12
           "runtimeOS": "OpenHarmony", // 1. 修改为OpenHarmony
         }
       ],
     }
   }
   

5. 对应用进行签名。

6. 编译HAP包。

7. 通过HDC命令安装HAP到设备中。

8. 效果验证。

   # 1. 连接设备
   # 2. 进入终端Shell
   hdc shell
   # 3. 在终端Shell中执行以下命令打印日志
   bm dump -n com.example.myapplication | grep isSystemApp
   # 4. isSystemApp字段返回值为`true`，则说明当前应用已经设置为系统应用
   

DevEco Studio 4.0.3.300之前

说明

系统应用需要下载Full SDK进行使用，SDK下载参见OpenHarmony SDK转测试版本。

1. 打开D:\Huawei\DevEcoStudioSdk\OpenHarmony\Sdk\10\toolchains\lib\UnsgnedReleasedProfileTemplate.json文件。

   说明：

   需要修改OpenHarmony SDK的Release Profile文件。

   {
     "bundle-info": {
       "bundle-name": "com.example.myapplication", // 修改为应用的Bundle名称
       "app-feature": "hos_system_app" // hos_system_app: 系统应用, hos_normal_app: 三方应用（默认值）
     }
   }
   

2. 打开Project Structure > Signing Configs菜单，去勾选Support HarmonyOS，只勾选Automatically generate signature，对应用进行重新签名。

   说明：

   此步骤是为了将HarmonyOS工程切换为OpenHarmony工程。需要确保在IDE中已经下载了OpenHarmony的SDK，即在File > SDK中，切换到OpenHarmony目录，下载OpenHarmony的SDK。

3. 完成签名之后，Run到设备中。

4. 效果验证。

   # 1. 连接设备
   # 2. 进入终端Shell
   hdc shell
   # 3. 在终端Shell中执行以下命令打印日志
   bm dump -n com.example.myapplication | grep isSystemApp
   # 4. isSystemApp字段返回值为`true`，则说明当前应用已经设置为系统应用
   

日志

• 2024年07月12日01:07:26 补充DevEco Studio 5.0.3.403及之后版本IDE的切换使用方式
• 2023年07月21日18:01:22 补充单框架设备上，在调试阶段将应用切换为系统应用的方式