Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
fd18f955
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看板
提交
fd18f955
编写于
8月 04, 2023
作者:
H
Haoming Luo
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
修改应用内HSP开发文档部分内容
Signed-off-by:
N
Haoming Luo
<
mzfslhm@163.com
>
上级
f6a7f6ef
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
14 addition
and
15 deletion
+14
-15
zh-cn/application-dev/quick-start/in-app-hsp.md
zh-cn/application-dev/quick-start/in-app-hsp.md
+14
-15
未找到文件。
zh-cn/application-dev/quick-start/in-app-hsp.md
浏览文件 @
fd18f955
...
...
@@ -5,7 +5,7 @@
## 开发应用内HSP
通过DevEco Studio创建一个HSP模块,创建方式可
[
参考
](
https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/hsp-0000001521396322-V3#section7717162312546
)
,我们以创建一个名为
`library`
的HSP模块为例。基本的工程目录结构
大致
如下:
通过DevEco Studio创建一个HSP模块,创建方式可
[
参考
](
https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/hsp-0000001521396322-V3#section7717162312546
)
,我们以创建一个名为
`library`
的HSP模块为例。基本的工程目录结构如下:
```
library
├── src
...
...
@@ -17,19 +17,6 @@ library
│ └── module.json5
└── oh-package.json5
```
模块
`module.json5`
中的
`"type"`
标识模块类型,HSP的
`"type"`
是
`"shared"`
。
```
json
{
"type"
:
"shared"
}
```
HSP通过在入口文件中导出接口,对外提供能力。入口文件在模块
`oh-package.json5`
的
`"main"`
中配置。例如:
```
json
{
"main"
:
"./src/main/ets/index.ets"
}
```
### 导出ts类和方法
通过
`export`
导出ts类和方法,例如:
...
...
@@ -82,11 +69,23 @@ export { MyTitleBar } from './components/MyTitleBar'
```
### 通过$r访问HSP中资源
在组件中,经常需要使用字符串、图片等资源。HSP中的组件需要使用资源时,一般将其所用资源放在HSP包内,以符合高内聚低耦合的原则。可以通过
`$r`
/
`$rawfile`
访问本模块
`resources`
目录下的资源。
在组件中,经常需要使用字符串、图片等资源。HSP中的组件需要使用资源时,一般将其所用资源放在HSP包内,而非放在HSP的使用方处,以符合高内聚低耦合的原则。
可以通过
`$r`
/
`$rawfile`
访问本模块
`resources`
目录下的资源,如
`$r("app.media.example")`
。
不推荐使用相对路径的方式,容易引用错误路径。例如:
在HSP模块中使用
`Image("common/example.png")`
,实际上该
`Image`
组件访问的是HSP调用方(如
`entry`
)下的资源
`entry/src/main/ets/common/example.png`
。
```
ts
// library/src/main/ets/pages/Index.ets
// 正确用例
Image
(
$r
(
"
app.media.example
"
))
.
width
(
"
100%
"
)
// 错误用例
Image
(
"
../../resources/base/media/example.png
"
)
.
width
(
"
100%
"
)
```
### 导出HSP中资源
跨包访问HSP内资源时,推荐实现一个资源管理类,以封装对外导出的资源,通过该方式:
-
HSP开发者可以控制自己需要导出的资源,不需要对外暴露的资源可以不用导出;
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录