当前位置：首页 > article >正文

quickapp_快应用_系统接口应用

article 2024/11/16 20:31:38

系统接口

在项目中使用到的接口都需要在配置文件manifest.json中声明，不然会报如下警告

[WARN] 请在 manifest.json 文件里声明项目代码中用到的接口: system.storage, service.account, system.package, system.webview

[1]检查某app是否在手机上安装

官方文档：官方文档
接口： system.package的hasInstalled方法
作用：检查某app是否在已经在手机上安装

使用

[1] 接口声明- 在配置文件manifest.json中声明

"features": [
  {
    "name": "system.package" 
  },
]

[2] 在需要的地方导入并使用

  import pkg from '@system.package'

pkg.hasInstalled({
  package: 'app包名',
  success: function(data) {
    console.log(`handling success: ${data.result}`)
    // result为true表示app已安装
    // result为false表示app未安装
  },
 fail: function(data, code) {
   console.log(`handling fail, code = ${code}`)
  }
})

[2]下载应用

官方文档：官方文档
接口： system.package的install方法
作用：下载某app

使用

[1] 接口声明- 在配置文件manifest.json中声明

"features": [
  {
    "name": "system.package" 
  },
]

[2] 在需要的地方导入并使用

import pkg from '@system.package'

pkg.install({
 package: '应用包名',
 success: function(data) {
   console.log(`handling success: ${data.result}`)
   // result:true 下载成功
   // result: false 下载失败
 },
 fail: function(data, code) {
   console.log(`handling fail, code = ${code}`)
 }
})

[3] 检查当前是否有桌面应用

官方文档：官方文档
接口： system.shortcut的hasInstalled方法
作用：检查某app当前是否有桌面应用

使用

[1] 接口声明- 在配置文件manifest.json中声明

"features": [
  {
    "name": "system.shortcut" 
  },
]

[2] 在需要的地方导入并使用

import shortcut from '@system.shortcut'

shortcut.hasInstalled({
 success: function(res) {
   // res 为true表示已创建图标
   // res weifalse表示未创建图标
 }
})

[4] 添加桌面应用

官方文档：官方文档
接口： system.shortcut的install方法
作用：为某app添加桌面应用

使用

[1] 接口声明- 在配置文件manifest.json中声明

"features": [
  {
    "name": "system.shortcut" 
  },
]

[2] 在需要的地方导入并使用

import shortcut from '@system.shortcut'

shortcut.install({
  success: function() {
    console.log('handling success') // 创建成功
  },
  fail: function(data, code) {
   // 创建失败,请在设置中开启创建桌面应用权限
   console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  }
})

[5]数据存储

本地数据存储

[6]弹框

官方文档:官方文档
弹出框一共有三种
- toast提示框-showToast
- dialog对话框-showDialog
- 列表框-showContextMenu

[7]接口

官方文档：官方文档

请求封装

import { fetch } from "@system.fetch";
import { getStorage, setStorage } from './storage'
const api = 'xxx' 

const hasToken = async () => {
   const token = await getStorage('token')
   return !!token
}

// 将与后端约定的数据统一添加在请求头中
const getHeaders = async () => {
   const token = await getStorage('token')
   return {
       token,
       ....
   }
}

export const httpGet = async (url, data = {}, header = {}) => {
 await hasToken()
 const headers = await getHeaders()
 return new Promise((resolve, reject) => {
   fetch({
     url: api + url,
     data,
     method: 'GET',
     responseType: 'json',
     header: {
       ...headers,
       ...header
     },
     success(data) {
       resolve(data.data)
     },
     fail(err) {
       reject(err)
     }
   })
 })
}

export const httpPost = async (url, data = {}, header = {}) => {
 await hasToken()
 const headers = await getHeaders()
 return new Promise((resolve, reject) => {
   fetch({
     url: api + url,
     data,
     method: 'POST',
     responseType: 'json',
     header: {
       ...header,
       ...headers
     },
     success(data) {
       if (data.data.status === 1004) {
         router.replace({
           uri: '/pages/Login'
         })
       } else {
         resolve(data.data)
       }
         
     },
     fail(err) {
       reject(err)
     }
   })
 })
}

export default {
 httpGet,
 httpPost
}