Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
2ec87a73
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看板
未验证
提交
2ec87a73
编写于
5月 18, 2023
作者:
O
openharmony_ci
提交者:
Gitee
5月 18, 2023
浏览文件
操作
浏览文件
下载
差异文件
!18225 入口图标和标签优化以及调整stage模型的位置
Merge pull request !18225 from jiangminsen/master
上级
301d180b
2793f109
变更
6
展开全部
显示空白变更内容
内联
并排
Showing
6 changed file
with
82 addition
and
122 deletion
+82
-122
zh-cn/application-dev/application-models/application-component-configuration-stage.md
...ation-models/application-component-configuration-stage.md
+30
-3
zh-cn/application-dev/application-models/figures/application_details.jpg
...on-dev/application-models/figures/application_details.jpg
+0
-0
zh-cn/application-dev/quick-start/figures/application_details.jpg
...plication-dev/quick-start/figures/application_details.jpg
+0
-0
zh-cn/application-dev/quick-start/module-configuration-file.md
.../application-dev/quick-start/module-configuration-file.md
+0
-60
zh-cn/application-dev/quick-start/module-structure.md
zh-cn/application-dev/quick-start/module-structure.md
+49
-58
zh-cn/device-dev/subsystems/subsys-app-privilege-config-guide.md
...evice-dev/subsystems/subsys-app-privilege-config-guide.md
+3
-1
未找到文件。
zh-cn/application-dev/application-models/application-component-configuration-stage.md
浏览文件 @
2ec87a73
...
...
@@ -2,12 +2,12 @@
在开发应用时,需要配置应用的一些标签,例如应用的包名、图标等标识特征的属性。本文描述了在开发应用需要配置的一些关键标签。
图标和标签通常一起配置,可以分为应用图标、应用标签和入口图标、入口标签,分别对应
[
app.json5配置文件
](
../quick-start/app-configuration-file.md
)
和
[
module.json5配置文件
](
../quick-start/module-configuration-file.md
)
文件
中的icon和label标签。
图标和标签通常一起配置,可以分为应用图标、应用标签和入口图标、入口标签,分别对应
[
app.json5配置文件
](
../quick-start/app-configuration-file.md
)
和
[
module.json5配置文件
](
../quick-start/module-configuration-file.md
)
中的icon和label标签。
应用图标和标签是在设置应用中使用,例如设置应用中的应用列表。入口图标是应用安装完成后在设备桌面上显示出来的,如
图一所示。入口图标是以
[
UIAbility
](
uiability-overview.md
)
为粒度,支持同一个应用存在多个入口图标和
标签,点击后进入对应的UIAbility界面。
应用图标和标签是在设置应用中使用,例如设置应用中的应用列表。入口图标是应用安装完成后在设备桌面上显示出来的,如
下图所示。入口图标是以
[
UIAbility
](
uiability-overview.md
)
为粒度,支持同一个应用存在多个入口图标和入口
标签,点击后进入对应的UIAbility界面。
**图1**
应用图标和标签
![
application-component-configuration-stage
](
figures/application-component-configuration-stage.png
)
、
![
application-component-configuration-stage
](
figures/application-component-configuration-stage.png
)
-
**应用包名配置**
...
...
@@ -62,6 +62,33 @@
}
}
```
OpenHarmony系统对无图标应用严格管控,防止一些恶意应用故意配置无入口图标,导致用户找不到软件所在的位置,无法操作卸载应用,在一定程度上保证用户的手机安全。
如果应用确需隐藏入口图标,需要配置AllowAppDesktopIconHide应用特权,具体配置方式参考
[
应用特权配置指南
](
../../device-dev/subsystems/subsys-app-privilege-config-guide.md
)
。详细的入口图标及入口标签的显示规则如下。
*
HAP中包含UIAbility
*
在module.json5配置文件的abilities标签中设置了入口图标
*
该应用没有隐藏图标的特权
*
系统将使用该UIAbility配置的icon作为入口图标,并显示在桌面上。用户点击该图标,页面跳转到该UIAbility首页。
*
系统将使用该UIAbility配置的label作为入口标签,并显示在桌面上,如果没有配置label,系统将使用app.json5中的label作为入口标签,并显示在桌面上。
*
该应用具有隐藏图标的特权
*
桌面应用查询时不返回应用信息,不会在桌面上显示对应的入口图标和标签。
*
在module.json5配置文件的abilities标签中未设置入口图标
*
该应用没有隐藏图标的特权
*
系统将使用app.json5中的icon作为入口图标,并显示在桌面上。用户点击该图标,页面跳转到应用管理中对应的应用详情页面,如下图所示。
*
系统将使用app.json5中的label作为入口标签,并显示在桌面上。
*
该应用具有隐藏图标的特权
*
桌面应用查询时不返回应用信息,不会在桌面上显示对应的入口图标和标签。
*
HAP中不包含UIAbility
*
该应用没有隐藏图标的特权
*
系统将使用app.json5中的icon作为入口图标,并显示在桌面上。用户点击该图标,页面跳转到应用管理中对应的应用详情页面,如下图所示。
*
系统将使用app.json5中的label作为入口标签,并显示在桌面上。
*
该应用具有隐藏图标的特权
*
桌面应用查询时不返回应用信息,不会在桌面上显示对应的入口图标和标签。
**图2**
应用的详情页示意图
!
[
应用的详情页例图
](
figures/application_details.jpg
)
-
**应用版本声明配置**
应用版本声明需要在工程的AppScope目录下的
[
app.json5配置文件
](
../quick-start/app-configuration-file.md
)
中配置versionCode标签和versionName标签。versionCode用于标识应用的版本号,该标签值为32位非负整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。versionName标签标识版本号的文字描述。
...
...
zh-cn/application-dev/application-models/figures/application_details.jpg
0 → 100644
浏览文件 @
2ec87a73
16.9 KB
zh-cn/application-dev/quick-start/figures/application_details.jpg
查看替换文件 @
301d180b
浏览文件 @
2ec87a73
111.5 KB
|
W:
|
H:
21.5 KB
|
W:
|
H:
2-up
Swipe
Onion skin
zh-cn/application-dev/quick-start/module-configuration-file.md
浏览文件 @
2ec87a73
...
...
@@ -228,66 +228,6 @@ deviceTypes示例:
abilities标签描述UIAbility组件的配置信息,标签值为数组类型,该标签下的配置只对当前UIAbility生效。
**OpenHarmony中不允许应用隐藏入口图标**
OpenHarmony系统对无图标应用严格管控。如果HAP中没有配置入口图标,那么系统将应用app.json中的icon作为入口图标,并显示在桌面上。
<br>
用户点击该图标,将跳转到设置应用管理中对应的应用详情页面(图1)中。
<br>
如果应用想要隐藏入口图标,需要配置AllowAppDesktopIconHide应用特权,具体配置方式参考
[
应用特权配置指南
](
../../device-dev/subsystems/subsys-app-privilege-config-guide.md
)
。
**场景说明:**
该功能能防止一些恶意应用,故意配置无入口图标,导致用户找不到软件所在的位置,无法操作卸载应用,在一定程度上保证用户的手机安全
**入口图标的设置:**
需要在配置文件(module.json5)中abilities配置下设置icon,label以及skills,而且skills的配置下的必须同时包含“ohos.want.action.home” 和 “entity.system.home”:
```
{
"module":{
...
"abilities": [{
"icon": "$media:icon",
"label": "Login",
"skills": [{
"actions": ["ohos.want.action.home"],
"entities": ["entity.system.home"],
"uris": []
}]
}],
...
}
}
```
**入口图标及入口标签的显示规则**
*
HAP中包含UIAbility
*
配置文件(module.json5)中abilities配置中设置了入口图标
*
该应用没有隐藏图标的特权
*
显示桌面图标为该UIAbility配置的图标
*
显示桌面Label为该UIAbility配置的Label(如果没有配置Label,返回包名)
*
显示组件名为该UIAbility的组件名
*
用户点击该桌面图标,页面跳转到该UIAbility首页
*
该应用具有隐藏图标的特权
*
桌面查询时不返回应用信息,不会在桌面上显示对应的图标。
*
配置文件(module.json5)中abilities配置中未设置入口图标
*
该应用没有隐藏图标的特权
*
显示桌面图标为app配置下的图标(app.json中icon为必填项)
*
显示桌面Label为app配置下的label(app.json中label为必填项)
*
用户点击该桌面图标,页面跳转到该应用的详情页面(图1)
*
该应用具有隐藏图标的特权
*
桌面查询时不返回应用信息,不会在桌面上显示对应的图标。
*
HAP中不包含UIAbility
*
该应用没有隐藏图标的特权
*
显示桌面图标为app配置下的图标(app.json中icon为必填项)
*
显示桌面Label为app配置下的label(app.json中label为必填项)
*
用户点击该桌面图标,页面跳转到该应用的详情页面(图1)
*
该应用具有隐藏图标的特权
*
桌面查询时不返回应用信息,不会在桌面上显示对应的图标。
<br><br>
应用的详情页例图
![
应用的详情页例图
](
figures/application_details.jpg
)
**表6**
**abilities标签说明**
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
...
...
zh-cn/application-dev/quick-start/module-structure.md
浏览文件 @
2ec87a73
此差异已折叠。
点击以展开。
zh-cn/device-dev/subsystems/subsys-app-privilege-config-guide.md
浏览文件 @
2ec87a73
...
...
@@ -4,7 +4,9 @@
OpenHarmony提供通用的应用特权和可由设备厂商针对不同设备单独配置的应用特权。当签名证书中配置的特权与白名单(install_list_capability.json)中特权相同时,以白名单的配置为主。
> 说明:应当注意不要滥用应用特权,避免造成用户反感甚至对用户造成侵权。
> **说明:**
> - 应当注意不要滥用应用特权,避免造成用户反感甚至对用户造成侵权。
> - 直接修改应用Profile文件的方式,仅用于应用/服务调试阶段使用,不可用于发布上架应用市场。如果需要开发商用版本的应用,请在对应的应用市场进行发布证书和Profile文件的申请。
## 通用应用特权
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录