Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4891f736
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
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,发现更多精彩内容 >>
提交
4891f736
编写于
4月 12, 2023
作者:
F
fangyunzhong
提交者:
fyz1019
4月 13, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
fixed
8cdc4b5e
from
https://gitee.com/fang-yunzhong/docs/pulls/17215
资源管理文档优化 Signed-off-by:
N
fangyunzhong
<
fangyunzhong2@huawei.com
>
上级
f2b71ddc
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
22 addition
and
7 deletion
+22
-7
zh-cn/application-dev/quick-start/resource-categories-and-access.md
...ication-dev/quick-start/resource-categories-and-access.md
+22
-7
未找到文件。
zh-cn/application-dev/quick-start/resource-categories-and-access.md
浏览文件 @
4891f736
...
@@ -8,8 +8,6 @@
...
@@ -8,8 +8,6 @@
## 资源分类
## 资源分类
### resources目录
应用开发中使用的各类资源文件,需要放入特定子目录中存储管理。resources目录包括三大类目录,一类为base目录,一类为限定词目录,还有一类为rawfile目录。stage模型多工程情况下共有的资源文件放到AppScope下的resources目录。
应用开发中使用的各类资源文件,需要放入特定子目录中存储管理。resources目录包括三大类目录,一类为base目录,一类为限定词目录,还有一类为rawfile目录。stage模型多工程情况下共有的资源文件放到AppScope下的resources目录。
base目录默认存在,而限定词目录需要开发者自行创建。应用使用某资源时,系统会根据当前设备状态优先从相匹配的限定词目录中寻找该资源。只有当resources目录中没有与设备状态匹配的限定词目录,或者在限定词目录中找不到该资源时,才会去base目录中查找。rawfile是原始文件目录,不会根据设备状态去匹配不同的资源。
base目录默认存在,而限定词目录需要开发者自行创建。应用使用某资源时,系统会根据当前设备状态优先从相匹配的限定词目录中寻找该资源。只有当resources目录中没有与设备状态匹配的限定词目录,或者在限定词目录中找不到该资源时,才会去base目录中查找。rawfile是原始文件目录,不会根据设备状态去匹配不同的资源。
...
@@ -18,24 +16,42 @@ base目录默认存在,而限定词目录需要开发者自行创建。应用
...
@@ -18,24 +16,42 @@ base目录默认存在,而限定词目录需要开发者自行创建。应用
```
```
resources
resources
|---base // 默认存在的目录
|---base
| |---element
| | |---string.json
| |---media
| | |---icon.png
| |---profile
| | |---test_profile.json
|---en_US // 默认存在的目录,设备语言环境是美式英文时,优先匹配此目录下资源
| |---element
| | |---string.json
| |---media
| | |---icon.png
| |---profile
| | |---test_profile.json
|---zh_CN // 默认存在的目录,设备语言环境是简体中文时,优先匹配此目录下资源
| |---element
| |---element
| | |---string.json
| | |---string.json
| |---media
| |---media
| | |---icon.png
| | |---icon.png
|---en_GB-vertical-car-mdpi // 限定词目录示例,需要开发者自行创建
| |---profile
| | |---test_profile.json
|---en_GB-vertical-car-mdpi // 自定义多限定词目录示例,由开发者创建
| |---element
| |---element
| | |---string.json
| | |---string.json
| |---media
| |---media
| | |---icon.png
| | |---icon.png
|---rawfile
| |---profile
| | |---test_profile.json
|---rawfile // 其他类型文件,原始文件形式保存,不会被集成到resources.index文件中。文件名可自定义。
```
```
**表1**
resources目录分类
**表1**
resources目录分类
| 分类 | base目录 | 限定词目录 | rawfile目录 |
| 分类 | base目录 | 限定词目录 | rawfile目录 |
| ---- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
| ---- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
| 组织形式 | base目录是默认存在的目录。当应用的resources目录中没有与设备状态匹配的限定词目录时,会自动引用该目录中的资源文件。
<br/>
base目录的二级子目录为
**资源组目录**
,用于存放字符串、颜色、布尔值等基础元素,以及媒体、动画、布局等资源文件,具体要求参见
[
资源组目录
](
#资源组目录
)
。 | 限定词目录需要开发者自行创建。目录名称由一个或多个表征应用场景或设备特征的限定词组合而成,具体要求参见
[
限定词目录
](
#限定词目录
)
。
<br/>
限定词目录的二级子目录为
**资源组目录**
,用于存放字符串、颜色、布尔值等基础元素,以及媒体、动画、布局等资源文件,具体要求参见
[
资源组目录
](
#资源组目录
)
。 | 支持创建多层子目录,目录名称可以自定义,文件夹内可以自由放置各类资源文件。
<br/>
rawfile目录的文件不会根据设备状态去匹配不同的资源。 |
| 组织形式 | base目录是默认存在的目录。当应用的resources目录中没有与设备状态匹配的限定词目录时,会自动引用该目录中的资源文件。
<br/>
base目录的二级子目录为
**资源组目录**
,用于存放字符串、颜色、布尔值等基础元素,以及媒体、动画、布局等资源文件,具体要求参见
[
资源组目录
](
#资源组目录
)
。 |
en_US和zh_CN是默认存在的两个限定词目录,其余
限定词目录需要开发者自行创建。目录名称由一个或多个表征应用场景或设备特征的限定词组合而成,具体要求参见
[
限定词目录
](
#限定词目录
)
。
<br/>
限定词目录的二级子目录为
**资源组目录**
,用于存放字符串、颜色、布尔值等基础元素,以及媒体、动画、布局等资源文件,具体要求参见
[
资源组目录
](
#资源组目录
)
。 | 支持创建多层子目录,目录名称可以自定义,文件夹内可以自由放置各类资源文件。
<br/>
rawfile目录的文件不会根据设备状态去匹配不同的资源。 |
| 编译方式 | 目录中的资源文件会被编译成二进制文件,并赋予资源文件ID。 | 目录中的资源文件会被编译成二进制文件,并赋予资源文件ID。 | 目录中的资源文件会被直接打包进应用,不经过编译,也不会被赋予资源文件ID。 |
| 编译方式 | 目录中的资源文件会被编译成二进制文件,并赋予资源文件ID。 | 目录中的资源文件会被编译成二进制文件,并赋予资源文件ID。 | 目录中的资源文件会被直接打包进应用,不经过编译,也不会被赋予资源文件ID。 |
| 引用方式 | 通过指定资源类型(type)和资源名称(name)来引用。 | 通过指定资源类型(type)和资源名称(name)来引用。 | 通过指定文件路径和文件名来引用。 |
| 引用方式 | 通过指定资源类型(type)和资源名称(name)来引用。 | 通过指定资源类型(type)和资源名称(name)来引用。 | 通过指定文件路径和文件名来引用。 |
...
@@ -84,7 +100,6 @@ base目录与限定词目录下面可以创建资源组目录(包括element、
...
@@ -84,7 +100,6 @@ base目录与限定词目录下面可以创建资源组目录(包括element、
| element | 表示元素资源,以下每一类数据都采用相应的JSON文件来表征(目录下只支持文件类型)。
<br/>
-
boolean,布尔型
<br/>
-
color,颜色
<br/>
-
float,浮点型
<br/>
-
intarray,整型数组
<br/>
-
integer,整型
<br/>
-
pattern,样式
<br/>
-
plural,复数形式
<br/>
-
strarray,字符串数组
<br/>
-
string,字符串 | element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。
<br/>
-
boolean.json
<br/>
-
color.json
<br/>
-
float.json
<br/>
-
intarray.json
<br/>
-
integer.json
<br/>
-
pattern.json
<br/>
-
plural.json
<br/>
-
strarray.json
<br/>
-
string.json |
| element | 表示元素资源,以下每一类数据都采用相应的JSON文件来表征(目录下只支持文件类型)。
<br/>
-
boolean,布尔型
<br/>
-
color,颜色
<br/>
-
float,浮点型
<br/>
-
intarray,整型数组
<br/>
-
integer,整型
<br/>
-
pattern,样式
<br/>
-
plural,复数形式
<br/>
-
strarray,字符串数组
<br/>
-
string,字符串 | element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。
<br/>
-
boolean.json
<br/>
-
color.json
<br/>
-
float.json
<br/>
-
intarray.json
<br/>
-
integer.json
<br/>
-
pattern.json
<br/>
-
plural.json
<br/>
-
strarray.json
<br/>
-
string.json |
| media | 表示媒体资源,包括图片、音频、视频等非文本格式的文件(目录下只支持文件类型)。 | 文件名可自定义,例如:icon.png。 |
| media | 表示媒体资源,包括图片、音频、视频等非文本格式的文件(目录下只支持文件类型)。 | 文件名可自定义,例如:icon.png。 |
| profile | 表示自定义配置文件,其文件内容可
[
通过包管理接口
](
../reference/apis/js-apis-bundleManager.md#bundlemanagergetprofilebyability
)
获取(目录下只支持文件类型)。 | 文件名可自定义,例如:test_profile.json。 |
| profile | 表示自定义配置文件,其文件内容可
[
通过包管理接口
](
../reference/apis/js-apis-bundleManager.md#bundlemanagergetprofilebyability
)
获取(目录下只支持文件类型)。 | 文件名可自定义,例如:test_profile.json。 |
| rawfile | 表示其他类型文件,在应用构建为hap包后,以原始文件形式保存,不会被集成到resources.index文件中。 | 文件名可自定义。 |
**媒体资源类型说明**
**媒体资源类型说明**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录