> For the complete documentation index, see [llms.txt](https://tongzonghuas-organization.gitbook.io/wgappsdk-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tongzonghuas-organization.gitbook.io/wgappsdk-1/useage.md).
# Useage
外部 H5 调用 \`坦克/战舰 APP\` 内部方法
SDK 会暴露出 wgappsdk 对象，里面包含 callNative 方法，通过对该方法的不同参数来操作 APP
### 使用方法
* 引入 npm 包（推荐）
```bash
npm install wgappsdk
# 或者
yarn add wgappsdk
```
```javascript
import { callNative, onAppMessage, JumpMethod, JumpType } from 'wgappsdk';
// 显示标题
await callNative(JumpMethod.SHOWTITLE, { title: "页面标题" });
// 打开H5页面
await callNative(JumpMethod.OPENH5URL, { url: "https://example.com" });
// 获取网络状态
const netStatus = await callNative(JumpMethod.GETNETSTATUS);
// 分享链接
await callNative(JumpMethod.JUMPTOSHARE, {
project: "forum",
type: ShareType.URL,
title: "分享标题",
desc: "分享描述",
iconUrl: "https://example.com/icon.png",
url: "https://example.com"
});
// 监听原生消息
onAppMessage((appData) => {
switch (appData.biz) {
case "pushComment":
// 处理评论消息
console.log(appData.data);
break;
case "pushSelected":
// 处理选择消息
console.log(appData.data.selectedVal);
break;
// ... 处理其他消息类型
}
});
```
* 引入 cdn 连接
https://wg.360.cn/wgappsdk.min.js
测试页面：
```html
sdk test
login
获取APP用户信息
open h5
外部浏览器打开 h5 页面
打开商城页面(只对Android有效)
share
close
```