API 参考
应用包
通过 app.capabilities 判断功能支持,通过 app.access 和宿主权限判断访问授权。示例使用合成数据,调用前请替换路径、ID、输入和筛选条件。
类型定义
graphql
type Mutation {
installPackage(path: String!): PackageInstallPending!
uninstallPackages(ids: [ID!]!): Boolean!
}
type Query {
packageCount(query: String!): Int!
packageManifest(id: ID!): String!
packageStatuses(ids: [ID!]!): [PackageStatus!]!
packages(query: String!, offset: Int!, limit: Int!, sortBy: FileSortBy!): [Package!]!
}
type Certificate {
issuer: String!
subject: String!
serialNumber: String!
validFrom: Instant!
validTo: Instant!
}
enum FileSortBy {
UPDATED_AT_ASC
UPDATED_AT_DESC
SIZE_ASC
SIZE_DESC
NAME_ASC
NAME_DESC
}
scalar Instant
scalar Long
type Package {
id: ID!
name: String!
type: PackageType!
version: String!
path: String!
size: Long!
certs: [Certificate!]!
installedAt: Instant!
updatedAt: Instant!
}
type PackageInstallPending {
id: ID!
updatedAt: Instant
isNew: Boolean!
}
type PackageStatus {
id: ID!
exists: Boolean!
updatedAt: Instant
}
enum PackageType {
SYSTEM
USER
}操作
mutation
installPackage
按文件绝对路径安装或更新 APK,返回包名、上次更新时间及是否为首次安装。
graphql
mutation installPackage($path: String!) {
installPackage(path: $path) { id updatedAt isNew }
}mutation
uninstallPackages
为每个包名发起系统卸载请求。true 仅表示已发起,不表示已卸载;用户需在设备上确认。通过 packageStatuses 的 exists 字段确认是否已卸载。
graphql
# Launch system uninstall requests; true means initiated, not uninstalled. Confirm removal with packageStatuses.
mutation uninstallPackages($ids: [ID!]!) {
uninstallPackages(ids: $ids)
}query
packageCount
统计符合查询条件的应用包数。
graphql
query packageCount($query: String!) {
packageCount(query: $query)
}query
packageManifest
读取指定已安装应用包的清单。
graphql
query packageManifest($id: ID!) {
packageManifest(id: $id)
}query
packageStatuses
查询指定包名列表的安装状态和 updatedAt 时间戳。
graphql
query packageStatuses($ids: [ID!]!) {
packageStatuses(ids: $ids) { id exists updatedAt }
}query
packages
搜索已安装的应用包;query 留空时列出全部应用包。
graphql
query packages($query: String!, $offset: Int!, $limit: Int!, $sortBy: FileSortBy!) {
packages(query: $query, offset: $offset, limit: $limit, sortBy: $sortBy) { id name type version path size installedAt updatedAt }
}