# openharmony-edmtest

**Repository Path**: soulforest/openharmony-edmtest

## Basic Information

- **Project Name**: openharmony-edmtest
- **Description**: EDM接口测试应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 24
- **Created**: 2024-02-06
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EDM测试应用
## 1. 目录结构
```
/src/main/ets
├─Application
│      MyAbilityStage.ts
├─common
│      head.ets                     # 页面头部
│      logger.ts                    # hilog日志
├─MainAbility
│      EnterpriseAdminAbility.ts
│      MainAbility.ts
├─module
│      adminManager           │  
│      dateTimeManager        │  
│      deviceControl          │  
│      networkManager         ├─    # 各接口辅助类
│      wifiManager            │
│      wifiManager            │
│      ModuleAdapter.ets            # 接口适配器
│      RequestBody.ets
├─model
│      InterfaceData.ets            # 接口信息类
│      InterfaceDataModels.ets      # 各接口信息
└─pages
        applicationDemo             # 应用管理demo
        interfaceTest               # 接口测试
        index.ets                   # 应用首页
```
## 2. 编译

### 2.1 环境准备

- **IDE**：DevEco Studio（建议最新版本）
- **SDK 版本**：OpenHarmony SDK 26.0.0
- **Node.js**：项目依赖 `@ohos/hypium@1.0.6`，通过 ohpm 管理

### 2.2 替换 SDK 中的 EDM 接口文件

本项目依赖的 `@ohos.enterprise` 相关接口可能尚未包含在当前安装的 SDK 中，需要手动替换：

1. **下载最新的 SDK 接口定义**

   前往 https://gitcode.com/openharmony/interface_sdk-js ，克隆或下载 **master 分支**的最新代码。

2. **替换 `@ohos.enterprise` 接口文件**

   在下载的代码中找到 `@ohos.enterprise` 相关的 `.d.ts` / `.d.ets` 文件，复制到本地 SDK 对应目录中替换：

   ```
   # 本地 SDK 路径（Windows 默认）
   # DevEco Studio 安装目录下的 SDK 路径通常为：
   # <DevEco Studio安装目录>\sdk\HarmonyOS-NEXT\<版本号>\ets\apis\

   # 将下载的 @ohos.enterprise 相关文件替换到：
   # <SDK路径>\ets\apis\@ohos.enterprise\
   ```

3. **替换其他缺少的 SDK 接口文件**

   如果编译时提示其他 `@ohos.*` 模块缺失或类型不匹配，同样从 https://gitcode.com/openharmony/interface_sdk-js 的 master 分支中找到对应模块的文件，替换到本地 SDK 的 `ets/apis/` 目录下。

   > **提示**：编译报错时注意看错误信息中提到的模块名，按需从仓库下载对应文件即可。

### 2.3 编译步骤

1. 使用 DevEco Studio 打开项目根目录
2. 等待 ohpm 自动安装依赖
3. 选择 **Build > Build Hap(s)/APP(s) > Build Hap(s)** 进行编译
4. 编译产物位于 `entry/build/` 目录下
## 3. 增加接口测试方法
1. 在/entry/src/main/ets/model/InterfaceDataModels.ets, interfaceDataJson中添加接口信息
```json
{
    "name": "adminManager",
    "description": "设备管理员管理",
    "methods": [
       {
          "name": "enableAdmin",
          "description": "激活设备管理员应用",
          "parameters": [
             { "name": "admin", "desc": "设备管理员应用" },
             { "name": "enterpriseInfo", "desc": "设备管理员应用的企业信息" },
             { "name": "type", "desc": "激活的设备管理员类型(0x00:普通;0x01:超级)" },
             { "name": "userId", "desc": "用户ID(可选,默认:100)" }
          ]
       }
    ]
}
```
* "name": 接口类/方法名称
* "description": 接口类/方法功能描述
* "parameters": 方法入参
2. 在/entry/src/main/ets/model/InterfaceDetails.ets中
   1. 若方法入参第一次出现，添加方法入参输入框
   2. 在getParams(parameters: any[])方法中, 增加条件分支语句，添加入参
3. 在/entry/src/main/ets/module下添加接口测试辅助类
4. 在/entry/src/main/ets/module/ModuleAdapter.ets中getModuleObj(module)中添加条件分支，导入接口测试辅助类
## 3. 注意事项
   1. 若接口调用需要权限, 需要在module.json中添加相应的应用申请权限
   2. 注意应用权限等级, 若低于申请应用权限所需的等级, 若允许使用ACL方式申请权限, 
需要在\OpenHarmony\Sdk\toolchains\3.2.5.5\lib下的UnsgnedReleasedProfileTemplate.json中acls.allowed-acls中添加申请权限
   ```json
   {
      "acls": {
         "allowed-acls": [
            "ohos.permission.xxx"
         ]
      }
   }
   ```