App Management

API Declaration

Add the following configuration to the features attribute in the manifest.json file:

{"name": "system.package"}

Module Import

Add the following configuration to the script element on the page where the API will be called:

import pkg from '@system.package'

Or

var pkg = require("@system.package")

Application Scope

Definition

[h2]pkg.hasInstalled(OBJECT)

Description

Checks whether a native or quick app has been installed. A quick app is considered installed only when a home screen icon has been created for it.

OBJECT parameters

Parameters returned by success

Sample code

pkg.hasInstalled({
    package: 'com.hap.app',
    success: function(data) {
        console.log("handling success: " + data.result);
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})

[h2]pkg.install(OBJECT)

Description

Goes to the app details page on AppGallery for the user to install the native app. This API does not check whether the installation is successful.

OBJECT parameters

Parameters returned by success

Sample code

pkg.install({
    package: 'com.hap.app',
    success: function(data) {
        console.log("handling success: " + data.result);
    },
    fail: function(data, code) {
        console.log("handling fail, code=" + code);
    }
})

[h2]pkg.getInfo(OBJECT) (1070+)

Description

Obtains the version numbers and version names of the native app and the quick app.

OBJECT parameters

Parameters returned by success

Result codes returned by fail

Sample code

pkg.getInfo({
     package: 'com.sina.news',
     success: function (data) {
         console.log(`handling success: ${data.versionCode}, ${data.versionName}`)
     },
     fail: function (data, code) {
         console.log(`handling fail, code = ${code}`)
     }
})

[h2]pkg.getSignatureDigests(OBJECT) (1070+)

Description

Obtains the signature digest of the native app and quick app.

OBJECT parameters

Parameters returned by success

Result codes returned by fail

Sample code

pkg.getSignatureDigests({
     package: 'com.sina.news',
     success: function (data) {
         data.signatureDigests.map(function (item) {
             console.log(`handling success: signatureDigests = ${item}`)
         })
     },
     fail: function (data, code) {
         console.log(`handling fail, code = ${code}`)
     }
})

Demo

<template>
  <div class="container">

    <div class="item-container">
      <text>{{hasInstalled}}</text>
      <input type="button" class="btn" onclick="pkgHasInstalled"  value="pkgHasInstalled" />
    </div>

    <div class="item-container">
      <input type="button" class="btn" onclick="pkgInstall"  value="installPkg" />
    </div>
    <div class="item-container">
      <text>{{versionInfo}}</text>
      <input type="button" class="btn" onclick="pkgGetInfo"  value="getPkgInfo" />
    </div>

    <div class="item-container">
      <text>{{signatures}}</text>
      <input type="button" class="btn" onclick="pkgGetSignatureDigests"  value="getPkgSignatureDigests" />
    </div>
  </div>
</template>

<style>
.container{
  flex: 1;
  flex-direction: column;
}
  .item-container {
    margin-top: 50px;
    margin-right: 60px;
    margin-left: 60px;
    flex-direction: column;
  }
  .btn {
  height: 80px;
  text-align: center;
  border-radius: 5px;
  margin-right: 60px;
  margin-left: 60px;
  margin-bottom: 50px;
  color: #ffffff;
  font-size: 30px;
  background-color: #0faeff;
}
</style>

<script>
  import pkg from '@system.package'
  import prompt from '@system.prompt'

  export default {
    data: {
      versionInfo: '',
      signatures: '',
      hasInstalled:''
    },
    onInit: function () {
      this.$page.setTitleBar({ text: 'package' })
    },
    pkgHasInstalled: function () {
      let that = this
      pkg.hasInstalled({
        package: 'com.huawei.appmarket',
        success: function (data) {
          console.log('handling success: ' + data.result);
          that.hasInstalled = data.result;
          prompt.showToast({
            message: 'result---' + data.result
          })
        },
        fail: function (erromsg, errocode) {
          prompt.showToast({ message: "hasInstalled fail" + errocode + ': ' + erromsg })
        },
        complete: function () {
          console.log('complete')
        }
      })
    },
    pkgInstall: function () {
      pkg.install({
        package: 'com.sina.news',
        success: function (data) {
          console.log('handling success: ' + data.result)
          prompt.showToast({
            message: 'success'
          })
        },
        fail: function (data, code) {
          console.log('handling fail, code=' + code)
          prompt.showToast({
            message: 'fail'
          })
        },
        complete: function () {
          console.log('pkg install complete')
        }
      })
    },
    pkgGetInfo: function () {
      var that = this
      pkg.getInfo({
        package: 'com.huawei.appmarket',
        success: function (ret) {
          console.log('getInfo succ data:' + JSON.stringify(ret))
          that.versionInfo = JSON.stringify(ret)
          prompt.showToast({
            message: 'succ! versionCode:' + ret.versionCode + '\n versionName:' + ret.versionName
          })
        },
        fail: function (erromsg, errocode) {
          that.versionInfo = errocode + ': ' + erromsg
          prompt.showToast({ message: "get pkginfo fail" + errocode + ': ' + erromsg })
        },
        complete: function () {
          console.log('complete')
        }
      })
    },
    pkgGetSignatureDigests: function () {
      var that = this
      pkg.getSignatureDigests({
        package: 'com.huawei.appmarket',
        success: function (ret) {
          console.log('getSignatureDigests succ data:' + JSON.stringify(ret))
          that.signatures = JSON.stringify(ret)
          prompt.showToast({
            message: 'succ!' + 'sing:\n' + ret.signatures
          })
        },
        fail: function (erromsg, errocode) {
          that.signatures = errocode + ': ' + erromsg
          prompt.showToast({ message: "GetSignatureDigests fail" + errocode + ': ' + erromsg })
        },
        complete: function () {
          console.log('complete')
        }
      })
    }
  }
</script>

The following figure shows the final effect.

Version Change History