1# **用户程序框架子系统** 2 3## 简介 4 5用户程序框架子系统是OpenHarmony为开发者提供的一套开发OpenHarmony应用程序的框架。 6 7**包含以下模块：** 8 9- **AppKit：**是用户程序框架提供给开发者的开发包，开发者基于该开发包可以开发出基于Ability组件的应用。 10 11- **AppManagerService：**应用管理服务，用于管理应用运行关系、调度应用进程生命周期及状态的系统服务。 12 13- **BundleManagerService：**是负责管理安装包的系统服务，常见的比如包安装、更新，卸载和包信息查询等，运行在Foundation进程。 14 15应用程序框架子系统架构如下图所示： 16 17 18 19 20 21## 目录 22 23``` 24foundation/appexecfwk/standard 25├── kits 26│ └── appkit # Appkit实现的核心代码 27├── common 28│ └── log # 日志组件目录 29├── interfaces 30│ └── innerkits # 内部接口存放目录 31├── services 32│ ├── appmgr # 用户程序管理服务框架代码 33│ └── bundlemgr # 包管理服务框架代码 34├── test # 测试目录 35└── tools # bm命令存放目录 36``` 37 38### 使用说明 39 40#### 根据给定的bundle名称获取ApplicationInfo 41 42* getApplicationInfo参数描述 43 44 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 45 | ----------- | -------- | ------ | ---- | ------------------------------------------------------- | 46 | bundleName | 只读 | string | 是 | 应用名 | 47 | bundleFlags | 只读 | number | 是 | 0：返回默认app信息<<br/>8：返回包含permissions的app信息 | 48 | userId | 只读 | number | 是 | 用户ID | 49 50* 返回值 51 52 Promise<ApplicationInfo>：返回值为Promise对象，Promise中包含应用信息。 53 54* 示例 55 56``` 57bundle.getApplicationInfo('com.example.myapplicationInstall', 8, 0).then((data) => { 58 console.info("name: for begin"); 59 console.info("name:" + data.name); 60 console.info("bundleName:" + data.bundleName); 61 console.info("description:" + data.description); 62 console.info("descriptionId:" + data.descriptionId); 63 console.info("iconPath:" + data.iconPath); 64 console.info("iconId:" + data.iconId); 65 console.info("label:" + data.label); 66 console.info("labelId:" + data.labelId); 67 console.info("deviceId:" + data.deviceId); 68 console.info("signatureKey:" + data.signatureKey); 69 console.info("process:" + data.process); 70 console.info("isSystemApp:" + data.isSystemApp); 71 console.info("isLauncherApp:" + data.isLauncherApp); 72 console.info("supportedModes:" + data.supportedModes); 73 74 console.info('getApplicationInfo permissions length [' + data.permissions.length + ']'); 75 for (var j = 0; j < data.permissions.length; j++) { 76 console.info("permissions[" + j + "]:" + data.permissions[j]); 77 } 78 console.info('getApplicationInfo moduleSourceDirs length [' + data.moduleSourceDirs.length + ']'); 79 for (var j = 0; j < data.moduleSourceDirs.length; j++) { 80 console.info("moduleSourceDirs[" + j + "]:" + data.moduleSourceDirs[j]); 81 } 82 console.info('getApplicationInfo moduleInfos length [' + data.moduleInfos.length + ']'); 83 for (var j = 0; j < data.moduleInfos.length; j++) { 84 console.info("moduleInfos[" + j + "]moduleName:" + data.moduleInfos[j].moduleName); 85 console.info("moduleInfos[" + j + "]moduleSourceDir:" + data.moduleInfos[j].moduleSourceDir); 86 } 87 console.info("entryDir:" + data.entryDir); 88 console.info("codePath:" + data.codePath); 89 console.info("dataDir:" + data.dataDir); 90 console.info("dataBaseDir:" + data.dataBaseDir); 91 console.info("cacheDir:" + data.cacheDir); 92}) 93``` 94根据给定的bundle名称获取ApplicationInfo（callback方式） 95 96* getApplicationInfo参数描述 97 98 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 99 | ----------- | -------- | ------------------------------ | ---- | ------------------------------------------------------- | 100 | bundleName | 只读 | string | 是 | 应用名 | 101 | bundleFlags | 只读 | number | 是 | 0：返回默认app信息<<br/>8：返回包含permissions的app信息 | 102 | userId | 只读 | number | 是 | 用户ID | 103 | callback | 只读 | AsyncCallback<ApplicationInfo> | 是 | 回调方法 | 104 105* 返回值 106 107 void 108 109* 示例 110 111``` 112bundle.getApplicationInfo('com.example.myapplicationInstall', 8, 0, OnReceiveEvent); 113 114function OnReceiveEvent(err, data) { 115 console.info("name: for begin"); 116 console.info("name:" + data.name); 117 console.info("bundleName:" + data.bundleName); 118 console.info("description:" + data.description); 119 console.info("descriptionId:" + data.descriptionId); 120 console.info("iconPath:" + data.iconPath); 121 console.info("iconId:" + data.iconId); 122 console.info("label:" + data.label); 123 console.info("labelId:" + data.labelId); 124 console.info("deviceId:" + data.deviceId); 125 console.info("signatureKey:" + data.signatureKey); 126 console.info("process:" + data.process); 127 console.info("isSystemApp:" + data.isSystemApp); 128 console.info("isLauncherApp:" + data.isLauncherApp); 129 console.info("supportedModes:" + data.supportedModes); 130 131 console.info('getApplicationInfo permissions length [' + data.permissions.length + ']'); 132 for (var j = 0; j < data.permissions.length; j++) { 133 console.info("permissions[" + j + "]:" + data.permissions[j]); 134 } 135 console.info('getApplicationInfo moduleSourceDirs length [' + data.moduleSourceDirs.length + ']'); 136 for (var j = 0; j < data.moduleSourceDirs.length; j++) { 137 console.info("moduleSourceDirs[" + j + "]:" + data.moduleSourceDirs[j]); 138 } 139 console.info('getApplicationInfo moduleInfos length [' + data.moduleInfos.length + ']'); 140 for (var j = 0; j < data.moduleInfos.length; j++) { 141 console.info("moduleInfos[" + j + "]moduleName:" + data.moduleInfos[j].moduleName); 142 console.info("moduleInfos[" + j + "]moduleSourceDir:" + data.moduleInfos[j].moduleSourceDir); 143 } 144 console.info("entryDir:" + data.entryDir); 145 console.info("codePath:" + data.codePath); 146 console.info("dataDir:" + data.dataDir); 147 console.info("dataBaseDir:" + data.dataBaseDir); 148 console.info("cacheDir:" + data.cacheDir); 149} 150``` 151 152#### 获取系统中所有可用的包信息 153 154* getAllBundleInfo参数描述 155 156 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 157 | ---------- | -------- | ---------- | ---- | ----------------------------------------------------------- | 158 | bundleFlag | 只读 | BundleFlag | 是 | 0：返回默认BundleInfo<br>1：返回包含abilityInfo的BundleInfo | 159 160* 返回值 161 162 Promise<Array<BundleInfo>>：返回值为Promise对象，Promise中包含包信息列表。 163 164* 示例 165 166``` 167bundle.getAllBundleInfo(0).then((data) => { 168 for (var i = 0; i < data.length; i++) { 169 console.info("index[" + i + "].name: for begin"); 170 console.info("index[" + i + "].name:" + data[i].name); 171 console.info("index[" + i + "].label:" + data[i].label); 172 console.info("index[" + i + "].description:" + data[i].description); 173 console.info("index[" + i + "].vendor:" + data[i].vendor); 174 console.info("index[" + i + "].versionCode:" + data[i].versionCode); 175 console.info("index[" + i + "].versionName:" + data[i].versionName); 176 console.info("index[" + i + "].jointUserId:" + data[i].jointUserId); 177 console.info("index[" + i + "].minSdkVersion:" + data[i].minSdkVersion); 178 console.info("index[" + i + "].maxSdkVersion:" + data[i].maxSdkVersion); 179 console.info("index[" + i + "].mainEntry:" + data[i].mainEntry); 180 console.info("index[" + i + "].cpuAbi:" + data[i].cpuAbi); 181 console.info("index[" + i + "].appId:" + data[i].appId); 182 console.info("index[" + i + "].compatibleVersion:" + data[i].compatibleVersion); 183 console.info("index[" + i + "].targetVersion:" + data[i].targetVersion); 184 console.info("index[" + i + "].releaseType:" + data[i].releaseType); 185 console.info("index[" + i + "].uid:" + data[i].uid); 186 console.info("index[" + i + "].gid:" + data[i].gid); 187 console.info("index[" + i + "].seInfo:" + data[i].seInfo); 188 console.info("index[" + i + "].entryModuleName:" + data[i].entryModuleName); 189 console.info("index[" + i + "].isKeepAlive:" + data[i].isKeepAlive); 190 console.info("index[" + i + "].isNativeApp:" + data[i].isNativeApp); 191 console.info("index[" + i + "].installTime:" + data[i].installTime); 192 console.info("index[" + i + "].updateTime:" + data[i].updateTime); 193 console.info("index[" + i + "].appInfo.name:" + data[i].applicationInfo.name); 194 console.info("index[" + i + "].appInfo.bundleName:" + data[i].applicationInfo.bundleName); 195 console.info('getAllBundleInfo reqPermissions length [' + data[i].reqPermissions.length + ']'); 196 for (var j = 0; j < data[i].reqPermissions.length; j++) { 197 console.info("index[" + i + "]reqPermissions[" + j + "]:" + data[i].reqPermissions[j]); 198 } 199 console.info('getAllBundleInfo defPermissions length [' + data[i].defPermissions.length + ']'); 200 for (var j = 0; j < data[i].defPermissions.length; j++) { 201 console.info("index[" + i + "]defPermissions[" + j + "]:" + data[i].defPermissions[j]); 202 } 203 204 console.info('getAllBundleInfo hapModuleNames length [' + data[i].hapModuleNames.length + ']'); 205 for (var j = 0; j < data[i].hapModuleNames.length; j++) { 206 console.info("index[" + i + "]hapModuleNames[" + j + "]:" + data[i].hapModuleNames[j]); 207 } 208 console.info('getAllBundleInfo moduleNames length [' + data[i].moduleNames.length + ']'); 209 for (var j = 0; j < data[i].moduleNames.length; j++) { 210 console.info("index[" + i + "]moduleNames[" + j + "]:" + data[i].moduleNames[j]); 211 } 212 console.info('getAllBundleInfo modulePublicDirs length [' + data[i].modulePublicDirs.length + ']'); 213 for (var j = 0; j < data[i].modulePublicDirs.length; j++) { 214 console.info("index[" + i + "]modulePublicDirs[" + j + "]:" + data[i].modulePublicDirs[j]); 215 } 216 console.info('getAllBundleInfo moduleDirs length [' + data[i].moduleDirs.length + ']'); 217 for (var j = 0; j < data[i].moduleDirs.length; j++) { 218 console.info("index[" + i + "]moduleDirs[" + j + "]:" + data[i].moduleDirs[j]); 219 } 220 console.info('getAllBundleInfo moduleResPaths length [' + data[i].moduleResPaths.length + ']'); 221 for (var j = 0; j < data[i].moduleResPaths.length; j++) { 222 console.info("index[" + i + "]moduleResPaths[" + j + "]:" + data[i].moduleResPaths[j]); 223 } 224 console.info('getAllBundleInfo abilityInfo length [' + data[i].abilityInfos.length + ']'); 225 for (var j = 0; j < data[i].abilityInfos.length; j++) { 226 console.info("index[" + i + "]abilityInfos[" + j + "]name:" + data[i].abilityInfos[j].name); 227 console.info("index[" + i + "]abilityInfos[" + j + "]package:" + data[i].abilityInfos[j].package); 228 } 229 } 230}) 231``` 232 233获取系统中所有可用的包信息（callback形式） 234 235* getAllBundleInfo参数描述 236 237 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 238 | ---------- | -------- | -------------------------------- | ---- | ------------------------------------------------------------ | 239 | bundleFlag | 只读 | BundleFlag | 是 | 0：返回默认BundleInfo<br/>1：返回包含abilityInfo的BundleInfo | 240 | callback | 只读 | AsyncCallback<Array<BundleInfo>> | 是 | 回调方法 | 241 242* 返回值 243 244 void 245 246* 示例 247 248``` 249bundle.getAllBundleInfo(0, OnReceiveEvent); 250 251function OnReceiveEvent(err, data) { 252 console.info('xxx getAllBundleInfo data length [' + data.length + ']'); 253 for (var i = 0; i < data.length; i++) { 254 console.info("index[" + i + "].name: for begin"); 255 console.info("index[" + i + "].name:" + data[i].name); 256 console.info("index[" + i + "].label:" + data[i].label); 257 console.info("index[" + i + "].description:" + data[i].description); 258 console.info("index[" + i + "].vendor:" + data[i].vendor); 259 console.info("index[" + i + "].versionCode:" + data[i].versionCode); 260 console.info("index[" + i + "].versionName:" + data[i].versionName); 261 console.info("index[" + i + "].jointUserId:" + data[i].jointUserId); 262 console.info("index[" + i + "].minSdkVersion:" + data[i].minSdkVersion); 263 console.info("index[" + i + "].maxSdkVersion:" + data[i].maxSdkVersion); 264 console.info("index[" + i + "].mainEntry:" + data[i].mainEntry); 265 console.info("index[" + i + "].cpuAbi:" + data[i].cpuAbi); 266 console.info("index[" + i + "].appId:" + data[i].appId); 267 console.info("index[" + i + "].compatibleVersion:" + data[i].compatibleVersion); 268 console.info("index[" + i + "].targetVersion:" + data[i].targetVersion); 269 console.info("index[" + i + "].releaseType:" + data[i].releaseType); 270 console.info("index[" + i + "].uid:" + data[i].uid); 271 console.info("index[" + i + "].gid:" + data[i].gid); 272 console.info("index[" + i + "].seInfo:" + data[i].seInfo); 273 console.info("index[" + i + "].entryModuleName:" + data[i].entryModuleName); 274 console.info("index[" + i + "].isKeepAlive:" + data[i].isKeepAlive); 275 console.info("index[" + i + "].isNativeApp:" + data[i].isNativeApp); 276 console.info("index[" + i + "].installTime:" + data[i].installTime); 277 console.info("index[" + i + "].updateTime:" + data[i].updateTime); 278 console.info("index[" + i + "].appInfo.name:" + data[i].applicationInfo.name); 279 console.info("index[" + i + "].appInfo.bundleName:" + data[i].applicationInfo.bundleName); 280 console.info('getAllBundleInfo reqPermissions length [' + data[i].reqPermissions.length + ']'); 281 for (var j = 0; j < data[i].reqPermissions.length; j++) { 282 console.info("index[" + i + "]reqPermissions[" + j + "]:" + data[i].reqPermissions[j]); 283 } 284 console.info('getAllBundleInfo defPermissions length [' + data[i].defPermissions.length + ']'); 285 for (var j = 0; j < data[i].defPermissions.length; j++) { 286 console.info("index[" + i + "]defPermissions[" + j + "]:" + data[i].defPermissions[j]); 287 } 288 289 console.info('getAllBundleInfo hapModuleNames length [' + data[i].hapModuleNames.length + ']'); 290 for (var j = 0; j < data[i].hapModuleNames.length; j++) { 291 console.info("index[" + i + "]hapModuleNames[" + j + "]:" + data[i].hapModuleNames[j]); 292 } 293 console.info('getAllBundleInfo moduleNames length [' + data[i].moduleNames.length + ']'); 294 for (var j = 0; j < data[i].moduleNames.length; j++) { 295 console.info("index[" + i + "]moduleNames[" + j + "]:" + data[i].moduleNames[j]); 296 } 297 console.info('getAllBundleInfo modulePublicDirs length [' + data[i].modulePublicDirs.length + ']'); 298 for (var j = 0; j < data[i].modulePublicDirs.length; j++) { 299 console.info("index[" + i + "]modulePublicDirs[" + j + "]:" + data[i].modulePublicDirs[j]); 300 } 301 console.info('getAllBundleInfo moduleDirs length [' + data[i].moduleDirs.length + ']'); 302 for (var j = 0; j < data[i].moduleDirs.length; j++) { 303 console.info("index[" + i + "]moduleDirs[" + j + "]:" + data[i].moduleDirs[j]); 304 } 305 console.info('getAllBundleInfo moduleResPaths length [' + data[i].moduleResPaths.length + ']'); 306 for (var j = 0; j < data[i].moduleResPaths.length; j++) { 307 console.info("index[" + i + "]moduleResPaths[" + j + "]:" + data[i].moduleResPaths[j]); 308 } 309 console.info('getAllBundleInfo abilityInfo length [' + data[i].abilityInfos.length + ']'); 310 for (var j = 0; j < data[i].abilityInfos.length; j++) { 311 console.info("index[" + i + "]abilityInfos[" + j + "]name:" + data[i].abilityInfos[j].name); 312 console.info("index[" + i + "]abilityInfos[" + j + "]package:" + data[i].abilityInfos[j].package); 313 } 314 } 315} 316``` 317 318#### 根据bundle名称获取BundleInfo 319 320* getBundleInfo参数描述 321 322 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 323 | ----------- | -------- | ------ | ---- | ------------------------------------------------------------ | 324 | bundleName | 只读 | string | 是 | 包名 | 325 | bundleFlags | 只读 | number | 是 | 0：返回默认BundleInfo<br/>1：返回包含abilityInfo的BundleInfo | 326 327* 返回值 328 329 Promise<BundleInfo>：返回值为Promise对象，Promise中包含包信息。 330 331* 示例 332 333``` 334bundle.getBundleInfo('com.example.myapplicationInstall', 1).then((data) => { 335 console.info("name:" + data.name); 336 console.info("label:" + data.label); 337 console.info("description:" + data.description); 338 console.info("vendor:" + data.vendor); 339 console.info("versionCode:" + data.versionCode); 340 console.info("versionName:" + data.versionName); 341 console.info("jointUserId:" + data.jointUserId); 342 console.info("minSdkVersion:" + data.minSdkVersion); 343 console.info("maxSdkVersion:" + data.maxSdkVersion); 344 console.info("mainEntry:" + data.mainEntry); 345 console.info("cpuAbi:" + data.cpuAbi); 346 console.info("appId:" + data.appId); 347 console.info("compatibleVersion:" + data.compatibleVersion); 348 console.info("targetVersion:" + data.targetVersion); 349 console.info("releaseType:" + data.releaseType); 350 console.info("uid:" + data.uid); 351 console.info("gid:" + data.gid); 352 console.info("seInfo:" + data.seInfo); 353 console.info("entryModuleName:" + data.entryModuleName); 354 console.info("isKeepAlive:" + data.isKeepAlive); 355 console.info("isNativeApp:" + data.isNativeApp); 356 console.info("installTime:" + data.installTime); 357 console.info("updateTime:" + data.updateTime); 358 console.info("appInfo.name:" + data.applicationInfo.name); 359 console.info("appInfo.bundleName:" + data.applicationInfo.bundleName); 360 console.info('getBundleInfo reqPermissions length [' + data.reqPermissions.length + ']'); 361 for (var j = 0; j < data.reqPermissions.length; j++) { 362 console.info("reqPermissions[" + j + "]:" + data.reqPermissions[j]); 363 } 364 console.info('getBundleInfo defPermissions length [' + data.defPermissions.length + ']'); 365 for (var j = 0; j < data.defPermissions.length; j++) { 366 console.info("defPermissions[" + j + "]:" + data.defPermissions[j]); 367 } 368 369 console.info('getBundleInfo hapModuleNames length [' + data.hapModuleNames.length + ']'); 370 for (var j = 0; j < data.hapModuleNames.length; j++) { 371 console.info("hapModuleNames[" + j + "]:" + data.hapModuleNames[j]); 372 } 373 console.info('getBundleInfo moduleNames length [' + data.moduleNames.length + ']'); 374 for (var j = 0; j < data.moduleNames.length; j++) { 375 console.info("moduleNames[" + j + "]:" + data.moduleNames[j]); 376 } 377 console.info('getBundleInfo modulePublicDirs length [' + data.modulePublicDirs.length + ']'); 378 for (var j = 0; j < data.modulePublicDirs.length; j++) { 379 console.info("modulePublicDirs[" + j + "]:" + data.modulePublicDirs[j]); 380 } 381 console.info('getBundleInfo moduleDirs length [' + data.moduleDirs.length + ']'); 382 for (var j = 0; j < data.moduleDirs.length; j++) { 383 console.info("moduleDirs[" + j + "]:" + data.moduleDirs[j]); 384 } 385 console.info('getBundleInfo moduleResPaths length [' + data.moduleResPaths.length + ']'); 386 for (var j = 0; j < data.moduleResPaths.length; j++) { 387 console.info("moduleResPaths[" + j + "]:" + data.moduleResPaths[j]); 388 } 389 console.info('getBundleInfo abilityInfo length [' + data.abilityInfos.length + ']'); 390 for (var j = 0; j < data.abilityInfos.length; j++) { 391 console.info("abilityInfos[" + j + "]name:" + data.abilityInfos[j].name); 392 console.info("abilityInfos[" + j + "]package:" + data.abilityInfos[j].package); 393 } 394}) 395``` 396 397根据bundle名称获取BundleInfo（callback形式） 398 399* getBundleInfo参数描述 400 401 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 402 | ----------- | -------- | ------------------------- | ---- | ------------------------------------------------------------ | 403 | bundleName | 只读 | string | 是 | 包名 | 404 | bundleFlags | 只读 | number | 是 | 0：返回默认BundleInfo<br/>1：返回包含abilityInfo的BundleInfo | 405 | callback | 只读 | AsyncCallback<BundleInfo> | 是 | 回调方法 | 406 407* 返回值 408 409 void 410 411* 示例 412 413``` 414bundle.getBundleInfo('com.example.myapplicationInstall', 1, OnReceiveEvent); 415 416function OnReceiveEvent(err, data) { 417 console.info("name:" + data.name); 418 console.info("label:" + data.label); 419 console.info("description:" + data.description); 420 console.info("vendor:" + data.vendor); 421 console.info("versionCode:" + data.versionCode); 422 console.info("versionName:" + data.versionName); 423 console.info("jointUserId:" + data.jointUserId); 424 console.info("minSdkVersion:" + data.minSdkVersion); 425 console.info("maxSdkVersion:" + data.maxSdkVersion); 426 console.info("mainEntry:" + data.mainEntry); 427 console.info("cpuAbi:" + data.cpuAbi); 428 console.info("appId:" + data.appId); 429 console.info("compatibleVersion:" + data.compatibleVersion); 430 console.info("targetVersion:" + data.targetVersion); 431 console.info("releaseType:" + data.releaseType); 432 console.info("uid:" + data.uid); 433 console.info("gid:" + data.gid); 434 console.info("seInfo:" + data.seInfo); 435 console.info("entryModuleName:" + data.entryModuleName); 436 console.info("isKeepAlive:" + data.isKeepAlive); 437 console.info("isNativeApp:" + data.isNativeApp); 438 console.info("installTime:" + data.installTime); 439 console.info("updateTime:" + data.updateTime); 440 console.info("appInfo.name:" + data.applicationInfo.name); 441 console.info("appInfo.bundleName:" + data.applicationInfo.bundleName); 442 console.info('getBundleInfo reqPermissions length [' + data.reqPermissions.length + ']'); 443 for (var j = 0; j < data.reqPermissions.length; j++) { 444 console.info("reqPermissions[" + j + "]:" + data.reqPermissions[j]); 445 } 446 console.info('getBundleInfo defPermissions length [' + data.defPermissions.length + ']'); 447 for (var j = 0; j < data.defPermissions.length; j++) { 448 console.info("defPermissions[" + j + "]:" + data.defPermissions[j]); 449 } 450 451 console.info('getBundleInfo hapModuleNames length [' + data.hapModuleNames.length + ']'); 452 for (var j = 0; j < data.hapModuleNames.length; j++) { 453 console.info("hapModuleNames[" + j + "]:" + data.hapModuleNames[j]); 454 } 455 console.info('getBundleInfo moduleNames length [' + data.moduleNames.length + ']'); 456 for (var j = 0; j < data.moduleNames.length; j++) { 457 console.info("moduleNames[" + j + "]:" + data.moduleNames[j]); 458 } 459 console.info('getBundleInfo modulePublicDirs length [' + data.modulePublicDirs.length + ']'); 460 for (var j = 0; j < data.modulePublicDirs.length; j++) { 461 console.info("modulePublicDirs[" + j + "]:" + data.modulePublicDirs[j]); 462 } 463 console.info('getBundleInfo moduleDirs length [' + data.moduleDirs.length + ']'); 464 for (var j = 0; j < data.moduleDirs.length; j++) { 465 console.info("moduleDirs[" + j + "]:" + data.moduleDirs[j]); 466 } 467 console.info('getBundleInfo moduleResPaths length [' + data.moduleResPaths.length + ']'); 468 for (var j = 0; j < data.moduleResPaths.length; j++) { 469 console.info("moduleResPaths[" + j + "]:" + data.moduleResPaths[j]); 470 } 471 console.info('getBundleInfo abilityInfo length [' + data.abilityInfos.length + ']'); 472 for (var j = 0; j < data.abilityInfos.length; j++) { 473 console.info("abilityInfos[" + j + "]name:" + data.abilityInfos[j].name); 474 console.info("abilityInfos[" + j + "]package:" + data.abilityInfos[j].package); 475 } 476} 477``` 478 479#### 获取指定用户下所有已安装的应用信息 480 481* getAllApplicationInfo参数描述 482 483 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 484 | ----------- | -------- | ------ | ---- | ------------------------------------------------------- | 485 | bundleFlags | 只读 | number | 是 | 0：返回默认app信息<<br/>8：返回包含permissions的app信息 | 486 | userId | 只读 | number | 是 | 用户ID | 487 488* 返回值 489 490 Promise<Array<ApplicationInfo>>：返回值为Promise对象，Promise中包含应用信息列表。 491 492* 示例 493 494``` 495bundle.getAllApplicationInfo(8, 0).then((data) => { 496 console.info('xxx getAllApplicationInfo data length [' + data.length + ']'); 497 for (var i = 0; i < data.length; i++) { 498 console.info("index[" + i + "].name: for begin"); 499 console.info("index[" + i + "].name:" + data[i].name); 500 console.info("index[" + i + "].bundleName:" + data[i].bundleName); 501 console.info("index[" + i + "].description:" + data[i].description); 502 console.info("index[" + i + "].descriptionId:" + data[i].descriptionId); 503 console.info("index[" + i + "].iconPath:" + data[i].iconPath); 504 console.info("index[" + i + "].iconId:" + data[i].iconId); 505 console.info("index[" + i + "].label:" + data[i].label); 506 console.info("index[" + i + "].labelId:" + data[i].labelId); 507 console.info("index[" + i + "].deviceId:" + data[i].deviceId); 508 console.info("index[" + i + "].signatureKey:" + data[i].signatureKey); 509 console.info("index[" + i + "].process:" + data[i].process); 510 console.info("index[" + i + "].isSystemApp:" + data[i].isSystemApp); 511 console.info("index[" + i + "].isLauncherApp:" + data[i].isLauncherApp); 512 console.info("index[" + i + "].supportedModes:" + data[i].supportedModes); 513 514 console.info('getAllApplicationInfo Async permissions length [' + data[i].permissions.length + ']'); 515 for (var j = 0; j < data[i].permissions.length; j++) { 516 console.info("index[" + i + "]permissions[" + j + "]:" + data[i].permissions[j]); 517 } 518 console.info('getAllApplicationInfo Async moduleSourceDirs length [' + data[i].moduleSourceDirs.length + ']'); 519 for (var j = 0; j < data[i].moduleSourceDirs.length; j++) { 520 console.info("index[" + i + "]moduleSourceDirs[" + j + "]:" + data[i].moduleSourceDirs[j]); 521 } 522 console.info('getAllApplicationInfo Async moduleInfos length [' + data[i].moduleInfos.length + ']'); 523 for (var j = 0; j < data[i].moduleInfos.length; j++) { 524 console.info("index[" + i + "]moduleInfos[" + j + "]moduleName:" + data[i].moduleInfos[j].moduleName); 525 console.info("index[" + i + "]moduleInfos[" + j + "]moduleSourceDir:" + data[i].moduleInfos[j].moduleSourceDir); 526 } 527 console.info("index[" + i + "].entryDir:" + data[i].entryDir); 528 console.info("index[" + i + "].codePath:" + data[i].codePath); 529 console.info("index[" + i + "].dataDir:" + data[i].dataDir); 530 console.info("index[" + i + "].dataBaseDir:" + data[i].dataBaseDir); 531 console.info("index[" + i + "].cacheDir:" + data[i].cacheDir); 532 } 533}) 534``` 535 536获取指定用户下所有已安装的应用信息（callback形式） 537 538* getAllApplicationInfo参数描述 539 540 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 541 | ----------- | -------- | ------------------------------------- | ---- | ------------------------------------------------------- | 542 | bundleFlags | 只读 | number | 是 | 0：返回默认app信息<<br/>8：返回包含permissions的app信息 | 543 | userId | 只读 | number | 是 | 用户ID | 544 | callback | 只读 | AsyncCallback<Array<ApplicationInfo>> | 是 | 回调方法 | 545 546* 返回值 547 548 void 549 550* 示例 551 552``` 553bundle.getAllApplicationInfo(8, 0, OnReceiveEvent); 554 555function OnReceiveEvent(err, data) { 556 console.info('xxx getAllApplicationInfo data length [' + data.length + ']'); 557 for (var i = 0; i < data.length; i++) { 558 console.info("index[" + i + "].name: for begin"); 559 console.info("index[" + i + "].name:" + data[i].name); 560 console.info("index[" + i + "].bundleName:" + data[i].bundleName); 561 console.info("index[" + i + "].description:" + data[i].description); 562 console.info("index[" + i + "].descriptionId:" + data[i].descriptionId); 563 console.info("index[" + i + "].iconPath:" + data[i].iconPath); 564 console.info("index[" + i + "].iconId:" + data[i].iconId); 565 console.info("index[" + i + "].label:" + data[i].label); 566 console.info("index[" + i + "].labelId:" + data[i].labelId); 567 console.info("index[" + i + "].deviceId:" + data[i].deviceId); 568 console.info("index[" + i + "].signatureKey:" + data[i].signatureKey); 569 console.info("index[" + i + "].process:" + data[i].process); 570 console.info("index[" + i + "].isSystemApp:" + data[i].isSystemApp); 571 console.info("index[" + i + "].isLauncherApp:" + data[i].isLauncherApp); 572 console.info("index[" + i + "].supportedModes:" + data[i].supportedModes); 573 574 console.info('getAllApplicationInfo Async permissions length [' + data[i].permissions.length + ']'); 575 for (var j = 0; j < data[i].permissions.length; j++) { 576 console.info("index[" + i + "]permissions[" + j + "]:" + data[i].permissions[j]); 577 } 578 console.info('getAllApplicationInfo Async moduleSourceDirs length [' + data[i].moduleSourceDirs.length + ']'); 579 for (var j = 0; j < data[i].moduleSourceDirs.length; j++) { 580 console.info("index[" + i + "]moduleSourceDirs[" + j + "]:" + data[i].moduleSourceDirs[j]); 581 } 582 console.info('getAllApplicationInfo Async moduleInfos length [' + data[i].moduleInfos.length + ']'); 583 for (var j = 0; j < data[i].moduleInfos.length; j++) { 584 console.info("index[" + i + "]moduleInfos[" + j + "]moduleName:" + data[i].moduleInfos[j].moduleName); 585 console.info("index[" + i + "]moduleInfos[" + j + "]moduleSourceDir:" + data[i].moduleInfos[j].moduleSourceDir); 586 } 587 console.info("index[" + i + "].entryDir:" + data[i].entryDir); 588 console.info("index[" + i + "].codePath:" + data[i].codePath); 589 console.info("index[" + i + "].dataDir:" + data[i].dataDir); 590 console.info("index[" + i + "].dataBaseDir:" + data[i].dataBaseDir); 591 console.info("index[" + i + "].cacheDir:" + data[i].cacheDir); 592 } 593} 594``` 595 596 597#### 通过Want获取对应的Ability信息 598 599* queryAbilityInfo参数描述 600 601 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 602 | ----------- | -------- | ------ | ---- | ------------------------------------------------------------ | 603 | want | 只读 | Want | 是 | 指定Want信息 | 604 | bundleFlags | 只读 | number | 是 | 0：返回默认BundleInfo<br/>1：返回包含abilityInfo的BundleInfo | 605 | userId | 只读 | number | 是 | 用户ID | 606 607* Want类型说明 608 609 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 610 | ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | 611 | elementName | 只读 | ElementName | 是 | 表示运行指定Ability的ElementName。 | 612 | uri | 只读 | string | 否 | 表示Uri描述。 | 613 | flags | 只读 | int | 否 | Ability的flag，表示处理Want的方式。 | 614 | type | 只读 | string | 否 | Want中的type属性是指由Want的URI所指示的资源的MIME类型。 | 615 | action | 只读 | string | 否 | 表示动作，通常使用系统预置Action，应用也可以自定义Action。 | 616 | want_param | 只读 | {[key: string]: any} | 否 | want_param是一种支持自定义的数据结构，开发者可以通过want_param传递某些请求所需的额外信息。 | 617 | entities | 只读 | Array<string> | 否 | 表示类别，通常使用系统预置Entity，应用也可以自定义Entity。 | 618 619* ElementName类型说明 620 621 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 622 | ----------- | -------- | ------ | ---- | ------------------------------------------------------------ | 623 | deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 | 624 | bundleName | 只读 | string | 是 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | 625 | abilityName | 只读 | string | 是 | 表示待启动的Ability名称。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | 626 627* 返回值 628 629 Promise<AbilityInfo>：返回值为Promise对象，Promise中包含Ability信息。 630 631* 示例 632 633``` 634bundle.queryAbilityByWant({ 635 want: { 636 action: "action.system.home", 637 entities: ["entity.system.home"], 638 elementName: { 639 deviceId: "0", 640 bundleName: "com.example.myapplicationInstall", 641 abilityName: "com.example.myapplication.MainAbility", 642 }, 643 } 644}, 1, 0, 645}).then((data) => { 646 console.info("name:" + data.name); 647 console.info("label:" + data.label); 648 console.info("description:" + data.description); 649 console.info("iconPath:" + data.iconPath); 650 console.info("visible:" + data.visible); 651 console.info("kind:" + data.kind); 652 console.info("uri:" + data.uri); 653 console.info("process:" + data.process); 654 console.info("package:" + data.package); 655 console.info("bundleName:" + data.bundleName); 656 console.info("moduleName:" + data.moduleName); 657 console.info("applicationName:" + data.applicationName); 658 console.info("deviceId:" + data.deviceId); 659 console.info("codePath:" + data.codePath); 660 console.info("resourcePath:" + data.resourcePath); 661 console.info("libPath:" + data.libPath); 662 663 console.info('queryAbilityInfo permissions length [' + data.permissions.length + ']'); 664 for (var j = 0; j < data.permissions.length; j++) { 665 console.info("permissions[" + j + "]:" + data.permissions[j]); 666 } 667 console.info('queryAbilityInfo deviceTypes length [' + data.deviceTypes.length + ']'); 668 for (var j = 0; j < data.deviceTypes.length; j++) { 669 console.info("deviceTypes[" + j + "]:" + data.deviceTypes[j]); 670 } 671 console.info('queryAbilityInfo deviceCapabilities length [' + data.deviceCapabilities.length + ']'); 672 for (var j = 0; j < data.deviceCapabilities.length; j++) { 673 console.info("deviceCapabilities[" + j + "]:" + data.deviceCapabilities[j]); 674 } 675 console.info("appInfo.name:" + data.applicationInfo.name); 676 console.info("appInfo.bundleName:" + data.applicationInfo.bundleName); 677 // ability type: 0:UNKNOWN, 1:PAGE, 2:SERVICE, 3:DATA 678 console.info("type:" + data.type); 679 // orientation: 0:UNSPECIFIED, 1:LANDSCAPE, 2:PORTRAIT, 3:FOLLOWRECENT, 680 console.info("orientation:" + data.orientation); 681 // launchMode: 0:SINGLETON, 1:SINGLETOP, 2:STANDARD 682 console.info("launchMode:" + data.launchMode); 683 684 // the enum of AbilityType 685 console.info("AbilityType:" + bundle.AbilityType.UNKNOWN); 686 console.info("AbilityType:" + bundle.AbilityType.PAGE); 687 console.info("AbilityType:" + bundle.AbilityType.SERVICE); 688 console.info("AbilityType:" + bundle.AbilityType.DATA); 689 if (data.type == bundle.AbilityType.PAGE) { 690 console.info("this AbilityType is PAGE"); 691 } 692 // the enum of DisplayOrientation 693 console.info("DisplayOrientation:" + bundle.DisplayOrientation.UNSPECIFIED); 694 console.info("DisplayOrientation:" + bundle.DisplayOrientation.LANDSCAPE); 695 console.info("DisplayOrientation:" + bundle.DisplayOrientation.PORTRAIT); 696 console.info("DisplayOrientation:" + bundle.DisplayOrientation.FOLLOWRECENT); 697 if (data.orientation == bundle.DisplayOrientation.UNSPECIFIED) { 698 console.info("this DisplayOrientation is UNSPECIFIED"); 699 } 700 // the enum of LaunchMode 701 console.info("LaunchMode:" + bundle.LaunchMode.SINGLETON); 702 console.info("LaunchMode:" + bundle.LaunchMode.SINGLETOP); 703 console.info("LaunchMode:" + bundle.LaunchMode.STANDARD); 704 if (data.launchMode == bundle.LaunchMode.STANDARD) { 705 console.info("this LaunchMode is STANDARD"); 706 } 707 708}) 709``` 710 711通过Want获取对应的Ability信息（callback形式） 712 713* queryAbilityInfo参数描述 714 715 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 716 | ----------- | -------- | --------------------------------- | ---- | ------------------------------------------------------------ | 717 | want | 只读 | Want | 是 | 指定Want信息 | 718 | bundleFlags | 只读 | number | 是 | 0：返回默认BundleInfo<br/>1：返回包含abilityInfo的BundleInfo | 719 | userId | 只读 | number | 是 | 用户ID | 720 | callback | 只读 | AsyncCallback<Array<AbilityInfo>> | 是 | 回调方法 | 721 722* Want类型说明 723 724 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 725 | ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ | 726 | elementName | 只读 | ElementName | 是 | 表示运行指定Ability的ElementName。 | 727 | uri | 只读 | string | 否 | 表示Uri描述。 | 728 | flags | 只读 | int | 否 | Ability的flag，表示处理Want的方式。 | 729 | type | 只读 | string | 否 | Want中的type属性是指由Want的URI所指示的资源的MIME类型。 | 730 | action | 只读 | string | 否 | 表示动作，通常使用系统预置Action，应用也可以自定义Action。 | 731 | want_param | 只读 | {[key: string]: any} | 否 | want_param是一种支持自定义的数据结构，开发者可以通过want_param传递某些请求所需的额外信息。 | 732 | entities | 只读 | Array<string> | 否 | 表示类别，通常使用系统预置Entity，应用也可以自定义Entity。 | 733 734* ElementName类型说明 735 736 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 737 | ----------- | -------- | ------ | ---- | ------------------------------------------------------------ | 738 | deviceId | 只读 | string | 否 | 表示运行指定Ability的设备ID。 | 739 | bundleName | 只读 | string | 是 | 表示包描述。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | 740 | abilityName | 只读 | string | 是 | 表示待启动的Ability名称。如果在Want中同时指定了BundleName和AbilityName，则Want可以直接匹配到指定的Ability。 | 741 742* 返回值 743 744 void 745 746* 示例 747 748``` 749bundle.queryAbilityByWant( 750 { 751 want: { 752 action: "action.system.home", 753 entities: ["entity.system.home"], 754 elementName: { 755 deviceId: "0", 756 bundleName: "com.example.myapplicationInstall", 757 abilityName: "com.example.myapplication.MainAbility", 758 }, 759 } 760 }, 1, 0, 761 }, OnReceiveEvent); 762 763function OnReceiveEvent(err, data) { 764 console.info("name:" + data.name); 765 console.info("label:" + data.label); 766 console.info("description:" + data.description); 767 console.info("iconPath:" + data.iconPath); 768 console.info("visible:" + data.visible); 769 console.info("kind:" + data.kind); 770 console.info("uri:" + data.uri); 771 console.info("process:" + data.process); 772 console.info("package:" + data.package); 773 console.info("bundleName:" + data.bundleName); 774 console.info("moduleName:" + data.moduleName); 775 console.info("applicationName:" + data.applicationName); 776 console.info("deviceId:" + data.deviceId); 777 console.info("codePath:" + data.codePath); 778 console.info("resourcePath:" + data.resourcePath); 779 console.info("libPath:" + data.libPath); 780 781 console.info('queryAbilityInfo permissions length [' + data.permissions.length + ']'); 782 for (var j = 0; j < data.permissions.length; j++) { 783 console.info("permissions[" + j + "]:" + data.permissions[j]); 784 } 785 console.info('queryAbilityInfo deviceTypes length [' + data.deviceTypes.length + ']'); 786 for (var j = 0; j < data.deviceTypes.length; j++) { 787 console.info("deviceTypes[" + j + "]:" + data.deviceTypes[j]); 788 } 789 console.info('queryAbilityInfo deviceCapabilities length [' + data.deviceCapabilities.length + ']'); 790 for (var j = 0; j < data.deviceCapabilities.length; j++) { 791 console.info("deviceCapabilities[" + j + "]:" + data.deviceCapabilities[j]); 792 } 793 console.info("appInfo.name:" + data.applicationInfo.name); 794 console.info("appInfo.bundleName:" + data.applicationInfo.bundleName); 795 // ability type: 0:UNKNOWN, 1:PAGE, 2:SERVICE, 3:DATA 796 console.info("type:" + data.type); 797 // orientation: 0:UNSPECIFIED, 1:LANDSCAPE, 2:PORTRAIT, 3:FOLLOWRECENT, 798 console.info("orientation:" + data.orientation); 799 // launchMode: 0:SINGLETON, 1:SINGLETOP, 2:STANDARD 800 console.info("launchMode:" + data.launchMode); 801 802 // the enum of AbilityType 803 console.info("AbilityType:" + bundle.AbilityType.UNKNOWN); 804 console.info("AbilityType:" + bundle.AbilityType.PAGE); 805 console.info("AbilityType:" + bundle.AbilityType.SERVICE); 806 console.info("AbilityType:" + bundle.AbilityType.DATA); 807 if (data.type == bundle.AbilityType.PAGE) { 808 console.info("this AbilityType is PAGE"); 809 } 810 // the enum of DisplayOrientation 811 console.info("DisplayOrientation:" + bundle.DisplayOrientation.UNSPECIFIED); 812 console.info("DisplayOrientation:" + bundle.DisplayOrientation.LANDSCAPE); 813 console.info("DisplayOrientation:" + bundle.DisplayOrientation.PORTRAIT); 814 console.info("DisplayOrientation:" + bundle.DisplayOrientation.FOLLOWRECENT); 815 if (data.orientation == bundle.DisplayOrientation.UNSPECIFIED) { 816 console.info("this DisplayOrientation is UNSPECIFIED"); 817 } 818 // the enum of LaunchMode 819 console.info("LaunchMode:" + bundle.LaunchMode.SINGLETON); 820 console.info("LaunchMode:" + bundle.LaunchMode.SINGLETOP); 821 console.info("LaunchMode:" + bundle.LaunchMode.STANDARD); 822 if (data.launchMode == bundle.LaunchMode.STANDARD) { 823 console.info("this LaunchMode is STANDARD"); 824 } 825} 826``` 827 828#### 安装hap包 829 830* install参数描述 831 832 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 833 | --------------- | -------- | ---------------------------- | ---- | ------------------------------------------------------------ | 834 | bundleFilePaths | 只读 | Array<string> | 是 | 安装用包路径 | 835 | param | 只读 | InstallParam | 是 | userId：用户ID<br/>installFlag：安装标识。<br/> NORMAL：安装/卸载<br/> REPLACE_EXISTING：更新<br/>isKeepData：卸载时是否保留运行时数据 | 836 | callback | 只读 | AsyncCallback<InstallStatus> | 是 | 回调方法 | 837 838* 返回值 839 840 void 841 842* InstallStatus类型说明 843 844 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 845 | ------------- | -------- | --------------- | ---- | -------- | 846 | InstallStatus | 只读 | IStatusReceiver | 是 | 安装结果 | 847 848* 示例 849 850``` 851bundle.getBundleInstaller().then((data) => { 852 data.install(['/data/test.hap'], { 853 param: { 854 userId: 0, 855 isKeepData: false 856 } 857 }, OnReceiveinstallEvent); 858 859 function OnReceiveinstallEvent(err, data) { 860 console.info("name: for begin"); 861 console.info("install result code:" + data.status); 862 console.info("install result msg:" + data.statusMessage); 863 } 864}) 865``` 866 867 868#### 卸载hap包 869 870* uninstall参数描述 871 872 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 873 | ---------- | -------- | ---------------------------- | ---- | ------------------------------------------------------------ | 874 | bundleName | 只读 | string | 是 | 卸载用包名 | 875 | param | 只读 | InstallParam | 是 | userId：用户ID<br/>installFlag：安装标识。<br/> NORMAL：安装/卸载<br/> REPLACE_EXISTING：更新<br/>isKeepData：卸载时是否保留运行时数据 | 876 | callback | 只读 | AsyncCallback<InstallStatus> | 是 | 回调方法 | 877 878* 返回值 879 880 void 881 882* InstallStatus类型说明 883 884 | 名称 | 读写属性 | 类型 | 必填 | 描述 | 885 | ------------- | -------- | --------------- | ---- | -------- | 886 | InstallStatus | 只读 | IStatusReceiver | 是 | 卸载结果 | 887 888* 示例 889 890``` 891bundle.getBundleInstaller().then((data) => { 892 data.uninstall('com.example.myapplication', { 893 param: { 894 userId: 0, 895 isKeepData: false 896 } 897 }, OnReceiveinstallEvent); 898 899 function OnReceiveinstallEvent(err, data) { 900 console.info("name: for begin"); 901 console.info("uninstall result code:" + data.status); 902 console.info("uninstall result msg:" + data.statusMessage); 903 } 904}) 905``` 906 907 908### bm命令如下 909 910**bm命令帮助** 911 912| 命令 | 描述 | 913| ------- | ---------- | 914| bm help | bm帮助命令 | 915 916**安装应用** 917 918| 命令 | 描述 | 919| ----------------------------------- | -------------------------- | 920| bm install -p <bundle-file-path> | 通过指定路径安装一个应用包 | 921| bm install -r -p <bundle-file-path> | 覆盖安装一个应用包 | 922 923``` 924示例如下： 925bm install -p /data/app/ohosapp.hap 926``` 927 928**卸载应用** 929 930| 命令 | 描述 | 931| ----------------------------- | ------------------------ | 932| bm uninstall -n <bundle-name> | 通过指定包名卸载一个应用 | 933 934``` 935示例如下： 936bm uninstall -n com.ohos.app 937``` 938 939**查看应用安装信息** 940 941| 命令 | 描述 | 942| ---------- | -------------------------- | 943| bm dump -a | 列出系统已经安装的所有应用 | 944 945## 相关仓 946 947用户程序框架子系统 948 949**appexecfwk_standard** 950 951aafwk_standard 952 953startup_appspawn 954
