Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
cd177cc0
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
cd177cc0
编写于
2月 21, 2023
作者:
O
openharmony_ci
提交者:
Gitee
2月 21, 2023
浏览文件
操作
浏览文件
下载
差异文件
!14933 adapt schema for monthly
Merge pull request !14933 from longwei/monthly_20221018
上级
e6d1bd3a
4514d3eb
变更
3
展开全部
隐藏空白更改
内联
并排
Showing
3 changed file
with
236 addition
and
51 deletion
+236
-51
zh-cn/application-dev/quick-start/app-configuration-file.md
zh-cn/application-dev/quick-start/app-configuration-file.md
+4
-8
zh-cn/application-dev/quick-start/module-configuration-file.md
.../application-dev/quick-start/module-configuration-file.md
+27
-42
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
...angelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
+205
-1
未找到文件。
zh-cn/application-dev/quick-start/app-configuration-file.md
浏览文件 @
cd177cc0
...
...
@@ -13,12 +13,10 @@
"icon"
:
"$media:app_icon"
,
"label"
:
"$string:app_name"
,
"description"
:
"$string:description_application"
,
"distributedNotificationEnabled"
:
true
,
"minAPIVersion"
:
9
,
"targetAPIVersion"
:
9
,
"apiReleaseType"
:
"Release"
,
"debug"
:
false
,
"entityType"
:
"media"
,
"car"
:
{
"minAPIVersion"
:
8
,
}
...
...
@@ -34,7 +32,7 @@ app.json5配置文件包含以下标签。
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| -------- | -------- | -------- | -------- |
| bundleName | 标识应用的
包名
,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则
:
<br/>
-
字符串以字母、数字、下划线和符号“.”组成。
<br/>
-
以字母开头。
<br/>
-
最小长度7个字节,最大长度127个字节。
<br/>
推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。
<br/>
其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,
ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| bundleName | 标识应用的
Bundle名称
,用于标识应用的唯一性。该标签不可缺省。标签的值命名规则
:
<br/>
-
字符串以字母、数字、下划线和符号“.”组成。
<br/>
-
以字母开头。
<br/>
-
最小长度7个字节,最大长度127个字节。
<br/>
推荐采用反域名形式命名(如com.example.demo,建议第一级为域名后缀com,第二级为厂商/个人名,第三级为应用名,也可以多级)。
<br/>
其中,随系统源码编译的应用建议命名为“com.ohos.demo”形式,
ohos标识OpenHarmony系统应用。 | 字符串 | 该标签不可缺省。 |
| debug | 标识应用是否可调试,该标签由IDE编译构建时生成。
<br/>
-
true:可调试。
<br/>
-
false:不可调式。 | 布尔值 | 该标签可以缺省,缺省为false。 |
| icon | 标识
[
应用的图标
](
../application-models/application-component-configuration-stage.md
)
,标签值为图标资源文件的索引。 | 字符串 | 该标签不可缺省。 |
| label | 标识
[
应用的名称
](
../application-models/application-component-configuration-stage.md
)
,标签值为字符串资源的索引。 | 字符串 | 该标签不可缺省。 |
...
...
@@ -43,12 +41,10 @@ app.json5配置文件包含以下标签。
| versionCode | 标识应用的版本号,该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。开发者可以将该值设置为任何正整数,但是必须确保应用的新版本都使用比旧版本更大的值。该标签不可缺省,versionCode值应小于2^31次方。 | 数值 | 该标签不可缺省。 |
| versionName | 标识应用版本号的文字描述,用于向用户展示。
<br/>
该标签仅由数字和点构成,推荐采用“A.B.C.D”四段式的形式。四段式推荐的含义如下所示。
<br/>
第一段:主版本号/Major,范围0-99,重大修改的版本,如实现新的大功能或重大变化。
<br/>
第二段:次版本号/Minor,范围0-99,表示实现较突出的特点,如新功能添加或大问题修复。
<br/>
第三段:特性版本号/Feature,范围0-99,标识规划的新版本特性。
<br/>
第四段:修订版本号/Patch,范围0-999,表示维护版本,修复bug。
<br/>
标签最大字节长度为127。 | 字符串 | 该标签不可缺省。 |
| minCompatibleVersionCode | 标识应用能够兼容的最低历史版本号,用于跨设备兼容性判断。 | 数值 | 该标签可缺省,缺省值等于versionCode标签值。 |
| minAPIVersion | 标识应用运行需要的SDK的API最小版本。 | 数值 | build-profile.json5中的compatibleSdkVersion生成。 |
| targetAPIVersion | 标识应用运行需要的API目标版本。 | 数值 | build-profile.json5中的compileSdkVersion生成。 |
| minAPIVersion | 标识应用运行需要的SDK的API最小版本。 | 数值 |
由
build-profile.json5中的compatibleSdkVersion生成。 |
| targetAPIVersion | 标识应用运行需要的API目标版本。 | 数值 |
由
build-profile.json5中的compileSdkVersion生成。 |
| apiReleaseType | 标识应用运行需要的API目标版本的类型,采用字符串类型表示。取值为“CanaryN”、“BetaN”或者“Release”,其中,N代表大于零的整数。
<br/>
-
Canary:受限发布的版本。
<br/>
-
Beta:公开发布的Beta版本。
<br/>
-
Release:公开发布的正式版本。
<br/>
该字段由DevEco
Studio读取当前使用的SDK的Stage来生成。 | 字符串 | 该标签可缺省,由IDE生成并覆盖。 |
| distributedNotificationEnabled | 标识应用是否开启分布式通知,当开启分布式通知时,同一分布式组网下的两个设备(A和B),当设备A收到一条消息时,设备B会收到一条分布式消息用于设备B的使用者去查看设备A的消息。
<br/>
-
true:开启。
<br/>
-
false:不开启。 | 布尔值 | 该标签可缺省,缺省值为false。 |
| entityType | 标识应用的类别,分别有:
<br/>
-
game:游戏类。
<br/>
-
media:影音类。
<br/>
-
communication:社交通信类。
<br/>
-
news:新闻类。
<br/>
-
travel:出行类。
<br/>
-
utility:工具类。
<br/>
-
shopping:购物类。
<br/>
-
education:教育类。
<br/>
-
kids:少儿类。
<br/>
-
business:商务类。
<br/>
-
photography:拍摄类。
<br/>
-
unspecified:不属于上述的任何一类。 | 字符串 | 该标签可以缺省,缺省为unspecified。 |
| multiProjects | 标识当前工程是否支持多个工程的联合开发。
<br/>
-
true:当前工程支持多个工程的联合开发。
<br/>
-
false:当前工程不支持多个工程的联合开发。 | 布尔值 | 可缺省,缺省值为false。 |
| multiProjects | 标识当前工程是否支持多个工程的联合开发。
<br/>
-
true:当前工程支持多个工程的联合开发。
<br/>
-
false:当前工程不支持多个工程的联合开发。多工程开发可以参考文档:
[
多工程构建
](
https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ohos-building-overview-0000001263360495-V3#section71471033104216
)
| 布尔值 | 可缺省,缺省值为false。 |
| tablet | 标识对tablet设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tablet设备做了特殊配置,则应用在tablet设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tablet设备使用app.json5公共区域配置的属性值。 |
| tv | 标识对tv设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对tv设备做了特殊配置,则应用在tv设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时tv设备使用app.json5公共区域配置的属性值。 |
| wearable | 标识对wearable设备做的特殊配置,可以配置的属性字段有上文提到的:minAPIVersion、distributedNotificationEnabled。
<br/>
如果使用该属性对wearable设备做了特殊配置,则应用在wearable设备中会采用此处配置的属性值,并忽略在app.json5公共区域配置的属性值。 | 对象 | 该标签可缺省,缺省时wearable设备使用app.json5公共区域配置的属性值。 |
...
...
zh-cn/application-dev/quick-start/module-configuration-file.md
浏览文件 @
cd177cc0
此差异已折叠。
点击以展开。
zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md
浏览文件 @
cd177cc0
...
...
@@ -5,7 +5,7 @@
包管理删除
[
@ohos.bundle.bundleManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts
)
中的getAbilityIcon接口,可以使用
[
@ohos.resourceManager.d.ts
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts
)
中的getMediaContent替换。
**变更影响**
<br>
使用之前已发布的API 9各beta版本
切
使用到了getAbilityIcon接口的,需要改为使用getMediaContent接口。
使用之前已发布的API 9各beta版本
且
使用到了getAbilityIcon接口的,需要改为使用getMediaContent接口。
**关键的接口/组件变更**
<br>
删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。
...
...
@@ -27,3 +27,207 @@
**适配指导**
<br>
如果有应用需要自定义权限,可以在资源HAP的
[
配置文件
](
https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json
)
中definePermissions字段下面新增定义权限。格式可参考
[
定义权限
](
../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构
)
。
## cl.bundlemanager.3 包管理二级模块文件名称变更,修改为文件内对应的接口名称
包管理二级模块文件名称变更,修改为文件内对应的接口名称,变更文件如下:
| 原文件名称 |变更后文件名称 |
|----|----|
| bundleManager/abilityInfo.d.ts | bundleManager/AbilityInfo.d.ts |
| bundleManager/applicationInfo.d.ts | bundleManager/ApplicationInfo.d.ts |
| bundleManager/bundleInfo.d.ts | bundleManager/BundleInfo.d.ts |
| bundleManager/dispatchInfo.d.ts | bundleManager/DispatchInfo.d.ts |
| bundleManager/elementName.d.ts | bundleManager/ElementName.d.ts |
| bundleManager/extensionAbilityInfo.d.ts | bundleManager/ExtensionAbilityInfo.d.ts |
| bundleManager/hapModuleInfo.d.ts | bundleManager/HapModuleInfo.d.ts |
| bundleManager/launcherAbilityInfo.d.ts | bundleManager/LauncherAbilityInfo.d.ts |
| bundleManager/metadata.d.ts | bundleManager/Metadata.d.ts |
| bundleManager/packInfo.d.ts | bundleManager/BundlePackInfo.d.ts |
| bundleManager/permissionDef.d.ts | bundleManager/PermissionDef.d.ts |
| bundleManager/remoteAbilityInfo.d.ts | bundleManager/RemoteAbilityInfo.d.ts |
| bundleManager/shortcutInfo.d.ts | bundleManager/ShortcutInfo.d.ts |
除了免安装相关的BundlePackInfo文件名称增加了Bundle,其余文件名称均是修改为大写开头。
**变更影响**
<br>
仅修改二级模块文件名称,不会影响一级模块的使用。在使用之前已发布的API 9各beta版本时,如果在ts文件中直接导入了bundleManager下面二级模块接口的,IDE中编译报错的话,需要修改导入的文件名称。
**关键的接口/组件变更**
<br>
变更bundleManager文件夹下面的d.ts名称,修改为文件中的接口名称。
**适配指导**
<br>
使用新的sdk后,正常情况下应用无需适配该变更。如果在应用中直接导入了bundleManager文件夹下面的文件,则需要修改导入的文件名称。可以按照如下的修改方式:
**修改前:**
```
ts
import
{
AbilityInfo
}
from
'
bundleManger/abilityInfo
'
;
import
{
ExtensionAbilityInfo
}
from
'
bundleManger/extensionAbilityInfo
'
;
import
{
BundlePackInfo
}
from
'
bundleManger/packInfo
'
;
```
**修改后:**
```
ts
import
{
AbilityInfo
}
from
'
bundleManger/AbilityInfo
'
;
import
{
ExtensionAbilityInfo
}
from
'
bundleManger/ExtensionAbilityInfo
'
;
import
{
BundlePackInfo
}
from
'
bundleManger/BundlePackInfo
'
;
```
## cl.bundlemanager.4 包管理LaunchType枚举类型名称变更,由STANDARD修改为MULTITON,枚举值不变。
包管理
[
LaunchType
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts
)
枚举类型变更,由STANDARD修改为MULTITON,枚举值不变,表示多实例类型。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了LaunchType.STANDARD的,需要改为使用LaunchType.MULTITON接口。
**关键的接口/组件变更**
<br>
LaunchType枚举类型名称变更,由LaunchType.STANDARD修改为LaunchType.MULTITON。
**适配指导**
<br>
由LaunchType.STANDARD修改为LaunchType.MULTITON。
## cl.bundlemanager.5 包管理AbilityInfo结构体中isVisible字段修改为exported,类型不变。
包管理
[
AbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
AbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变。
**适配指导**
<br>
由isVisible修改为exported。
## cl.bundlemanager.6 包管理ExtensionAbilityInfo结构体中isVisible字段修改为exported,类型不变。
包管理
[
ExtensionAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
ExtensionAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts
)
结构体中isVisible字段修改为exported,类型不变。
**适配指导**
<br>
由isVisible修改为exported。
## cl.bundlemanager.7 包管理ModuleAbilityInfo结构体中visible字段修改为exported,类型不变。
包管理
[
ModuleAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts
)
结构体中visible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
**变更影响**
<br>
使用之前已发布的API 9各beta版本且使用到了visible的,需要改为使用exported。
**关键的接口/组件变更**
<br>
包管理
[
ModuleAbilityInfo
](
https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts
)
结构体中visible字段修改为exported,类型不变。
**适配指导**
<br>
由visible修改为exported。
## cl.bundlemanager.8 app.json配置文件删除distributedNotificationEnabled标签
删除配置文件app.json中
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
distributedNotificationEnabled
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.9 app.json配置文件删除entityType标签
删除配置文件app.json中
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
entityType
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.10 app.json配置文件删除keepAlive标签
删除配置文件app.json中
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
keepAlive
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.11 app.json配置文件删除removable标签
删除配置文件app.json中
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
removable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.12 app.json配置文件删除singleton标签
删除配置文件app.json中
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
singleton
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.13 app.json配置文件删除userDataClearable标签
删除配置文件app.json中
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件app.json中
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除
[
userDataClearable
](
../../../application-dev/quick-start/app-configuration-file.md
)
标签
## cl.bundlemanager.14 module.json配置文件中module的name标签不再支持配置中文
module.json配置文件中的module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
不再支持配置中文
**变更影响**
<br>
删除配置文件module.json中module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错
**适配指导**
<br>
使用英文语言配置module.json中module的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.15 module.json配置文件中ability的name标签不再支持配置中文
module.json配置文件中的ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
不再支持配置中文
**变更影响**
<br>
删除配置文件module.json中ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错
**适配指导**
<br>
使用英文语言配置module.json中ability的
[
name
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.16 module.json配置文件删除uiSyntax标签
删除配置文件module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
**变更影响**
<br>
删除配置文件module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
uiSyntax
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签
## cl.bundlemanager.17 module.json配置文件中module及ability中的srcEntrance标签修改为srcEntry
配置文件module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签修改为srcEntry
**变更影响**
<br>
删除配置文件module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
srcEntrance
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,使用srcEntry替代
## cl.bundlemanager.18 删除module.json配置文件中distroFilter的apiVersion标签
删除配置文件module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签
**变更影响**
<br>
删除配置文件module.json
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
的apiVersion标签
## cl.bundlemanager.19 module.json配置文件中distroFilter修改为distributionFilter
配置文件module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签修改为distributionFilter
**变更影响**
<br>
删除配置文件module.json
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错
**适配指导**
<br>
删除module.json中
[
distroFilter
](
../../../application-dev/quick-start/module-configuration-file.md
)
标签,使用distributionFilter替代
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录